Comment fonctionne l'analyse

Quand ZiiX.TV analyse vos bibliothèques, ce qu'il fait des fichiers nouveaux, modifiés ou supprimés, puis métadonnées, aperçus et détection des intros.

ZiiX.TV garde de lui-même vos bibliothèques synchronisées avec vos dossiers. Vous pouvez aussi lancer une analyse manuellement.

Quand les bibliothèques sont analysées

  • Au démarrage du serveur, car des fichiers ont pu changer pendant qu’il était éteint.
  • Toutes les 15 minutes ensuite. Modifiez ZIIX_SCAN_INTERVAL pour changer cet intervalle, par exemple 30m ou 1h ; 0 désactive les analyses automatiques.
  • Quand vous ajoutez une bibliothèque, immédiatement.
  • Manuellement : Analyser à côté de la bibliothèque dans Paramètres → Bibliothèques.
  • Quand vous changez le type d’une bibliothèque entre Films et Séries, car les noms sont alors lus selon d’autres règles.

Une seule analyse à la fois par bibliothèque.

Ce que fait une analyse

  1. Elle repère ce qui a changé. ZiiX.TV mémorise la taille et la date de modification de chaque fichier. Les fichiers inchangés ne sont pas relus : l’analyse d’une grande bibliothèque qui n’a pas changé ne prend que quelques secondes.
  2. Elle lit les fichiers nouveaux et modifiés avec ffprobe : durée, conteneur, codecs vidéo et audio, résolution, HDR, Dolby Vision et Atmos. Quatre fichiers sont lus à la fois.
  3. Elle retire les fichiers disparus, avec leur historique de visionnage. Un titre qui n’a plus aucun fichier est retiré.
  4. Elle regroupe les fichiers en titres d’après leurs noms ; voir comment nommer vos fichiers.
  5. Elle recherche les nouveaux titres dans TMDB ou TheTVDB ; voir métadonnées.

Pendant une longue première analyse, les titres commencent à apparaître au bout d’environ 15 secondes ; inutile d’attendre la fin de l’analyse. L’appli web et les applis se mettent à jour d’elles-mêmes pendant l’analyse.

Quand le dossier des médias est absent

Si une bibliothèque qui contenait des fichiers n’en a soudain plus aucun (un partage réseau non monté, un disque éteint), l’analyse s’arrête et ne retire rien. La bibliothèque affiche l’erreur, et l’analyse suivante reprend normalement dès que le dossier est de retour.

Fichiers illisibles

Si ffprobe ne parvient pas à lire un fichier, celui-ci est quand même ajouté et peut être lu, mais sans durée ni informations sur les codecs. La bibliothèque indique combien de fichiers sont illisibles.

Ce qui se passe après une analyse

Chaque analyse réveille trois tâches en arrière-plan :

  • Les métadonnées des nouveaux titres.
  • Les images de la barre de progression : une image toutes les 10 secondes de chaque vidéo, pour voir où vous allez quand vous faites glisser la barre de progression. Elles sont conservées dans /previews. Un fichier que vous commencez à lire passe en premier.
  • La détection des génériques de début et de fin : ZiiX.TV écoute les épisodes de chaque saison, et le passage sonore qu’ils ont en commun près du début est le générique de début (de 15 secondes à 2 minutes 30). Le générique de fin est repéré de la même façon. C’est ce qui permet Passer l’intro et le compte à rebours Épisode suivant.

Les images de la barre de lecture et la détection des intros utilisent le processeur et peuvent chacune être désactivées dans Paramètres → Serveur. Les images et les intros sont alors créées à la première lecture d’un fichier ou d’une saison.

Suivre ce qui se passe

  • Paramètres → Bibliothèques affiche l’état de chaque bibliothèque : Analyse… N fichiers trouvés, l’heure de la dernière analyse, ou l’erreur.
  • Paramètres → Système affiche le journal du serveur et ce qu’il est en train d’exécuter.