Guía definitiva para limpiar tu servidor Plex o Jellyfin con Reclaimerr

Aprende a instalar y configurar Reclaimerr para eliminar duplicados y archivos innecesarios en tu servidor Plex o Jellyfin. Incluye ejemplos prácticos, reglas avanzadas y consejos para evitar errores comunes.

¿Por qué necesitas Reclaimerr en tu servidor de media?

Si tienes un servidor Plex, Jellyfin o Emby, es probable que, con el tiempo, tu biblioteca se haya convertido en un caos organizado. Archivos duplicados, nombres inconsistentes, subtítulos sueltos y carpetas huérfanas son solo algunos de los problemas comunes que enfrentan los usuarios.

Reclaimerr es una herramienta de código abierto diseñada para automatizar la limpieza de tu biblioteca. A diferencia de otras soluciones, como Maintainerr, que dependen del ecosistema *arr (Sonarr, Radarr, etc.), Reclaimerr funciona de manera independiente, conectándose directamente a la API de tu servidor de media.

Ventajas clave:

• Autonomía: No requiere gestores de descargas como Sonarr o Radarr.
• Compatibilidad: Funciona con Plex, Jellyfin y Emby.
• Reglas personalizables: Define qué archivos eliminar según criterios como resolución, tasa de bits o frecuencia de reproducción.
• Modo seguro: Escanea y registra duplicados sin eliminarlos hasta que lo confirmes.

Requisitos previos

Antes de instalar Reclaimerr, asegúrate de tener:

• Un servidor Plex, Jellyfin o Emby en funcionamiento.
• Acceso a la API de tu servidor (necesitarás una API key para Plex).
• Docker (recomendado) o un sistema compatible con contenedores.
• Permisos de escritura en las carpetas donde están almacenados tus archivos de media.

Guía paso a paso: Instalación de Reclaimerr con Docker

1. Configuración inicial

Si usas Docker, la instalación es sencilla. Sigue estos pasos:

2. Crea un archivo docker-compose.yml

Copia el siguiente código en un archivo llamado 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"

Explicación de los parámetros:

• image: Usa la imagen oficial de Reclaimerr desde GitHub.
• container_name: Nombre del contenedor (puedes personalizarlo).
• restart: Reinicia el contenedor automáticamente si falla.
• env_file: Archivo donde se guardarán las variables de entorno (ej. API key).
• volumes: Monta la carpeta ./data en el contenedor para guardar configuraciones y registros.
• ports: Expone el puerto 8000 para acceder a la interfaz web de Reclaimerr.

3. Configura las variables de entorno

Crea un archivo llamado .env en la misma carpeta que docker-compose.yml y añade lo siguiente:

UID=1000
GID=1000

Nota: Reemplaza 1000 con el UID y GID de tu usuario en el sistema. Puedes obtenerlos ejecutando el comando id -u (para UID) y id -g (para GID) en la terminal.

4. Inicia el contenedor

Ejecuta el siguiente comando en la terminal:

docker-compose up -d

Esto descargará la imagen de Reclaimerr y creará el contenedor en segundo plano.

5. Accede a la interfaz web

Abre tu navegador y ve a:

http://[IP_DE_TU_SERVIDOR]:8000

Deberías ver el panel de control de Reclaimerr.

Configuración de Reclaimerr

1. Conecta tu servidor de media

En la interfaz web de Reclaimerr:

1. Ve a Settings (Configuración).
2. Selecciona tu servidor (Plex, Jellyfin o Emby).
3. Ingresa la URL de tu servidor (ej. http://192.168.1.100:32400 para Plex).
4. Proporciona tu API key (para Plex, puedes generarla en Settings > Web en tu servidor Plex).
5. Guarda los cambios.

2. Configura las rutas de tus bibliotecas

En Settings > Paths:

1. Añade las rutas de las carpetas donde están almacenados tus archivos de media.
2. Asegúrate de que Reclaimerr tenga permisos de lectura y escritura en estas carpetas.

Reglas avanzadas para limpieza automática

Reclaimerr permite definir reglas personalizadas para eliminar archivos. Aquí te mostramos algunos ejemplos prácticos:

1. Eliminar duplicados basados en calidad

Si tienes múltiples versiones de la misma película (ej. un REMUX 1080p y un rip 4K comprimido), puedes configurar Reclaimerr para que conserve la versión de mayor calidad.

Ejemplo de regla:

• Prioridad 1: Archivos con HDR y resolución 4K.
• Prioridad 2: Archivos con resolución 4K (sin HDR).
• Prioridad 3: Archivos con resolución 1080p y alta tasa de bits.

Cómo configurarlo:

1. Ve a Rules (Reglas) en la interfaz web.
2. Selecciona Add Rule (Añadir regla).
3. Define los criterios de calidad (resolución, tasa de bits, HDR).
4. Guarda la regla.

2. Eliminar archivos no reproducidos

Si quieres eliminar contenido que no has visto en mucho tiempo, puedes crear una regla basada en el historial de reproducción.

Ejemplo de regla:

• Eliminar películas o series que no se hayan reproducido en los últimos 2 años.
• Eliminar episodios de series que no se hayan visto en los últimos 6 meses.

Cómo configurarlo:

1. Ve a Rules.
2. Selecciona Watch History (Historial de reproducción).
3. Define el período de inactividad (ej. 2 años).
4. Guarda la regla.

3. Eliminar archivos pequeños (samples)

Los archivos sample (muestras) suelen descargarse accidentalmente y ocupan espacio innecesario. Puedes configurar Reclaimerr para eliminarlos automáticamente.

Ejemplo de regla:

• Eliminar archivos de video con un tamaño menor a 100MB.

Cómo configurarlo:

1. Ve a Rules.
2. Selecciona File Size (Tamaño de archivo).
3. Define el tamaño mínimo (ej. 100MB).
4. Guarda la regla.

Modo seguro: Dry-run

Reclaimerr tiene un modo de prueba (dry-run) activado por defecto. Esto significa que, al ejecutar un escaneo, la herramienta no eliminará ningún archivo, sino que solo registrará los duplicados o archivos que cumplen con las reglas definidas.

Pasos recomendados:

1. Ejecuta un escaneo en modo dry-run.
2. Revisa los resultados en la pestaña Logs (Registros).
3. Verifica que las reglas estén funcionando como esperas.
4. Si todo se ve correcto, desactiva el modo dry-run en la configuración y ejecuta el escaneo nuevamente para eliminar los archivos.

¡Advertencia! Nunca desactives el modo dry-run sin antes revisar los resultados. Un error en las reglas podría llevar a la eliminación accidental de archivos importantes.

Ejemplo práctico: Limpieza de una biblioteca de películas

Imagina que tienes una biblioteca de películas con los siguientes problemas:

• Duplicados de la misma película en diferentes calidades (ej. 1080p y 4K).
• Archivos sample descargados accidentalmente.
• Películas que no has visto en más de 2 años.

Solución con Reclaimerr:

1. Configura las rutas: Añade la carpeta donde están tus películas (ej. /media/movies).
2. Crea reglas:
   • Regla 1: Eliminar duplicados, priorizando archivos 4K HDR > 4K > 1080p.
   • Regla 2: Eliminar archivos menores a 100MB.
   • Regla 3: Eliminar películas no reproducidas en los últimos 2 años.
3. Ejecuta el escaneo en modo dry-run: Revisa los resultados para asegurarte de que solo se eliminen los archivos correctos.
4. Desactiva dry-run y ejecuta el escaneo: Una vez confirmado, Reclaimerr eliminará los archivos según las reglas.

Casos límite y cómo manejarlos

Aunque Reclaimerr es una herramienta poderosa, hay situaciones donde puede necesitar intervención manual:

1. Archivos con nombres similares pero contenido diferente

Si tienes dos archivos con nombres similares pero que son versiones diferentes de una película (ej. Movie (2020).mkv y Movie (2020) Directors Cut.mkv), Reclaimerr podría marcarlos como duplicados.

Solución: Excluye manualmente estos archivos de las reglas de limpieza o ajusta los criterios para que no se consideren duplicados.

2. Archivos con metadatos incorrectos

Si los metadatos de tus archivos (ej. resolución o tasa de bits) están mal configurados, Reclaimerr podría tomar decisiones incorrectas.

Solución: Usa herramientas como MediaInfo o Tiny Media Manager para corregir los metadatos antes de ejecutar Reclaimerr.

3. Archivos en carpetas protegidas

Si algunos archivos están en carpetas con permisos restringidos, Reclaimerr no podrá eliminarlos.

Solución: Asegúrate de que el contenedor de Docker tenga permisos de escritura en todas las carpetas de media.

Alternativas a Reclaimerr

Si Reclaimerr no cumple con tus necesidades, aquí tienes algunas alternativas:

1. Maintainerr

Ventajas:

• Integración con el ecosistema *arr (Sonarr, Radarr, etc.).
• Automatización avanzada de descargas y limpieza.

Desventajas:

• Requiere configuración compleja.
• Soporte limitado para Jellyfin.

2. Tiny Media Manager

Ventajas:

• Organización y limpieza manual de bibliotecas.
• Edición de metadatos.

Desventajas:

• No es automático.
• Requiere intervención manual.

3. FileBot

Ventajas:

• Renombrado y organización automática de archivos.
• Soporte para múltiples servidores de media.

Desventajas:

• No elimina duplicados automáticamente.

Consejos para mantener tu biblioteca limpia

Además de usar Reclaimerr, sigue estos consejos para mantener tu biblioteca organizada:

• Nombra tus archivos correctamente: Usa un esquema consistente (ej. Película (Año) [Calidad].mkv).
• Organiza por carpetas: Agrupa películas por género, año o colección.
• Revisa periódicamente: Ejecuta Reclaimerr cada pocos meses para detectar nuevos duplicados.
• Usa herramientas de automatización: Combina Reclaimerr con Sonarr o Radarr para gestionar descargas y limpieza.

Conclusión: ¿Vale la pena Reclaimerr?

Reclaimerr es una herramienta imprescindible para cualquier usuario de Plex, Jellyfin o Emby que quiera mantener su biblioteca limpia y organizada sin esfuerzo manual. Su capacidad para eliminar duplicados y archivos innecesarios de manera autónoma, combinada con reglas personalizables y un modo seguro, la convierte en una opción sólida.

Lo cierto es que, en un mundo donde el almacenamiento puede llenarse rápidamente, herramientas como Reclaimerr son un salvavidas. Si valoras tu tiempo y tu espacio en disco, esta herramienta merece una oportunidad.