So richten Sie lokale Metadatendateien ein, ohne unerwünschte Überschreibungen zuzulassen

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Lokale NFO-Dateien und Grafiken machen eine Medienbibliothek portabel, aber derselbe Server, der sie einliest, kann möglicherweise auch Titel, Bilder oder Kennungen ersetzen. Ein schreibgeschützt eingebundener Medienordner verhindert versehentliche Schreibvorgänge, ändert jedoch, wo der Server heruntergeladene Sidecar-Dateien speichern kann.

Lege vor einer Änderung der Berechtigungen für jedes Metadatenfeld eine maßgebliche Quelle fest. Gepflegte Sidecar-Dateien sollten versioniert oder gesichert werden, der Datenbankstatus des Servers muss beschreibbar bleiben, und ein Aktualisierungstest sollte nachweisen, dass der Server die Quelldateien einliest, ohne sie umzuschreiben. Wiederhole den Test nach Upgrades und jeder bibliotheksweiten Metadatenaktualisierung.

Festlegen, welche Metadatenquelle maßgeblich ist

Liste die Felder auf, die du lokal pflegst: Titel, Sortiertitel, Edition, Datum, Personen, Anbieter-IDs, Poster und Hintergrundgrafik. Wenn lokale Dateien maßgeblich sind, deaktiviere oder begrenze Anbieteraktualisierungen, die diese Felder bei einer Aktualisierung überschreiben könnten.

Prüfe das Verhalten von Jellyfin bei NFO-Feldern für die installierte Serverfamilie, bevor du ein Dateinamensschema festlegst. Die Unterstützung unterscheidet sich je nach Bibliothekstyp, und eine scheinbar naheliegende Datei ist möglicherweise nicht die Datei, die der Scanner einliest.

Lege ein kleines Beispielverzeichnis außerhalb der Produktionsbibliothek an. Es sollte einen Film oder eine Episode, die zugehörige NFO-Datei und ausgewählte Grafiken enthalten, damit sich das Verhalten beim Scannen und Aktualisieren testen lässt, ohne Tausende sorgfältig zusammengestellte Dateien zu gefährden.

Schreibgeschützte Medien von beschreibbarem Serverstatus trennen

Binde den Medienbaum im Container schreibgeschützt ein, während die Pfade für Konfiguration, Cache und Datenbank beschreibbar bleiben. Ein Container-Flag wie ein schreibgeschützter Bind-Mount ist zuverlässiger als eine Checkbox in der Anwendung, deren Bedeutung sich zwischen Versionen ändern kann.

Wenn der Server neue Grafiken neben den Mediendateien herunterladen muss, ist eine vollständig schreibgeschützte Bibliothek mit diesem Arbeitsablauf nicht vereinbar. Speichere heruntergeladene Metadaten stattdessen im Anwendungsstatus oder verwende einen kontrollierten Staging-Auftrag, der Sidecar-Dateien außerhalb des Serverprozesses schreibt.

Behandle die Mount-Zuordnung als Teil der Deployment-Dokumentation. Die Jellyfin-Container-Upgrade-Checkliste hilft dabei, bei der Neuerstellung zwischen Medien, Metadaten und Anwendungsstatus zu unterscheiden.

Schreibpfade deaktivieren, die mit der Kuratierung kollidieren

Deaktiviere Optionen, die Coverbilder oder NFO-Metadaten in Medienordnern speichern, wenn diese Ordner extern kuratiert werden. Prüfe auch die Einstellungen zum Speichern von Metadaten für jede Bibliothek; möglicherweise ist das Schreiben nicht nur über eine globale Einstellung aktiviert.

Setze nicht das gesamte Container-Dateisystem schreibgeschützt, um korrekte Mounts zu ersetzen, es sei denn, alle erforderlichen beschreibbaren Pfade sind ausdrücklich festgelegt. Datenbanken, Protokolle, Plugins und temporäre Dateien benötigen weiterhin kontrollierte beschreibbare Speicherorte.

Erfasse die Dateihashes oder Änderungszeiten der Beispiel-NFO-Datei und der Bilder, führe einen Bibliotheksscan aus, bearbeite einen Titel in der Benutzeroberfläche und aktualisiere die Metadaten. Die Dateien sollten unverändert bleiben, während die Anwendung zulässige lokale Zustände in ihrer Datenbank speichert.

Single board computer zimaboard2

Wiederherstellungs- und Upgrade-Verhalten überprüfen

Exportiere oder sichere die kuratierten Sidecar-Dateien unabhängig von der Medienserver-Datenbank. Die Sidecar-Dateien stellen Präsentationsmetadaten wieder her; die Datenbank kann weiterhin Wiedergabestatus, Benutzer, Sammlungen und andere Informationen enthalten, die nicht in lokalen Dateien gespeichert sind.

Erstelle den Container in einem Testfenster neu und bestätige, dass das schreibgeschützte Mount-Flag den Deployment-Prozess übersteht. Durchsuche dann das Beispielverzeichnis und vergleiche erneut die Hashes, denn ein Upgrade kann einen neuen Metadaten-Speicher einführen oder einen Standardwert ändern.

Die Regel für den letzten Check ist einfach: Wenn eine Aktualisierung Schreibzugriff erfordert, um das gewünschte Ergebnis zu erhalten, ist das Konzept der maßgeblichen Datenquelle noch ungeklärt. Stelle das Beispiel wieder her, lasse die Produktionsumgebung schreibgeschützt und entscheide, ob der Server oder der externe Kurator für dieses Feld zuständig ist.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.