Library Doctor para Emby

Emby no tiene ningún informe para los problemas que se acumulan en una biblioteca: la misma película añadida dos veces como dos títulos separados, películas que nunca identificó, archivos que desaparecieron, se dañaron o solo se copiaron a medias. Library Doctor los encuentra, muestra lo que cada uno cuesta en espacio de disco y te permite quitarlos de en medio sin borrar nunca un archivo.

Qué hace

• Duplicados: la misma película o el mismo episodio (misma serie, temporada y número de episodio) en elementos separados. Las películas se emparejan por su identificador de TMDb o IMDb; las películas sin ninguno de los dos se emparejan por su título (sin distinguir mayúsculas, acentos ni puntuación) y año, y esos grupos se marcan como by title and year — check (por título y año — comprobar), porque dos películas distintas pueden compartir título y año. Cada grupo muestra las versiones una al lado de otra —resolución, HDR, códec, tasa de bits y tamaño—, con la mejor en primer lugar y el espacio que recuperarías si conservaras solo esa. Quarantine (cuarentena) aparta una versión peor.
• Las versiones que Emby ya agrupa no se tocan: los archivos que Emby ya muestra como versiones de un mismo título (el mismo título con una elección de versión al reproducir) no se señalan como duplicados; solo los elementos separados.
• Películas sin identificar: películas sin ningún identificador de metadatos, lo que suele significar un título, un año o un póster equivocados y una película ausente de las colecciones y las recomendaciones. Cada una enlaza a la película, donde el Identify de Emby lo corrige.
• Archivos ausentes, dañados o truncados: una comprobación en segundo plano de cada archivo de película y de episodio con el ffprobe y el ffmpeg que vienen con Emby. Señala los archivos que faltan en el disco, no se pueden leer (con el error), no tienen una pista de vídeo real (solo una imagen, por ejemplo un archivo de bytes aleatorios en el que ffprobe cree ver una imagen), no tienen duración (una cabecera dañada), tienen duración cero o están truncados: se decodifican los últimos 3 segundos del vídeo, y un archivo cuyo final no se puede decodificar se señala como una descarga o copia incompleta.
• Informe de espacio: el total y luego el espacio por biblioteca, por resolución (4K, 1080p, 720p, SD) y por códec de vídeo, y los 20 archivos más grandes que ningún usuario ha visto.
• Cuarentena en lugar de borrado: ver más abajo. El plugin nunca borra nada.
• En inglés y en rumano.

La cuarentena: no se borra nada

Cuando haces clic en Quarantine en una versión (y confirmas), el plugin mueve el archivo de vídeo y los archivos junto a él que comparten su nombre —subtítulos, .nfo, imágenes como Movie.srt, Movie.en.srt, Movie.nfo, Movie-poster.jpg— a una carpeta llamada .medialab-de-sters («para borrar» en rumano) en la raíz de la carpeta de biblioteca que los contiene, conservando sus subcarpetas. Como la carpeta está dentro de la misma carpeta de biblioteca, normalmente está en el mismo disco y el traslado es instantáneo. Después, Emby vuelve a examinar la biblioteca.

El traslado se registra antes de tocar ningún archivo. Si un archivo no se puede mover (por ejemplo, por los permisos), los archivos ya movidos se devuelven a su sitio y no queda ninguna copia en .medialab-de-sters; si tampoco es posible devolverlos, la entrada se queda en la lista de cuarentena para que puedas restaurarla.

La lista Quarantine muestra cada título movido con su ubicación original y su tamaño. Restore devuelve los archivos exactamente adonde estaban y vuelve a examinar la biblioteca; se niega, sin tocar nada, si un archivo está a la vez en cuarentena y de vuelta en su ruta original. El plugin nunca sobrescribe ni borra un archivo: cuando estés seguro, borras tú mismo la carpeta .medialab-de-sters del disco.

Se rechazan los archivos que están fuera de las carpetas de biblioteca y los que ya están en una carpeta .medialab-de-sters.

Requisitos

• Emby Server 4.10.1 o posterior (Linux, Windows o Docker).
• Para la comprobación de archivos: el ffprobe y el ffmpeg que vienen con Emby (nada que instalar).
• Para la cuarentena: el usuario de Emby necesita permiso de escritura en las carpetas de biblioteca (para crear .medialab-de-sters en la raíz de la carpeta de biblioteca y mover archivos fuera de sus carpetas). En Docker, los volúmenes multimedia no deben montarse como de solo lectura. Sin permiso de escritura, todos los informes funcionan; solo la cuarentena no puede mover archivos.

Preguntas frecuentes

¿Puede borrar mis películas? No. El plugin no tiene ninguna función de borrado. La cuarentena solo mueve archivos dentro de la misma carpeta de biblioteca, y vuelven con Restore.

¿Por qué aparece dos veces la misma película en Emby? Emby agrupa los archivos de una película como versiones solo cuando están en la misma carpeta con nombres que coinciden. Dos archivos de la misma película en carpetas distintas se convierten en dos elementos. Library Doctor los encuentra por su identificador de TMDb o IMDb (o por título y año cuando no tienen identificador) y te permite poner en cuarentena el peor. Consulta la guía.

¿Puede encontrar todos los archivos dañados? Encuentra los archivos que faltan, que no se pueden leer, sin una pista de vídeo real o sin duración, y los archivos cuyo final no se puede decodificar. Un archivo cortado muy cerca del final (por ejemplo, hacia el 98 %) todavía puede tener fotogramas decodificables en sus últimos segundos y superar la comprobación, y los daños en mitad de un archivo no se buscan.

Qué envía y adónde

• Ningún contacto externo aparte del cliente de licencias. Sin consultas de metadatos en línea: los duplicados y los títulos sin identificar se calculan a partir de los identificadores (TMDb/IMDb…) que el servidor ya guarda.
• Indirectamente: después de un traslado a cuarentena o de una restauración, el plugin inicia el examen habitual de la biblioteca, que puede contactar con los proveedores de metadatos configurados en el servidor (comportamiento del servidor, no del plugin).
• La comprobación de archivos (solo bajo demanda) ejecuta el ffprobe del servidor en cada película/episodio, localmente. Sin exámenes programados.
• Además, el cliente de licencias, el mismo en todos los plugins: consulta Licencias y privacidad en nuestros plugins.

Guardado localmente:

• La cuarentena no borra nada: el archivo y sus acompañantes (subtítulos, nfo, imágenes) se mueven a <library root>/.medialab-de-sters/; el borrado definitivo depende de ti.
• state/quarantine.json: título, fecha, rutas original y de cuarentena, tamaño.
• Los resultados de la comprobación de archivos se guardan solo en memoria. El plugin lee de la biblioteca si algún usuario ha visto un título (para «los más grandes sin ver»), sin guardarlo.

Compatibilidad con clientes

• Solo la página de administración: Emby Web ✅. Las funciones se ejecutan en el servidor, así que los clientes (apps, televisores) solo ven el efecto (títulos movidos/agrupados).
• Pruebas: de extremo a extremo a nivel de API (16/16), comprobación del final del archivo en 400/400 archivos reales sin ningún falso positivo; la versión 0.1.2 para Emby funciona en un servidor de producción.
• Limitaciones: el servidor necesita permiso de escritura en las carpetas de biblioteca para la cuarentena; en Emby 4.10, las copias con el mismo TMDb agrupadas automáticamente siguen apareciendo como duplicados hasta que las fusionas; un .ts truncado no se puede detectar (no tiene duración guardada).

Leyenda: ✅ verificado (prueba de extremo a extremo o en el dispositivo) · 🟢 en el servidor, funciona con cualquier cliente (por diseño, sin prueba específica para cada cliente) · ➖ no aplicable · ❔ no probado.

Licencia

Una licencia por servidor Emby. Mensual, anual o de por vida, o incluido en el paquete para Emby. 30 días de prueba gratis. El plugin se ofrece bajo nuestro EULA.

Library Doctor es código propio, escrito por MediaLab Works; no contiene código de terceros.