Library Doctor für Emby

Emby hat keinen Bericht für die Probleme, die sich in einer Mediathek ansammeln: derselbe Film zweimal als zwei getrennte Titel hinzugefügt, Filme, die nie zugeordnet wurden, Dateien, die verschwunden, beschädigt oder nur halb kopiert sind. Library Doctor findet sie, zeigt, was jedes Problem an Speicherplatz kostet, und lässt dich aufräumen, ohne je eine Datei zu löschen.

Was es macht

• Duplikate: derselbe Film oder dieselbe Episode (gleiche Serie, Staffel und Episodennummer) in getrennten Einträgen. Filme werden über ihre TMDb- oder IMDb-ID zugeordnet; Filme ohne eine dieser IDs über ihren Titel (ohne Rücksicht auf Groß-/Kleinschreibung, Akzente und Satzzeichen) und das Jahr, und diese Gruppen werden als nach Titel und Jahr – prüfen markiert, weil zwei verschiedene Filme denselben Titel und dasselbe Jahr haben können. Jede Gruppe zeigt die Versionen nebeneinander – Auflösung, HDR, Codec, Bitrate und Größe –, die beste zuerst, und den Platz, den du zurückgewinnst, wenn du nur diese behältst. Quarantäne schafft eine schwächere Version aus dem Weg.
• Versionen, die Emby schon gruppiert, bleiben unberührt: Dateien, die Emby bereits als Versionen eines Titels anzeigt (derselbe Titel mit Versionsauswahl bei der Wiedergabe), werden nicht als Duplikate gemeldet; nur getrennte Einträge.
• Nicht zugeordnete Filme: Filme ganz ohne Metadaten-ID, was meist einen falschen Titel, ein falsches Jahr oder Poster bedeutet und einen Film, der in Sammlungen und Empfehlungen fehlt. Jeder verlinkt auf den Film, wo Embys Identifizieren das behebt.
• Fehlende, defekte oder abgeschnittene Dateien: eine Prüfung im Hintergrund für jede Film- und Episodendatei mit dem ffprobe und ffmpeg, die mit Emby kommen. Sie meldet Dateien, die auf der Festplatte fehlen, nicht gelesen werden können (mit der Fehlermeldung), keine echte Videospur haben (nur ein Bild, zum Beispiel eine Datei aus Zufallsbytes, in der ffprobe ein Bild vermutet), keine Dauer haben (ein defekter Header), eine Dauer von null haben oder abgeschnitten sind: Die letzten 3 Sekunden des Videos werden decodiert, und eine Datei, deren Ende sich nicht decodieren lässt, wird als unvollständiger Download oder unvollständige Kopie gemeldet.
• Speicherplatzbericht: die Gesamtsumme, dann der Platz nach Mediathek, nach Auflösung (4K, 1080p, 720p, SD) und nach Video-Codec sowie die 20 größten Dateien, die noch kein Benutzer angesehen hat.
• Quarantäne statt Löschen: siehe unten. Das Plugin löscht nie etwas.
• Auf Englisch und Rumänisch.

Die Quarantäne: Nichts wird gelöscht

Wenn du bei einer 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, Movie-poster.jpg – in einen Ordner namens .medialab-de-sters (rumänisch für „zum Löschen“) im Stamm des Mediathek-Ordners, in dem sie liegen, unter Beibehaltung ihrer Unterordner. Weil der Ordner im selben Mediathek-Ordner liegt, ist er normalerweise auf derselben Festplatte, und das Verschieben geht sofort. Danach durchsucht Emby die Mediathek neu.

Das Verschieben wird aufgezeichnet, bevor eine Datei angerührt wird. Lässt sich eine Datei nicht verschieben (zum Beispiel wegen Berechtigungen), werden die bereits verschobenen Dateien zurückgelegt, und in .medialab-de-sters bleibt keine Kopie zurück; ist auch das Zurücklegen nicht möglich, bleibt der Eintrag in der Quarantäneliste, damit du ihn wiederherstellen kannst.

Die Liste Quarantäne zeigt jeden verschobenen Titel mit seinem ursprünglichen Speicherort und seiner Größe. Wiederherstellen verschiebt die Dateien genau dorthin zurück, wo sie waren, und durchsucht neu; es verweigert den Vorgang, ohne etwas anzurühren, wenn eine Datei sowohl in der Quarantäne als auch wieder an ihrem ursprünglichen Pfad liegt. Das Plugin überschreibt oder löscht nie eine Datei: Wenn du sicher bist, löschst du den Ordner .medialab-de-sters selbst von der Festplatte.

Dateien außerhalb der Mediathek-Ordner und Dateien, die schon in einem Ordner .medialab-de-sters liegen, werden abgelehnt.

Voraussetzungen

• Emby Server 4.10.1 oder neuer (Linux, Windows oder Docker).
• Für die Dateiprüfung: das ffprobe und ffmpeg, die mit Emby kommen (nichts zu installieren).
• Für die Quarantäne: Der Emby-Benutzer braucht Schreibzugriff auf die Mediathek-Ordner (um .medialab-de-sters im Stamm des Mediathek-Ordners anzulegen und Dateien aus ihren Ordnern zu verschieben). Unter Docker dürfen die Medien-Volumes nicht schreibgeschützt eingebunden sein. Ohne Schreibzugriff funktionieren alle Berichte; nur die Quarantäne kann keine Dateien verschieben.

Häufige Fragen

Kann es meine Filme löschen? Nein. Im Plugin gibt es keine Löschfunktion. Die Quarantäne verschiebt Dateien nur innerhalb desselben Mediathek-Ordners, und mit Wiederherstellen kommen sie zurück.

Warum wird derselbe Film in Emby zweimal aufgeführt? Emby gruppiert die Dateien eines Films nur dann als Versionen, wenn sie im selben Ordner mit passenden Namen liegen. Zwei Dateien desselben Films in verschiedenen Ordnern werden zu zwei Einträgen. Library Doctor findet sie über ihre TMDb- oder IMDb-ID (oder über Titel und Jahr, wenn sie keine ID haben) und lässt dich die schwächere in Quarantäne verschieben. Siehe die Anleitung.

Findet es jede beschädigte Datei? Es findet Dateien, die fehlen, nicht lesbar sind, keine echte Videospur oder keine Dauer haben, und Dateien, deren Ende sich nicht decodieren lässt. Eine Datei, die sehr kurz vor ihrem Ende abgeschnitten ist (zum Beispiel bei etwa 98 %), kann in ihren letzten Sekunden noch decodierbare Frames haben und die Prüfung bestehen, und nach Schäden in der Mitte einer Datei wird nicht gesucht.

Was es wohin sendet

• Kein externer Kontakt außer dem Lizenz-Client. Keine Online-Abfragen von Metadaten: Duplikate und nicht zugeordnete Titel werden aus den IDs (TMDb/IMDb…) berechnet, die der Server bereits speichert.
• Indirekt: Nach einem Verschieben in die Quarantäne oder einer Wiederherstellung startet das Plugin den regulären Mediathek-Scan, der die auf dem Server konfigurierten Metadatenanbieter kontaktieren kann (Verhalten des Servers, nicht des Plugins).
• Die Dateiprüfung (nur auf Anforderung) führt lokal das ffprobe des Servers für jeden Film / jede Episode aus. Keine geplanten Scans.
• Dazu der Lizenz-Client, in jedem Plugin derselbe: siehe Lizenzierung und Datenschutz in unseren Plugins.

Lokal gespeichert:

• Die Quarantäne löscht nichts: Die Datei und ihre Begleitdateien (Untertitel, nfo, Bilder) werden nach <library root>/.medialab-de-sters/ verschoben; das endgültige Löschen liegt bei dir.
• state/quarantine.json: Titel, Datum, ursprünglicher Pfad und Quarantänepfad, Größe.
• Die Ergebnisse der Dateiprüfung werden nur im Arbeitsspeicher gehalten. Das Plugin liest aus der Mediathek, ob ein Benutzer einen Titel angesehen hat (für „größte ungesehene“), ohne das zu speichern.

Kompatibilität mit Clients

• Nur Admin-Seite: Emby Web ✅. Die Funktionen laufen auf dem Server, die Clients (Apps, Fernseher) sehen also nur die Wirkung (verschobene/gruppierte Titel).
• Tests: End-to-End auf API-Ebene (16/16), Prüfung des Dateiendes an 400/400 echten Dateien ohne Fehlalarm; Emby 0.1.2 läuft auf einem Produktivserver.
• Einschränkungen: Für die Quarantäne braucht der Server Schreibzugriff auf die Mediathek-Ordner; unter Emby 4.10 erscheinen automatisch gruppierte Kopien mit gleicher TMDb-ID weiterhin als Duplikate, bis du sie zusammenführst; ein abgeschnittenes .ts lässt sich nicht erkennen (keine gespeicherte Dauer).

Legende: ✅ verifiziert (End-to-End- oder Test auf dem Gerät) · 🟢 serverseitig, funktioniert mit jedem Client (konstruktionsbedingt, kein clientspezifischer Test) · ➖ nicht zutreffend · ❔ nicht getestet.

Lizenzierung

Eine Lizenz pro Emby-Server. Monatlich, jährlich oder als Lifetime-Lizenz oder im Emby-Paket enthalten. 30 Tage kostenloser Test. Das Plugin ist unter unserer EULA lizenziert.

Library Doctor ist unser eigener Code, von MediaLab Works geschrieben; er enthält keinen Code Dritter.