Encontrar películas duplicadas, títulos sin identificar y archivos dañados en Emby

Si llevas unos años con un servidor Emby, conoces la sensación: la misma película aparece dos veces, falta un póster, un archivo que el mes pasado se reproducía bien ahora se corta a mitad y el disco está lleno de cosas que nadie ve. Emby no tiene ningún informe para nada de esto. Library Doctor es un plugin que encuentra estos problemas, muestra cuánto ocupa cada uno en disco y te permite despejarlos sin borrar nunca un archivo. Este tutorial recorre toda la rutina, desde las películas duplicadas hasta una cuarentena reversible, para quienes gestionan sus propios servidores.

Requisitos previos

• Emby Server 4.10.1 o posterior, en Linux, Windows o Docker.
• Para la comprobación de archivos: nada que instalar. El plugin usa el ffprobe y el ffmpeg que vienen con Emby.
• Para la cuarentena: el usuario de Emby necesita permiso de escritura en las carpetas de la biblioteca. En Linux normalmente es el usuario emby; en Docker los volúmenes de medios no deben montarse en solo lectura (sin :ro). Sin permiso de escritura todos los informes siguen funcionando; solo la cuarentena no puede mover archivos.
• Una clave de licencia, una suscripción activa, una licencia de por vida dentro de su ventana de actualizaciones o la prueba gratuita de 30 días. Sin una licencia válida el plugin está detenido: sin informe, sin comprobación de archivos, sin movimientos.

Paso 1 — Instalar y activar

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga el DLL del plugin.
2. Copia el DLL en la carpeta de plugins de Emby y reinicia Emby Server:
   • Linux (paquete): /var/lib/emby/plugins/
   • Docker: la carpeta plugins dentro de tu volumen de configuración de Emby
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Abre Library Doctor en el menú del panel de Emby y haz clic en License. Pega tu clave y actívala, o introduce tu correo electrónico para iniciar la prueba. El plugin contacta con el servidor de licencias, vincula la clave a este servidor y muestra la licencia como Active.

La licencia se comprueba una vez al día y en cada arranque de Emby. Sin internet el plugin sigue funcionando 7 días después de la última comprobación correcta. Desde esa misma página puedes instalar una actualización o volver a la versión anterior; reinicia Emby después de cualquiera de las dos.

Paso 2 — Leer los números de la cabecera

Abre Library Doctor en el panel (solo administradores). No hay nada que configurar: la página lee tus bibliotecas de películas y episodios cada vez que se abre. Arriba verás los archivos de vídeo, los grupos de duplicados, el espacio que puedes recuperar de los duplicados, las películas sin identificar y el tamaño total. Úsalo como una puntuación rápida de salud antes de ponerte a fondo.

Paso 3 — Duplicados: conoce lo que Emby ya agrupa

Antes de empezar a mover archivos, una distinción importante. Emby agrupa los archivos de una película como versiones solo cuando están en la misma carpeta con nombres coincidentes; esos aparecen como una elección de versión al reproducir y el plugin no los informa como duplicados. Dos archivos de la misma película en carpetas distintas se convierten en dos elementos separados, y eso es lo que encuentra Library Doctor.

• Las películas se emparejan por su id de TMDb o IMDb.
• Los episodios se emparejan por serie, temporada y número de episodio.
• Las películas que no tienen ninguno de los dos id se emparejan por título (ignorando mayúsculas, acentos y puntuación) y año. Esos grupos se marcan como by title and year (no metadata id) — check, porque dos películas distintas pueden compartir título y año. Abre ambas antes de actuar.

Cada grupo muestra las versiones una al lado de otra —resolución, HDR, códec, tasa de bits y tamaño— con la mejor primero y marcada como best (primero la resolución más alta, luego HDR, luego un códec más eficiente como AV1, HEVC o VP9, luego la tasa de bits), además del espacio que recuperarías quedándote solo con esa. Si estás en Emby 4.10 y las copias con el mismo TMDb se agruparon automáticamente, pueden seguir apareciendo como duplicados hasta que las fusiones; es una limitación conocida, no un fallo del informe.

Paso 4 — Películas sin identificar

La sección Unmatched movies lista las películas sin ningún id de metadatos. Normalmente eso significa un título o un año equivocados, un póster que falta y una película que nunca aparece en colecciones ni recomendaciones. Haz clic en Open y luego usa Identify en Emby para elegir la película correcta. Desaparecerá de la lista la próxima vez que abras la página.

Paso 5 — Comprobar archivos que faltan, dañados y truncados

Haz clic en Check the files. La comprobación se ejecuta en segundo plano, archivo por archivo, con un indicador de progreso; en una biblioteca grande tarda un rato y puedes salir de la página. Para cada película y episodio el plugin comprueba que el archivo existe, lo lee con el ffprobe de Emby (como máximo 30 segundos) y luego decodifica los últimos 3 segundos del vídeo con el ffmpeg de Emby (como máximo 60 segundos). Cada problema se lista con su causa:

• missing from disk
• cannot be read, con el error
• no video track: el único "vídeo" es una imagen, como en un archivo de bytes aleatorios
• no duration (broken header)
• zero duration
• the end is missing (incomplete download or copy): los últimos segundos no se pueden decodificar

Dos límites honestos: un archivo cortado muy cerca de su final (por ejemplo, en torno al 98 %) puede pasar igualmente porque sus últimos segundos contienen fotogramas decodificables, y no se buscan daños en medio de un archivo. Un .ts truncado no se puede detectar porque no almacena duración. Los resultados se guardan en memoria hasta que Emby se reinicia. La comprobación se ejecuta solo bajo demanda; no hay escaneos programados.

Paso 6 — El informe de espacio

La sección Space muestra el total y luego el espacio por biblioteca, por resolución (4K, 1080p, 720p, SD) y por códec de vídeo, además de los 20 archivos más grandes que ningún usuario ha visto. Es la página más útil antes de ampliar disco: te dice si tu problema son unos pocos remuxes 4K enormes o una larga cola de archivos 720p que nadie abre.

Paso 7 — Cuarentena en lugar de borrar

Cuando haces clic en Quarantine sobre una versión más floja (y confirmas), el plugin mueve el archivo de vídeo y los archivos que están a su lado y comparten su nombre —subtítulos, .nfo, imágenes como Movie.srt, Movie.en.srt, Movie.nfo y Movie-poster.jpg— a una carpeta llamada .medialab-de-sters en la raíz de la carpeta de biblioteca que los contiene, manteniendo sus subcarpetas. Como la carpeta está dentro de la misma carpeta de biblioteca, normalmente está en el mismo disco y el movimiento es instantáneo. Emby vuelve a escanear la biblioteca.

El movimiento se registra antes de tocar ningún archivo. Si un archivo no se puede mover (por ejemplo, por permisos), los archivos ya movidos se devuelven y no queda ninguna copia suelta; si tampoco es posible devolverlos, la entrada permanece en la lista Quarantine para que puedas restaurarla. La lista muestra cada título movido con su ubicación original y su tamaño. Restore devuelve los archivos exactamente a donde estaban y vuelve a escanear; se niega, sin tocar nada, si un archivo está a la vez en cuarentena y de vuelta en su ruta original. Se rechazan los archivos fuera de las carpetas de biblioteca y los que ya están en .medialab-de-sters.

El plugin nunca sobrescribe ni borra un archivo. Cuando estés seguro, borras tú mismo la carpeta .medialab-de-sters del disco; el espacio se libera solo entonces. La lista se guarda en la carpeta de datos del plugin, así que sobrevive a un reinicio de Emby: no cambies el nombre ni muevas la carpeta de cuarentena mientras algo de dentro pueda necesitar restauración.

Consejos y solución de problemas

• La cuarentena dice "It could not be done": el mensaje que sigue da el motivo. Normalmente Emby no tiene permiso de escritura en la carpeta de biblioteca. Revisa propietario y permisos en Linux y asegúrate de que los volúmenes de Docker no están montados con :ro.
• Restore dice "It could not be done": ya hay un archivo en la ruta original, por ejemplo porque volviste a añadir la película. La restauración se niega en lugar de sobrescribir.
• Un archivo en cuarentena aparece en Emby con su nueva ruta: Emby ha escaneado la carpeta de cuarentena. El plugin no volverá a poner en cuarentena un archivo así; restáuralo o borra la carpeta cuando estés seguro.
• Sin consultas en línea: los duplicados y los títulos sin identificar se calculan a partir de los id que tu servidor ya almacena. El único contacto externo es el cliente de licencias. Tras mover o restaurar una cuarentena, el plugin inicia el escaneo habitual de la biblioteca, que puede contactar con los proveedores de metadatos configurados en tu servidor.
• Solo Emby Web para la página de administración. El trabajo ocurre en el servidor, así que las apps y las TVs solo ven el efecto.

Conclusión

La higiene de la biblioteca no es una limpieza puntual; es una rutina. Abre la página, echa un vistazo a los números, repasa duplicados y títulos sin identificar, ejecuta la comprobación de archivos tras las importaciones grandes y usa el informe de espacio antes de comprar otro disco. Como la cuarentena solo mueve archivos dentro de la carpeta de biblioteca y los devuelve con un clic, puedes ser decidido sin miedo. El recorrido completo está en la guía de usuario, el historial de versiones en el changelog y la página del producto en Library Doctor. Si algo se comporta de forma extraña, la base de conocimiento y las preguntas frecuentes son el siguiente paso, y siempre puedes contactarnos.