Library Doctor für Emby — Anleitung

Installation

Du brauchst Emby Server 4.10.1 oder neuer.

1. Melde dich in deinem MediaLab-Works-Konto an, öffne Licenses und lade die Plugin-DLL herunter (verfügbar bei einem aktiven Abonnement, einer Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder während des kostenlosen 30-tägigen Tests).
2. Kopiere die DLL in den Emby-Plugins-Ordner und starte den Emby-Server neu:
   • Linux (Paket): /var/lib/emby/plugins/
   • Docker: der Ordner plugins in deinem Emby-Konfigurations-Volume
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Öffne Library Doctor im Emby-Dashboard-Menü und klicke auf License. Füge deinen Lizenzschlüssel ein und aktiviere ihn, oder gib deine E-Mail-Adresse ein, um den kostenlosen 30-tägigen Test zu starten oder eine Lizenz zu kaufen. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Emby-Server und zeigt die Lizenz als Active an.

Die Lizenz wird einmal am Tag (und bei jedem Emby-Start) geprüft. Ohne Internet funktioniert das Plugin noch 7 Tage nach der letzten erfolgreichen Prüfung; danach ist es gestoppt, bis es wieder prüfen kann.

Lizenz

Ohne gültige Lizenz ist das Plugin gestoppt: Es wird kein Bericht angezeigt, keine Dateiprüfung ausgeführt und nichts kann verschoben oder wiederhergestellt werden; nur die License-Seite funktioniert weiter (dort kannst du den Test starten, kaufen, den Schlüssel eingeben oder aktualisieren). Es wird nichts gelöscht: Die Dateien in der Quarantäne bleiben, wo sie sind, und können wiederhergestellt werden, sobald die Lizenz wieder gültig ist.

Mit gültiger Lizenz kann dieselbe Seite ein Update installieren oder bei Problemen ein Rollback auf die vorherige Version ausführen. Starte Emby nach beidem neu.

Konfiguration

Öffne Library Doctor im Emby-Dashboard-Menü (nur Administratoren). Es gibt nichts einzurichten: Die Seite liest deine Film- und Episodenbibliotheken bei jedem Öffnen.

Gib Emby vor der Nutzung der Quarantäne Schreibzugriff auf die Bibliotheksordner. Die Quarantäne erstellt einen Ordner .medialab-de-sters (rumänisch für „zu löschen“) im Stamm jedes Bibliotheksordners und verschiebt Dateien aus ihren Ordnern; der Benutzer, als der Emby läuft (unter Linux meist emby), braucht deshalb Schreibrechte auf die Bibliotheksordner und die Ordner darin. Unter Docker mounte die Media-Volumes lesbar-schreibbar (ohne :ro). Alles andere im Plugin liest nur.

Der tägliche Gebrauch

1. Die Zahlen oben: Videodateien, Duplikat-Gruppen, der durch Duplikate freizugebende Platz, Filme ohne Metadaten und die Gesamtgröße.

2. Duplicates: Jede Gruppe zeigt die Versionen, die beste zuerst und mit best markiert (zuerst höhere Auflösung, dann HDR, dann ein effizienterer Codec – AV1, HEVC, VP9 – dann Bitrate).

   • Filme werden anhand ihrer TMDb- oder IMDb-ID verglichen, Episoden anhand von Serie, Staffel und Episodennummer.
   • Filme ohne TMDb- oder IMDb-ID werden anhand von Titel und Jahr verglichen. Ihre Gruppen sind mit by title and year (no metadata id) — check markiert: Öffne beide und stelle sicher, dass es wirklich derselbe Film ist, bevor du eines quarantänierst (ein Remake kann denselben Titel und manchmal dasselbe Jahr haben).
   • Dateien, die Emby bereits als Versionen eines Titels anzeigt, zählen als ein Element und werden nicht als Duplikate gemeldet.
   • Quarantine bei einer schwächeren Version fragt nach Bestätigung und verschiebt diese Datei und ihre Begleitdateien in die Quarantäne (siehe unten).

3. Unmatched movies: Filme ohne Metadaten-ID. Klicke auf Open und nutze dann Identify in Emby, um den richtigen Film auszuwählen; er verschwindet bei der nächsten Öffnung der Seite aus der Liste.

4. Fehlende, defekte oder abgeschnittene Dateien: Klicke auf Check the files. Die Prüfung läuft im Hintergrund, Datei für Datei, und zeigt ihren Fortschritt; bei einer großen Bibliothek dauert sie eine Weile, und du kannst die Seite verlassen. Für jede Datei prüft sie, dass die Datei existiert, liest sie mit Embys ffprobe (höchstens 30 Sekunden) und decodiert dann die letzten 3 Sekunden des Videos mit Embys ffmpeg (höchstens 60 Sekunden). Jedes Problem wird mit seiner Ursache gelistet:

   • missing from disk (fehlt auf der Festplatte);
   • cannot be read, mit dem Fehler (nicht lesbar);
   • no video track: das einzige „Video“ ist ein Bild (Cover-Art zählt nicht als Video), wie in einer Datei aus zufälligen Bytes;
   • no duration (broken header) (keine Laufzeit, defekter Header);
   • zero duration (Laufzeit null);
   • the end is missing (incomplete download/copy): Die letzten Sekunden können nicht decodiert werden. Eine Datei, die sehr nah am Ende abgeschnitten wurde (zum Beispiel bei etwa 98 %), kann noch bestehen, weil ihre letzten Sekunden noch decodierbare Bilder enthalten können.

   Das Ergebnis bleibt bis zu einem Neustart von Emby erhalten.

5. Space: der Platz nach Bibliothek, nach Auflösung und nach Codec sowie die 20 größten Dateien, die kein Benutzer gesehen hat.

Die Quarantäne

• Was verschoben wird: die Videodatei und die Dateien im selben Ordner, deren Name mit demselben Namen beginnt, gefolgt von . oder - — zum Beispiel Movie (2010).mkv mit Movie (2010).en.srt, Movie (2010).nfo und Movie (2010)-poster.jpg. Andere Dateien im Ordner bleiben, wo sie sind.
• Wohin: in .medialab-de-sters im Stamm des Bibliotheksordners, der die Datei enthält, mit denselben Unterordnern (/media/movies/Movie (2010)/Movie (2010).mkv wird zu /media/movies/.medialab-de-sters/Movie (2010)/Movie (2010).mkv). Wenn in der Quarantäne bereits eine Datei desselben Namens liegt, kommt die neue in einen Unterordner mit eindeutigem Namen, sodass nichts überschrieben wird.
• Wenn ein Verschieben halb scheitert (zum Beispiel eine Begleitdatei nicht verschoben werden kann): Die bereits verschobenen Dateien werden zurückgelegt, und eine durch einen zwischen Festplatten unterbrochenen Verschiebevorgang in .medialab-de-sters zurückgelassene Kopie wird entfernt, sodass du nie dieselbe Datei an zwei Orten hast. Wenn die Dateien auch nicht zurückgelegt werden können, bleibt der Eintrag in der Liste Quarantine, und Restore holt das Verschobene zurück. Die Seite zeigt den Fehler an.
• Nach dem Verschieben startet das Plugin einen Bibliotheks-Neuabgleich, sodass die quarantänierte Version aus Emby verschwindet (Emby scannt den versteckten Ordner .medialab-de-sters nicht, der im Bibliotheksordner bleibt). Falls Emby die Datei jemals mit ihrem neuen Pfad innerhalb von .medialab-de-sters listet, hat Emby den Quarantäne-Ordner gescannt: Das Plugin quarantäniert eine solche Datei nicht erneut; stelle sie wieder her, oder lösche den Ordner von der Festplatte, wenn du sicher bist.
• Restore: Die Liste Quarantine zeigt jeden Titel mit seinen ursprünglichen Pfaden und der Größe. Restore verschiebt die Dateien genau dorthin zurück, wo sie waren, und scannt die Bibliothek neu. Wenn eine Datei sowohl in Quarantäne als auch am ursprünglichen Pfad liegt (zum Beispiel, weil du den Film erneut hinzugefügt hast), wird die Wiederherstellung abgelehnt und nichts angerührt.
• Das endgültige Löschen liegt bei dir: Das Plugin löscht nie. Wenn du sicher bist, lösche den Ordner .medialab-de-sters (oder die Dateien darin) von der Festplatte; erst dann wird Platz frei.
• Die Liste der quarantänierten Dateien liegt im Datenordner des Plugins, sodass sie einen Emby-Neustart überlebt. Benenne den Ordner .medialab-de-sters nicht um und verschiebe ihn nicht, während etwas darin noch wiederhergestellt werden könnte.

Fehlerbehebung

• Quarantine zeigt „It could not be done“: Die Meldung danach nennt den Grund. Meist hat Emby keinen Schreibzugriff auf den Bibliotheksordner; siehe Konfiguration. Dateien außerhalb der Ordner deiner Emby-Bibliotheken und Dateien, die bereits in .medialab-de-sters liegen, werden ebenfalls abgelehnt.
• Restore zeigt „It could not be done“: Eine Datei liegt bereits am ursprünglichen Pfad (zum Beispiel, weil du den Film erneut hinzugefügt hast). Verschiebe oder lösche diese Datei und stelle ihn dann wieder her.
• Eine als „by title and year — check“ markierte Gruppe enthält zwei verschiedene Filme: Quarantäniere nichts; identifiziere beide Filme in Emby, und sobald sie ihre TMDb- oder IMDb-IDs haben, werden sie nicht mehr gruppiert.
• Ein Film ist zweimal in der Bibliothek, wird aber nicht unter Duplikaten gelistet: Die beiden Einträge haben verschiedene IDs, oder einer hat eine ID und der andere keine (dann identifiziere ihn), oder Emby zeigt sie bereits als Versionen eines Titels an.
• Eine Datei, die nicht abspielt, wird nicht gemeldet: Der Schaden kann in der Mitte der Datei liegen, die nicht geprüft wird, oder die Datei wurde sehr nah am Ende abgeschnitten.