Doppelte Filme, falsch erkannte Titel und defekte Dateien in Emby finden

Wenn du seit ein paar Jahren einen Emby-Server betreibst, kennst du das Gefühl: derselbe Film taucht zweimal auf, ein Poster fehlt, eine Datei, die letzten Monat noch lief, bricht jetzt auf halber Strecke ab, und die Platte ist voll mit Dingen, die niemand schaut. Emby selbst hat für all das keinen Bericht. Library Doctor ist ein Plugin, das diese Probleme findet, zeigt, wie viel Speicherplatz jedes davon kostet, und dich alles aufräumen lässt, ohne je eine Datei zu löschen. Diese Anleitung führt durch die ganze Routine, von doppelten Filmen bis zur umkehrbaren Quarantäne, für Leute, die ihre eigenen Server betreiben.

Voraussetzungen

• Emby Server 4.10.1 oder neuer, unter Linux, Windows oder Docker.
• Für die Dateiprüfung: nichts zu installieren. Das Plugin nutzt das ffprobe und ffmpeg, das mit Emby kommt.
• Für die Quarantäne: Der Emby-Benutzer braucht Schreibzugriff auf die Mediathek-Ordner. Unter Linux ist das meist der Benutzer emby; in Docker dürfen die Medien-Volumes nicht schreibgeschützt eingebunden sein (kein :ro). Ohne Schreibzugriff funktioniert jeder Bericht weiterhin; nur die Quarantäne kann keine Dateien verschieben.
• Einen Lizenzschlüssel, ein aktives Abo, eine Lifetime-Lizenz innerhalb ihres Update-Zeitraums oder die kostenlose 30-Tage-Testversion. Ohne gültige Lizenz ist das Plugin gestoppt: kein Bericht, keine Dateiprüfung, keine Verschiebungen.

Schritt 1 — Installieren und aktivieren

1. Melde dich in deinem MediaLab Works-Konto an, öffne Lizenzen und lade die Plugin-DLL herunter.
2. Kopiere die DLL in den Emby-Plugin-Ordner und starte Emby Server neu:
   • Linux (Paket): /var/lib/emby/plugins/
   • Docker: der Ordner plugins in deinem Emby-Config-Volume
   • Windows: %AppData%\Emby-Server\programdata\plugins\
3. Öffne Library Doctor im Emby-Dashboard-Menü und klicke auf Lizenz. Füge deinen Schlüssel ein und aktiviere ihn, oder gib deine E-Mail-Adresse ein, um die Testversion zu starten. Das Plugin kontaktiert den Lizenzserver, bindet den Schlüssel an diesen Server und zeigt die Lizenz als Aktiv an.

Die Lizenz wird einmal täglich und bei jedem Emby-Start geprüft. Ohne Internet funktioniert das Plugin noch 7 Tage nach der letzten erfolgreichen Prüfung weiter. Auf derselben Seite kannst du ein Update installieren oder auf die vorherige Version zurückrollen; starte Emby danach jeweils neu.

Schritt 2 — Die Zahlen im Kopfbereich lesen

Öffne Library Doctor im Dashboard (nur für Administratoren). Es gibt nichts zu konfigurieren: Die Seite liest deine Film- und Episoden-Mediatheken bei jedem Öffnen neu ein. Oben siehst du Videodateien, Duplikat-Gruppen, den aus Duplikaten zurückzugewinnenden Speicherplatz, nicht zugeordnete Filme und die Gesamtgröße. Nutze das als schnellen Gesundheitswert, bevor du tiefer einsteigst.

Schritt 3 — Duplikate: wissen, was Emby bereits gruppiert

Bevor du Dateien verschiebst, eine wichtige Unterscheidung. Emby gruppiert Dateien eines Films nur dann als Versionen, wenn sie im selben Ordner mit passenden Namen liegen; diese erscheinen bei der Wiedergabe als Versionsauswahl und werden vom Plugin nicht als Duplikate gemeldet. Zwei Dateien desselben Films in verschiedenen Ordnern werden zu zwei getrennten Einträgen, und genau die findet Library Doctor.

• Filme werden über ihre TMDb- oder IMDb-ID abgeglichen.
• Episoden werden über Serie, Staffel und Episodennummer abgeglichen.
• Filme ohne beide IDs werden über Titel (ohne Beachtung von Groß-/Kleinschreibung, Akzenten und Satzzeichen) und Jahr abgeglichen. Diese Gruppen sind mit nach Titel und Jahr (keine Metadaten-ID) — prüfen markiert, denn zwei verschiedene Filme können denselben Titel und dasselbe Jahr haben. Öffne beide, bevor du handelst.

Jede Gruppe zeigt die Versionen nebeneinander — Auflösung, HDR, Codec, Bitrate und Größe — mit der besten zuerst und als beste markiert (zuerst höhere Auflösung, dann HDR, dann ein effizienterer Codec wie AV1, HEVC oder VP9, dann Bitrate), plus den Speicherplatz, den du zurückgewinnst, wenn nur diese eine bleibt. Wenn du auf Emby 4.10 bist und Kopien mit gleicher TMDb-ID automatisch gruppiert wurden, können sie trotzdem als Duplikate erscheinen, bis du sie zusammenführst; das ist eine bekannte Einschränkung, kein Fehler im Bericht.

Schritt 4 — Nicht zugeordnete Filme

Der Abschnitt Nicht zugeordnete Filme listet Filme ganz ohne Metadaten-ID. Das bedeutet meist einen falschen Titel oder ein falsches Jahr, ein fehlendes Poster und einen Film, der nie in Sammlungen oder Empfehlungen auftaucht. Klicke auf Öffnen und wähle dann in Emby über Identifizieren den richtigen Film aus. Beim nächsten Öffnen der Seite verschwindet er aus der Liste.

Schritt 5 — Fehlende, defekte und abgeschnittene Dateien prüfen

Klicke auf Die Dateien prüfen. Die Prüfung läuft im Hintergrund, Datei für Datei, mit Fortschrittsanzeige; bei einer großen Mediathek dauert es eine Weile, und du kannst die Seite verlassen. Für jeden Film und jede Episode prüft das Plugin, ob die Datei existiert, liest sie mit dem ffprobe von Emby (höchstens 30 Sekunden) und dekodiert dann die letzten 3 Sekunden des Videos mit dem ffmpeg von Emby (höchstens 60 Sekunden). Jedes Problem wird mit seiner Ursache aufgeführt:

• fehlt auf dem Datenträger
• kann nicht gelesen werden, mit der Fehlermeldung
• keine Videospur: Das einzige „Video" ist ein Bild, wie bei einer Datei aus zufälligen Bytes
• keine Dauer (defekter Header)
• Dauer null
• das Ende fehlt (unvollständiger Download oder Kopiervorgang): Die letzten Sekunden lassen sich nicht dekodieren

Zwei ehrliche Grenzen: Eine Datei, die sehr kurz vor ihrem Ende abgeschnitten ist (zum Beispiel bei etwa 98 %), kann noch durchgehen, weil ihre letzten Sekunden dekodierbare Frames enthalten, und Schäden mitten in einer Datei werden nicht gesucht. Eine abgeschnittene .ts lässt sich nicht erkennen, weil sie keine Dauer speichert. Ergebnisse bleiben im Speicher, bis Emby neu startet. Die Prüfung läuft nur auf Anforderung; es gibt keine geplanten Scans.

Schritt 6 — Der Speicherbericht

Der Abschnitt Speicherplatz zeigt die Gesamtsumme, dann den Speicherplatz nach Mediathek, nach Auflösung (4K, 1080p, 720p, SD) und nach Video-Codec, plus die 20 größten Dateien, die kein Benutzer angeschaut hat. Es ist die nützlichste Seite vor einem Platten-Upgrade: Sie sagt dir, ob dein Problem ein paar riesige 4K-Remuxes sind oder ein langer Schwanz aus 720p-Dateien, die niemand öffnet.

Schritt 7 — Quarantäne statt Löschen

Wenn du bei einer schwächeren Version auf Quarantäne klickst (und bestätigst), verschiebt das Plugin die Videodatei und die Dateien daneben, die ihren Namen teilen — Untertitel, .nfo, Bilder wie Movie.srt, Movie.en.srt, Movie.nfo und Movie-poster.jpg — in einen Ordner namens .medialab-de-sters im Stamm des Mediathek-Ordners, der sie enthält, und behält ihre Unterordner bei. Weil der Ordner im selben Mediathek-Ordner liegt, ist er normalerweise auf derselben Platte, und das Verschieben geht sofort. Emby scannt die Mediathek danach neu.

Das Verschieben wird festgehalten, bevor eine Datei angefasst wird. Lässt sich eine Datei nicht verschieben (zum Beispiel wegen Berechtigungen), werden die bereits verschobenen Dateien zurückgelegt, und es bleibt keine Kopie zurück; ist auch das Zurücklegen nicht möglich, bleibt der Eintrag in der Liste Quarantäne, damit du ihn wiederherstellen kannst. Die Liste zeigt jeden verschobenen Titel mit seinem ursprünglichen Ort und seiner Größe. Wiederherstellen legt die Dateien genau dorthin zurück, wo sie waren, und scannt neu; es verweigert den Vorgang, ohne etwas anzufassen, wenn eine Datei sowohl in der Quarantäne als auch wieder an ihrem ursprünglichen Pfad liegt. Dateien außerhalb der Mediathek-Ordner und Dateien, die bereits in .medialab-de-sters liegen, werden abgelehnt.

Das Plugin überschreibt oder löscht nie eine Datei. Wenn du sicher bist, löschst du den Ordner .medialab-de-sters selbst vom Datenträger; erst dann wird der Speicherplatz frei. Die Liste liegt im Datenordner des Plugins und übersteht einen Emby-Neustart — benenne den Quarantäne-Ordner nicht um und verschiebe ihn nicht, solange noch etwas darin wiederhergestellt werden muss.

Tipps und Fehlerbehebung

• Die Quarantäne meldet „Es konnte nicht durchgeführt werden": Die Meldung danach nennt den Grund. Meist hat Emby keinen Schreibzugriff auf den Mediathek-Ordner. Prüfe unter Linux Besitzer und Berechtigungen und stelle sicher, dass Docker-Volumes nicht mit :ro eingebunden sind.
• Wiederherstellen meldet „Es konnte nicht durchgeführt werden": Eine Datei liegt bereits am ursprünglichen Pfad, zum Beispiel weil du den Film erneut hinzugefügt hast. Das Wiederherstellen verweigert den Vorgang, statt zu überschreiben.
• Eine Datei aus der Quarantäne erscheint in Emby mit ihrem neuen Pfad: Emby hat den Quarantäne-Ordner gescannt. Das Plugin wird eine solche Datei nicht erneut in die Quarantäne verschieben; stelle sie wieder her oder lösche den Ordner, sobald du sicher bist.
• Keine Online-Abfragen: Duplikate und nicht zugeordnete Titel werden aus den IDs berechnet, die dein Server bereits speichert. Der einzige externe Kontakt ist der Lizenz-Client. Nach einem Quarantäne-Vorgang oder Wiederherstellen startet das Plugin den regulären Mediathek-Scan, der die auf deinem Server konfigurierten Metadaten-Anbieter kontaktieren kann.
• Nur Emby Web für die Admin-Seite. Die Arbeit passiert auf dem Server, daher sehen Apps und TVs nur das Ergebnis.

Fazit

Mediathek-Hygiene ist kein einmaliges Aufräumen, sondern eine Routine. Öffne die Seite, wirf einen Blick auf die Zahlen, arbeite Duplikate und nicht zugeordnete Titel durch, lass die Dateiprüfung nach großen Importen laufen und nutze den Speicherbericht, bevor du eine weitere Platte kaufst. Weil die Quarantäne Dateien nur innerhalb des Mediathek-Ordners verschiebt und sie mit einem Klick zurückbringt, kannst du entschlossen handeln, ohne Angst zu haben. Die vollständige Anleitung steht in der Bedienungsanleitung, die Versionshistorie im Changelog, und die Produktseite ist unter Library Doctor. Wenn sich etwas seltsam verhält, sind die Wissensdatenbank und die FAQ der nächste Anlaufpunkt, und du kannst uns jederzeit kontaktieren.