Reclaimerr: Recupera espacio en disco de tu biblioteca de medios Jellyfin, Plex, Emby, etc

Reclaimerr | Gestión de medios | Docker

Reclaimerr: Recupera espacio en disco de tu biblioteca de medios

Gestiona automáticamente tu biblioteca multimedia eliminando contenido no visto o de baja puntuación.

¿Qué es Reclaimerr?


Reclaimerr es una herramienta diseñada para ayudarte a recuperar espacio en disco de tu biblioteca de medios. Nació de la necesidad real de su desarrollador, que se enfrentó a un servidor doméstico con 100TB de almacenamiento casi lleno y el creciente coste de los nuevos discos duros.

La aplicación se integra con Jellyfin y/o Plex para analizar tu contenido y gestionar automáticamente qué medios pueden ser eliminados según reglas personalizables. Funciona de forma similar a Overseerr o Jellyseerr, pero a la inversa: en lugar de añadir contenido, Reclaimerr te ayuda a limpiarlo de forma eficiente.

Ventaja clave: Reclaimerr no depende de Sonarr ni Radarr para funcionar. Puede trabajar directamente con Plex y Jellyfin, aunque si los tienes configurados, puede usarlos para gestionar las eliminaciones de forma más limpia.

Historia y motivación

El desarrollador exploró numerosas aplicaciones de código abierto para la limpieza de servidores, y Maintainerr destacó como la principal inspiración para el diseño de Reclaimerr. Sin embargo, cuando comenzó el desarrollo, Maintainerr no soportaba Jellyfin, y aunque posteriormente añadió soporte en su versión 3.0.0, aún no cumplía completamente con todos los requisitos necesarios.

La necesidad específica era gestionar una única biblioteca física de medios mientras se utilizaban tanto Jellyfin como Plex para ejecutar filtros y reglas. Además, se buscaba una solución que no dependiera obligatoriamente de Sonarr y Radarr.

Impulsado por el creciente coste del almacenamiento y la necesidad de recuperar espacio en disco usado, e inspirado por Maintainerr, Reclaimerr nació.

Características principales

Reglas personalizables

Configura reglas automáticas para recuperar espacio en disco según tus criterios específicos.

Soporte Jellyfin y Plex

Compatible con ambos servidores multimedia. Designa uno como principal y el otro como suplementario.

Tareas programables

Configuración basada en cron o tiempo para escaneos automáticos de medios elegibles para eliminación.

Sistema de protección

Protege contenido específico de la eliminación. Los usuarios pueden solicitar protección con duración temporal configurable.

Multi-usuario con permisos

Sistema completo de usuarios y permisos para controlar quién puede eliminar o proteger contenido.

Notificaciones con Apprise

Soporte para más de 133 servicios de notificación a través de Apprise.

Integración Sonarr/Radarr

Elimina o deja de monitorear medios desde Radarr y Sonarr si están configurados.

Gestión de solicitudes

Elimina solicitudes de Overseerr/Jellyseerr automáticamente cuando se borra el contenido.

Ligero y eficiente

Evita activar discos innecesariamente. Todos los datos se obtienen directamente de tus servidores multimedia.

UI responsive

Interfaz moderna con modo claro y oscuro. Funciona perfectamente en dispositivos móviles.

Información importante sobre el estado beta

Nota de seguridad: Mientras Reclaimerr está en beta temprana, la tarea de eliminación automática de medios NO estará habilitada ni visible en la interfaz. El desarrollador no quiere arriesgar la eliminación permanente del contenido de nadie debido a un bug hasta que todo haya sido probado exhaustivamente.
  • Por ahora, solo los administradores o usuarios con permisos apropiados pueden gestionar eliminaciones a través de la UI o API
  • Una vez que se añadan las eliminaciones automáticas, será un sistema opt-in (necesitarás activarlo manualmente)
  • Durante la beta, las cosas están sujetas a cambios en respuesta a feedback de usuarios y pruebas
  • La documentación completa se creará a medida que la aplicación madure

Instalación

Reclaimerr puede instalarse de tres formas diferentes según tus necesidades:

Desktop

Puedes usar la última versión desde la página de releases para tu plataforma si hay una compilación disponible.

Nota: Las compilaciones de escritorio solo soportan Windows 8 o superior.

Descargar releases

Docker (recomendado)

La forma más sencilla y portable de ejecutar Reclaimerr en cualquier servidor Linux.

Imagen disponible en: ghcr.io/jessielw/reclaimerr:latest

Desde el código fuente

Para desarrolladores o usuarios avanzados que quieran ejecutar la última versión en desarrollo.

Requisitos: Python 3.11+, Node.js 20+, uv

Instalación con Docker Compose

Crea un archivo .env con la siguiente configuración:

# directorio para almacenar datos de la aplicación DATA_DIR=./data # configuración de la API API_HOST=0.0.0.0 API_PORT=8000 CORS_ORIGINS=http://localhost:3000 # secretos - dejar en blanco para auto-generar valores estables # en el primer arranque (recomendado), o establecer los tuyos propios # (mínimo 32 caracteres, ej: `openssl rand -hex 32`) # JWT_SECRET= # ENCRYPTION_KEY= # logging (opciones: DEBUG, INFO, WARNING, ERROR, CRITICAL) # LOG_LEVEL=INFO # establecer a true cuando se sirva sobre HTTPS # COOKIE_SECURE=false

Crea el archivo docker-compose.yml:

services: reclaimerr: image: ghcr.io/jessielw/reclaimerr:latest container_name: reclaimerr restart: unless-stopped env_file: ".env" volumes: - ./data:/app/data ports: - "8000:8000"

Inicia el contenedor:

docker compose up -d

Accede a la aplicación en: http://tu-ip-servidor:8000

Instalación desde el código fuente

# 1. Clonar el repositorio git clone https://github.com/jessielw/Reclaimerr.git cd Reclaimerr # 2. Instalar dependencias de Python uv sync # 3. Crear y configurar el archivo .env cp .env.example .env # 4. Iniciar el backend uv run uvicorn backend.api.main:app # 5. En otra terminal, iniciar el frontend cd frontend npm install npm run dev

Backend disponible en: http://localhost:8000

Frontend disponible en: http://localhost:3000

Primeros pasos

Una vez instalado Reclaimerr, sigue estos pasos para comenzar:

  1. Accede a la interfaz web y crea tu cuenta de administrador
  2. Ve a Settings → Servers y configura la conexión con Plex y/o Jellyfin
  3. Designa uno de los servidores como el servidor principal
  4. Opcionalmente, configura Sonarr y Radarr si los usas
  5. Configura notificaciones en Settings → Notifications usando Apprise
  6. Crea reglas personalizadas en Settings → Rules para definir qué contenido es candidato a eliminación
  7. Configura tareas programadas en Settings → Tasks
  8. Revisa los candidatos a eliminación en Reclaim Candidates
  9. Gestiona manualmente las eliminaciones hasta que el sistema de auto-eliminación esté disponible
Consejo: Empieza con reglas conservadoras y ajústalas gradualmente según tus necesidades. Es mejor ser cauteloso al principio que eliminar contenido valioso por accidente.

Capturas de pantalla

Dashboard de Reclaimerr
Vista de películas
Candidatos a eliminación
Configuración de servidores

Transparencia sobre el uso de IA

El desarrollador de Reclaimerr ha sido transparente sobre el uso de herramientas de IA en el desarrollo. Reclaimerr fue construido desde cero y no fue generado usando LLMs ni es un fork de ningún otro proyecto.

Los LLMs solo se han utilizado como herramienta para tareas específicas como:

  • Búsqueda de información
  • Automatización de trabajo repetitivo
  • Depuración de código
  • Asistencia ocasional con CSS/UI
  • Correcciones menores de gramática

Todo el diseño y código han sido escritos a mano, asegurando que el desarrollador tiene un profundo entendimiento de cómo funcionan todos los engranajes del proyecto.

Política de contribuciones: Este proyecto rechazará pull requests que parezcan ser mayormente o totalmente generadas por IA.

Comentarios

Entradas populares de este blog

NAS SYNOLOGY DSM 7.1 en VMware ESXI - Guía instalación y configuración Synology DSM 7.1 en VMWARE

Comando "NET USE", uso, parámetros y algunos ejemplos de uso

Multisesión RDP en Windows 10 Pro