ZiiX.TV hält deine Mediatheken von selbst auf dem Stand deiner Ordner. Du kannst einen Scan auch von Hand starten.
Wann Mediatheken gescannt werden
- Beim Start des Servers, da sich Dateien geändert haben können, während er aus war.
- Danach alle 15 Minuten. Setze
ZIIX_SCAN_INTERVAL, um das zu ändern, zum Beispiel auf30moder1h;0schaltet automatische Scans ab. - Wenn du eine Mediathek hinzufügst, sofort.
- Von Hand: Scannen neben der Mediathek unter Einstellungen → Mediatheken.
- Wenn du den Typ einer Mediathek zwischen Filme und Serien änderst, da die Namen dann nach anderen Regeln gelesen werden.
Pro Mediathek läuft immer nur ein Scan gleichzeitig.
Was ein Scan macht
- Findet, was sich geändert hat. ZiiX.TV merkt sich Größe und Änderungszeit jeder Datei. Unveränderte Dateien werden nicht erneut gelesen, daher dauert der Scan einer großen, unveränderten Mediathek nur Sekunden.
- Liest neue und geänderte Dateien mit
ffprobe: Länge, Container, Video- und Audiocodecs, Auflösung, HDR, Dolby Vision und Atmos. Es werden vier Dateien gleichzeitig gelesen. - Entfernt Dateien, die weg sind, samt ihrem Wiedergabeverlauf. Ein Titel ohne verbleibende Dateien wird entfernt.
- Fasst Dateien anhand ihrer Namen zu Titeln zusammen; siehe Dateien richtig benennen.
- Sucht neue Titel in TMDB oder TheTVDB; siehe Metadaten.
Bei einem langen ersten Scan erscheinen die ersten Titel nach etwa 15 Sekunden; du musst nicht warten, bis der Scan fertig ist. Die Web-App und die Apps aktualisieren sich währenddessen von selbst.
Wenn der Medienordner fehlt
Hat eine Mediathek, die Dateien hatte, plötzlich keine mehr (eine Netzwerkfreigabe, die nicht eingebunden ist, eine Festplatte, die aus ist), bricht der Scan ab und entfernt nichts. Die Mediathek zeigt den Fehler an, und der nächste Scan läuft wieder normal, sobald der Ordner zurück ist.
Dateien, die nicht gelesen werden konnten
Kann ffprobe eine Datei nicht lesen, wird sie trotzdem hinzugefügt und lässt sich abspielen, allerdings ohne Angaben zu Länge und Codecs. Die Mediathek zeigt an, wie viele Dateien nicht gelesen werden konnten.
Was nach einem Scan passiert
Jeder Scan stößt drei Aufgaben im Hintergrund an:
- Metadaten für neue Titel.
- Vorschaubilder für die Zeitleiste: ein Bild alle 10 Sekunden jedes Videos, damit du beim Ziehen der Zeitleiste siehst, wohin du springst. Sie werden in
/previewsgespeichert. Eine Datei, die du gerade abspielst, ist zuerst dran. - Intro- und Abspann-Erkennung: ZiiX.TV hört sich die Folgen jeder Staffel an, und der Tonabschnitt, den sie kurz nach dem Anfang gemeinsam haben, ist das Intro (15 Sekunden bis 2½ Minuten). Der Abspann wird genauso gefunden. Daraus entstehen Intro überspringen und der Countdown zur Nächsten Folge.
Die Zeitleisten-Bilder und die Intro-Erkennung nutzen die CPU und lassen sich jeweils unter Einstellungen → Server abschalten. Die Bilder und Intros werden dann erst erzeugt, wenn eine Datei oder Staffel zum ersten Mal abgespielt wird.
Zuschauen, wie es passiert
- Einstellungen → Mediatheken zeigt den Zustand jeder Mediathek: Wird gescannt … N Dateien gefunden, die Zeit des letzten Scans oder den Fehler.
- Einstellungen → System zeigt das Protokoll des Servers und was er gerade ausführt.