ZiiX.TV sucht jeden Titel in TMDB (The Movie Database) oder TheTVDB und holt Poster, Hintergrundbild, Beschreibung und mehr.
Was geholt wird
- Titel, Originaltitel, Jahr, Beschreibung, Bewertung, Laufzeit und Genres.
- Poster und Hintergrundbild, das Logo des Titels und ein YouTube-Trailer.
- Bis zu 20 Darsteller, Regie (bei Serien die Macher), Studio oder Sender.
- Altersfreigabe, verwendet für Altersgrenzen pro Benutzer.
- Erscheinungsdatum und Slogan.
- Die Sammlung des Films, damit alle Bond-Filme zusammen angezeigt werden können.
- Bei Serien: Name, Beschreibung, Ausstrahlungsdatum und Bild jeder Folge.
Die Bilder werden auf deinem Server gespeichert, im Ordner config.
TMDB oder TheTVDB
Jede Mediathek hat ihre eigene Quelle, die du beim Hinzufügen wählst und später ändern kannst:
- TMDB ist meist am besten für Filme und die einzige Quelle mit Bewertungen.
- TheTVDB ist oft am besten für Serien: Folgennamen und die Reihenfolge der Staffeln wie bei der Ausstrahlung.
Wenn du die Quelle änderst, wird jeder Titel der Mediathek neu gesucht. Was du gesehen hast, bleibt erhalten.
Sprache
ZIIX_METADATA_LANGUAGE in .env legt die Sprache für Titel und Beschreibungen für den ganzen Server fest, zum Beispiel en-US, da-DK, de-DE, fr-FR oder es-ES. Gibt es eine Beschreibung nicht in dieser Sprache, wird die englische verwendet. Altersfreigaben richten sich nach dem Land im Code, mit der US-Freigabe als Ersatz.
Über ZiiX.TV oder mit eigenen Schlüsseln
Du brauchst keine eigenen Schlüssel. Ohne sie holt dein Server die Metadaten über den Metadatendienst von ZiiX.TV unter metadata.ziix.tv, mit seiner Lizenz. Die Bilder selbst kommen direkt von TMDB und TheTVDB.
- Während der Testphase bestätigst du deine E-Mail-Adresse unter Einstellungen → Server, um den Metadatendienst zu nutzen. Pro E-Mail-Adresse gibt es eine Testphase.
- Mit einer Lizenz funktioniert es einfach.
Wenn du lieber direkt mit TMDB oder TheTVDB sprechen willst, trag deine eigenen Schlüssel in .env ein und starte neu:
# Kostenlos bei themoviedb.org: Einstellungen → API
ZIIX_TMDB_API_KEY=your-key
# Bei thetvdb.com: Dashboard → API Keys
ZIIX_TVDB_API_KEY=your-key
# Nur für einen Schlüssel, der als Abonnent gekauft wurde
ZIIX_TVDB_PIN=your-pin
Die beiden Quellen sind unabhängig: Du kannst deinen eigenen TMDB-Schlüssel und ZiiX.TV für TheTVDB nutzen oder umgekehrt. Einstellungen → Server zeigt, woher die Metadaten kommen.
So funktioniert die Zuordnung
ZiiX.TV sucht nach dem Titel und Jahr aus dem Dateinamen und bewertet jedes Ergebnis: Derselbe Titel, dasselbe Jahr und dieselben Zahlen („Part 2“, „Alien 3“) zählen am meisten. Das beste Ergebnis wird gewählt. Wird mit dem Jahr nichts gefunden, sucht es noch einmal ohne.
Ein Titel, der nicht gefunden wird, wird als nicht zugeordnet markiert und nicht bei jedem Scan neu gesucht. Nicht zugeordnete Titel erneut suchen unter Einstellungen → Server versucht es noch einmal mit allen, zum Beispiel nachdem du Dateien umbenannt hast. Der Filter Nicht zugeordnet in einer Mediathek listet sie auf.
Zugeordnete Titel behalten ihre Details; neue Staffeln einer Serie bekommen ihre Folgendetails, sobald sie erscheinen.
Eine falsche Zuordnung korrigieren
- Öffne den Titel und wähle Zuordnung korrigieren.
- ZiiX.TV sucht sofort nach dem aktuellen Titel und zeigt die Datei oder den Ordner, aus dem der Titel entstanden ist. Ändere bei Bedarf die Suche oder ergänze ein Jahr.
- Wähle das richtige Ergebnis. Details, Bilder und Folgen werden neu geholt; was du gesehen hast, bleibt erhalten.