Library Doctor pour Emby — guide

Installation

Vous avez besoin d’Emby Server 4.10.1 ou plus récent.

Connectez-vous à votre compte MediaLab Works, ouvrez Licenses et téléchargez la DLL du plugin (disponible avec un abonnement actif, une licence à vie dans sa période de mises à jour, ou pendant l’essai gratuit de 30 jours).
Copiez la DLL dans le dossier des plugins Emby et redémarrez Emby Server :
- Linux (paquet) : /var/lib/emby/plugins/
- Docker : le dossier plugins à l’intérieur de votre volume de configuration Emby
- Windows : %AppData%\Emby-Server\programdata\plugins\
Ouvrez Library Doctor dans le menu du tableau de bord Emby et cliquez sur License. Collez votre clé de licence et activez-la, ou saisissez votre e-mail pour démarrer l’essai gratuit de 30 jours ou acheter une licence. Le plugin contacte le serveur de licences, lie la clé à ce serveur Emby et affiche la licence comme Active.

La licence est vérifiée une fois par jour (et à chaque démarrage d’Emby). Sans internet, le plugin continue de fonctionner pendant 7 jours après la dernière vérification réussie ; après cela, il est arrêté jusqu’à ce qu’il puisse à nouveau vérifier.

Licence

Sans licence valide, le plugin est arrêté : aucun rapport n’est affiché, aucune vérification de fichiers ne s’exécute et rien ne peut être déplacé ou restauré ; seule la page License continue de fonctionner (vous pouvez y démarrer l’essai, acheter, saisir la clé ou mettre à jour). Rien n’est supprimé : les fichiers en quarantaine restent où ils sont et peuvent être restaurés dès que la licence redevient valide.

Avec une licence valide, la même page peut installer une mise à jour ou revenir à la version précédente si une mise à jour pose problème. Redémarrez Emby après l’une ou l’autre.

Configuration

Ouvrez Library Doctor dans le menu du tableau de bord Emby (administrateurs seulement). Il n’y a rien à configurer : la page lit vos bibliothèques de films et d’épisodes à chaque ouverture.

Avant d’utiliser la quarantaine, donnez à Emby l’accès en écriture aux dossiers des bibliothèques. La quarantaine crée un dossier .medialab-de-sters (« à supprimer » en roumain) à la racine de chaque dossier de bibliothèque et sort les fichiers de leurs dossiers : l’utilisateur sous lequel tourne Emby (sur Linux, généralement emby) a donc besoin de la permission d’écriture sur les dossiers des bibliothèques et les dossiers qu’ils contiennent. Dans Docker, montez les volumes de médias en lecture-écriture (sans :ro). Tout le reste du plugin ne fait que lire.

Utilisation quotidienne

Les chiffres en haut : fichiers vidéo, groupes de doublons, l’espace à récupérer sur les doublons, films non identifiés et taille totale.
Doublons : chaque groupe affiche les versions, la meilleure d’abord et marquée best (d’abord la résolution la plus haute, puis le HDR, puis un codec plus efficace — AV1, HEVC, VP9 — puis le débit).
- Les films sont comparés par leur identifiant TMDb ou IMDb, les épisodes par série, saison et numéro d’épisode.
- Les films sans identifiant TMDb ou IMDb sont comparés par titre et année. Leurs groupes sont marqués by title and year (no metadata id) — check : ouvrez les deux et assurez-vous qu’il s’agit vraiment du même film avant de mettre l’un en quarantaine (un remake peut avoir le même titre, et parfois la même année).
- Les fichiers qu’Emby affiche déjà comme versions d’un même titre comptent pour un seul élément et ne sont pas signalés comme doublons.
- Quarantine, sur une version plus faible, demande confirmation et déplace ce fichier et ses compagnons en quarantaine (voir ci-dessous).
Films non identifiés : les films sans aucun identifiant de métadonnées. Cliquez sur Open, puis utilisez Identify dans Emby pour choisir le bon film ; il disparaît de la liste à la prochaine ouverture de la page.
Fichiers manquants, cassés ou tronqués : cliquez sur Check the files. La vérification s’exécute en arrière-plan, fichier par fichier, et affiche sa progression ; sur une grande bibliothèque, elle prend un moment et vous pouvez quitter la page. Pour chaque fichier, elle vérifie que le fichier existe, le lit avec le ffprobe d’Emby (au plus 30 secondes), puis décode les 3 dernières secondes de la vidéo avec le ffmpeg d’Emby (au plus 60 secondes). Chaque problème est listé avec sa cause :
- missing from disk (absent du disque) ;
- cannot be read (illisible), avec l’erreur ;
- no video track (aucune piste vidéo) : la seule « vidéo » est une image (une jaquette ne compte pas comme de la vidéo), comme dans un fichier d’octets aléatoires ;
- no duration (broken header) (aucune durée, en-tête cassé) ;
- zero duration (durée zéro) ;
- the end is missing (incomplete download/copy) (fin manquante, téléchargement ou copie incomplet) : les dernières secondes ne peuvent pas être décodées. Un fichier coupé très près de sa fin (par exemple à environ 98 %) peut quand même passer, car ses dernières secondes peuvent encore contenir des images décodables.
Le résultat est conservé jusqu’au redémarrage d’Emby.
Espace : l’espace par bibliothèque, par résolution et par codec, et les 20 plus gros fichiers qu’aucun utilisateur n’a regardés.

La quarantaine

Ce qui est déplacé : le fichier vidéo et les fichiers du même dossier dont le nom commence par le même nom suivi de . ou - — par exemple Movie (2010).mkv avec Movie (2010).en.srt, Movie (2010).nfo et Movie (2010)-poster.jpg. Les autres fichiers du dossier restent où ils sont.
Où : dans .medialab-de-sters à la racine du dossier de bibliothèque qui contient le fichier, avec les mêmes sous-dossiers (/media/movies/Movie (2010)/Movie (2010).mkv va dans /media/movies/.medialab-de-sters/Movie (2010)/Movie (2010).mkv). Si un fichier du même nom est déjà en quarantaine, le nouveau part dans un sous-dossier au nom unique, rien n’est donc écrasé.
Si un déplacement échoue en cours de route (par exemple si un fichier compagnon ne peut pas être déplacé) : les fichiers déjà déplacés sont remis en place, et une copie laissée dans .medialab-de-sters par un déplacement interrompu entre disques est supprimée, vous ne vous retrouvez donc jamais avec le même fichier à deux endroits. Si les fichiers ne peuvent pas non plus être remis en place, l’entrée reste dans la liste Quarantine et Restore ramène ce qui a été déplacé. La page affiche l’erreur.
Après le déplacement, le plugin lance une nouvelle analyse de la bibliothèque, la version mise en quarantaine disparaît donc d’Emby (Emby n’analyse pas le dossier caché .medialab-de-sters, qui reste à l’intérieur du dossier de la bibliothèque). Si Emby liste un jour le fichier avec son nouveau chemin à l’intérieur de .medialab-de-sters, Emby a analysé le dossier de quarantaine : le plugin ne remet pas un tel fichier en quarantaine ; restaurez-le, ou supprimez le dossier du disque une fois sûr.
Restore : la liste Quarantine affiche chaque titre avec ses chemins d’origine et sa taille. Restore replace les fichiers exactement là où ils étaient et relance l’analyse de la bibliothèque. Si un fichier est à la fois en quarantaine et à son chemin d’origine (par exemple vous avez ajouté à nouveau le film), la restauration est refusée et rien n’est touché.
La suppression finale vous appartient : le plugin ne supprime jamais. Quand vous êtes sûr, supprimez le dossier .medialab-de-sters (ou les fichiers qu’il contient) du disque ; l’espace n’est libéré qu’à ce moment-là.
La liste des fichiers en quarantaine est conservée dans le dossier de données du plugin, elle survit donc à un redémarrage d’Emby. Ne renommez ni ne déplacez le dossier .medialab-de-sters tant que son contenu peut encore avoir besoin d’être restauré.

Dépannage

La quarantaine affiche « It could not be done » : le message qui suit donne la raison. Généralement, Emby n’a pas l’accès en écriture au dossier de la bibliothèque ; voir Configuration. Les fichiers hors des dossiers de vos bibliothèques Emby, et les fichiers déjà dans .medialab-de-sters, sont aussi refusés.
Restore affiche « It could not be done » : un fichier est déjà au chemin d’origine (par exemple vous avez ajouté à nouveau le film). Déplacez ou supprimez ce fichier, puis restaurez.
Un groupe marqué « by title and year — check » contient deux films différents : ne mettez rien en quarantaine ; identifiez les deux films dans Emby, et une fois leurs identifiants TMDb ou IMDb obtenus, ils ne sont plus groupés.
Un film est présent deux fois dans la bibliothèque mais n’est pas listé parmi les doublons : les deux éléments ont des identifiants différents, ou l’un en a un et pas l’autre (identifiez-le alors), ou Emby les affiche déjà comme versions d’un même titre.
Un fichier qui ne se lit pas n’est pas signalé : les dégâts peuvent se situer au milieu du fichier, ce qui n’est pas vérifié, ou le fichier a été coupé très près de sa fin.