Jellyfin-Namenskonvention und Scraping-Leitfaden

Woher Jellyfin Metadaten bezieht

Jellyfin liest Metadaten aus TMDB, TVDB und lokalen NFO-Dateien. Dateinamen und Ordnerstruktur sind in allen drei Wegen die erste Eingabe – lose Benennung bringt deshalb alles danach durcheinander.

Struktur der Filmbibliothek

                      Movies/
└── Parasite (2019)/
    ├── Parasite (2019).mkv
    ├── Parasite (2019).zh.srt
    └── poster.jpg
                    

Struktur der Serienbibliothek

• Die oberste Ebene ist ein Ordner Serie (Jahr)
• Staffelordner als Season 01 / Season 02, Specials als Season 00
• Folgen tragen SxxExx; mehrteilige Dateien nutzen S01E01-E02
• tvshow.nfo im Serienordner ergänzen, wenn Metadaten fixiert werden sollen

                      Shows/
└── Chernobyl (2019)/
    ├── Season 01/
    │   ├── Chernobyl.S01E01.mkv
    │   ├── Chernobyl.S01E02.mkv
    │   └── Chernobyl.S01E03.mkv
    └── tvshow.nfo
                    

Untertitel und Begleitdateien benennen

• Untertitel teilen den Videonamen plus Sprachcode, z. B. Show.S01E01.zh.srt
• Artwork: poster.jpg (hoch), fanart.jpg / backdrop.jpg (quer)
• Staffel-Artwork: Season01-poster.jpg oder poster.jpg im Staffelordner
• Alles hängt am Videodateinamen und muss mit umbenannt werden

Fehlersuche beim Scraping

• Bibliothekstypen prüfen: Filme und Serien brauchen getrennte Bibliotheken – die falsche scrapet nie korrekt
• Hierarchie und SxxExx-Benennung wie oben prüfen
• Prüfen, ob die TMDB-/TVDB-Plugins das Netzwerk erreichen (in manchen Regionen ist ein Proxy nötig)
• Prüfen, ob die Metadatensprache in den Bibliothekseinstellungen zum erwarteten Artwork passt
• Metadaten einer einzelnen Serie aktualisieren, um Datei- von Netzwerkproblemen zu trennen

Bestehende Dateien im Stapel normalisieren

VRenamer verbindet sich über SMB oder WebDAV mit dem Medienordner, scannt ihn, schreibt Jellyfin-konforme Namen auf Basis der TMDB-Daten und richtet Untertitel an ihren Videos aus. Danach in Jellyfin einen Bibliotheksscan ausführen.

Können Jellyfin und Emby dieselbe Ordnerstruktur nutzen?

Ja. Beide verwenden dieselbe Hierarchie und SxxExx-Konvention, ein Benennungsschema funktioniert also in Jellyfin, Emby, Plex und Infuse – genau deshalb lohnt sich Standardbenennung.

Sind NFO-Dateien Pflicht?

Nein. NFO fixiert Metadaten gegen Anbieteränderungen oder Offline-Setups. Bei korrekter Benennung holt Jellyfin alles Nötige aus TMDB / TVDB.

Bemerkt Jellyfin umbenannte Dateien von selbst?

Beim nächsten geplanten Task ja, aber „Medienbibliothek scannen“ wirkt sofort. Wenn Metadaten weiterhin falsch sind, für den Eintrag „Metadaten aktualisieren“ ausführen, damit er mit dem neuen Dateinamen neu zugeordnet wird.