Library Doctor for Emby — guía

Instalación

Necesitas Emby Server 4.10.1 o posterior.

1. Inicia sesión en tu cuenta de MediaLab Works, abre Licenses y descarga el DLL del plugin (disponible con una suscripción activa, una licencia de por vida dentro de su período de actualizaciones, o durante la prueba gratuita de 30 días).
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 control de Emby y haz clic en License. Pega tu clave de licencia y actívala, o introduce tu dirección de correo para empezar la prueba gratuita de 30 días o comprar una licencia. El plugin contacta con el servidor de licencias, vincula la clave a este servidor de Emby 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 exitosa; después se detiene hasta poder comprobar de nuevo.

Licencia

Sin una licencia válida, el plugin está detenido: no se muestra ningún informe, no se ejecuta ninguna comprobación de archivos y nada se puede mover ni restaurar; solo la página License sigue funcionando (ahí puedes empezar la prueba, comprar, introducir la clave o actualizar). No se borra nada: los archivos en cuarentena se quedan donde están y se pueden restaurar en cuanto la licencia vuelva a ser válida.

Con una licencia válida, la misma página puede instalar una actualización o volver a la versión anterior si una actualización causa problemas. Reinicia Emby después de cualquiera de las dos.

Configuración

Abre Library Doctor en el menú del panel de control de Emby (solo administradores). No hay nada que configurar: la página lee tus bibliotecas de películas y episodios cada vez que se abre.

Antes de usar la cuarentena, dale a Emby acceso de escritura a las carpetas de biblioteca. La cuarentena crea una carpeta .medialab-de-sters («para borrar» en rumano) en la raíz de cada carpeta de biblioteca y saca los archivos de sus carpetas, así que el usuario con el que se ejecuta Emby (en Linux, normalmente emby) necesita permiso de escritura en las carpetas de biblioteca y en las carpetas que contienen. En Docker, monta los volúmenes de medios en lectura-escritura (sin :ro). Todo lo demás del plugin solo lee.

Uso diario

1. Los números de arriba: archivos de vídeo, grupos de duplicados, el espacio que se puede recuperar de los duplicados, las películas sin identificar y el tamaño total.

2. Duplicados: cada grupo muestra las versiones, la mejor primera y marcada como best (primero mayor resolución, después HDR, después un códec más eficiente — AV1, HEVC, VP9 — y después la tasa de bits).

   • Las películas se comparan por su identificador de TMDb o IMDb, y los episodios por serie, temporada y número de episodio.
   • Las películas sin identificador de TMDb o IMDb se comparan por título y año. Sus grupos se marcan como by title and year (no metadata id) — check: abre ambas y asegúrate de que realmente son la misma película antes de poner una en cuarentena (un remake puede tener el mismo título y, a veces, el mismo año).
   • Los archivos que Emby ya muestra como versiones de un mismo título cuentan como un elemento y no se reportan como duplicados.
   • Quarantine, sobre una versión inferior, pide confirmación y mueve ese archivo y sus archivos acompañantes a la cuarentena (ver más abajo).

3. Películas sin identificar: películas sin identificador de metadatos. Haz clic en Open y usa después Identify en Emby para elegir la película correcta; desaparece de la lista la próxima vez que abras la página.

4. Archivos que faltan, dañados o truncados: haz clic en Check the files. La comprobación se ejecuta en segundo plano, archivo por archivo, y muestra su progreso; en una biblioteca grande tarda un rato y puedes salir de la página. Para cada archivo comprueba que existe, lo lee con el ffprobe de Emby (como máximo 30 segundos) y después decodifica los últimos 3 segundos del vídeo con el ffmpeg de Emby (como máximo 60 segundos). Cada problema se enumera con su causa:

   • missing from disk (no está en el disco);
   • cannot be read (no se puede leer), con el error;
   • no video track (sin pista de vídeo): el único «vídeo» es una imagen (las carátulas no cuentan como vídeo), como en un archivo de bytes aleatorios;
   • no duration (broken header) (sin duración; cabecera rota);
   • zero duration (duración cero);
   • the end is missing (incomplete download/copy) (falta el final; descarga o copia incompleta): no se pueden decodificar los últimos segundos. Un archivo cortado muy cerca de su final (por ejemplo, alrededor del 98%) puede pasar la comprobación, porque sus últimos segundos aún pueden contener fotogramas decodificables.

   El resultado se conserva hasta que Emby se reinicia.

5. Espacio: el espacio por biblioteca, por resolución y por códec, y los 20 archivos más grandes que ningún usuario ha visto.

La cuarentena

• Qué se mueve: el archivo de vídeo y los archivos de la misma carpeta cuyo nombre empieza con el mismo nombre seguido de . o - — por ejemplo, Movie (2010).mkv con Movie (2010).en.srt, Movie (2010).nfo y Movie (2010)-poster.jpg. Los demás archivos de la carpeta se quedan donde están.
• Dónde: a .medialab-de-sters en la raíz de la carpeta de biblioteca que contiene el archivo, conservando las mismas subcarpetas (/media/movies/Movie (2010)/Movie (2010).mkv pasa a /media/movies/.medialab-de-sters/Movie (2010)/Movie (2010).mkv). Si ya hay en cuarentena un archivo con el mismo nombre, el nuevo va a una subcarpeta con un nombre único, así que nada se sobrescribe.
• Si un traslado falla a mitad (por ejemplo, no se puede mover un archivo acompañante): los archivos ya movidos se devuelven a su sitio y se elimina la copia dejada en .medialab-de-sters por un traslado interrumpido entre discos, así que nunca acabas con el mismo archivo en dos sitios. Si tampoco se pueden devolver los archivos, la entrada se queda en la lista Quarantine y Restore trae de vuelta lo que se movió. La página muestra el error.
• Tras el traslado, el plugin inicia un reescaneado de la biblioteca, así que la versión en cuarentena desaparece de Emby (Emby no examina la carpeta oculta .medialab-de-sters, que se queda dentro de la carpeta de biblioteca). Si Emby llega a listar el archivo con su nueva ruta dentro de .medialab-de-sters, es que Emby ha examinado la carpeta de cuarentena: el plugin no vuelve a poner en cuarentena ese archivo; restáuralo, o borra la carpeta del disco cuando estés seguro.
• Restore: la lista Quarantine muestra cada título con sus rutas originales y su tamaño. Restore devuelve los archivos exactamente a donde estaban y reexamina la biblioteca. Si un archivo está a la vez en cuarentena y en su ruta original (por ejemplo, añadiste de nuevo la película), la restauración se rechaza y no se toca nada.
• El borrado definitivo es cosa tuya: el plugin nunca borra. Cuando estés seguro, borra del disco la carpeta .medialab-de-sters (o los archivos que contiene); solo entonces se libera el espacio.
• La lista de archivos en cuarentena se guarda en la carpeta de datos del plugin, así que sobrevive a un reinicio de Emby. No renombres ni muevas la carpeta .medialab-de-sters mientras algo de su interior aún pueda necesitar restauración.

Resolución de problemas

• Quarantine muestra «It could not be done»: el mensaje que va detrás da el motivo. Normalmente, Emby no tiene acceso de escritura a la carpeta de biblioteca; consulta Configuración. Los archivos fuera de las carpetas de tus bibliotecas de Emby, y los archivos ya en .medialab-de-sters, también se rechazan.
• Restore muestra «It could not be done»: ya hay un archivo en la ruta original (por ejemplo, añadiste de nuevo la película). Mueve o borra ese archivo y restaura después.
• Un grupo marcado como «by title and year — check» contiene dos películas distintas: no pongas nada en cuarentena; identifica ambas películas en Emby y, en cuanto tengan sus identificadores de TMDb o IMDb, dejan de agruparse.
• Una película está dos veces en la biblioteca pero no aparece entre los duplicados: los dos elementos tienen identificadores distintos, o uno tiene identificador y el otro no (entonces identifícala), o Emby ya los muestra como versiones de un mismo título.
• Un archivo que no se reproduce no se reporta: el daño puede estar en medio del archivo, que no se comprueba, o el archivo se cortó muy cerca de su final.