ZiiX.TV recherche chaque titre dans TMDB (The Movie Database) ou TheTVDB et récupère ses affiches, son image de fond, son résumé et plus encore.
Ce qui est récupéré
- Titre, titre original, année, résumé, note, durée et genres.
- Affiche et image de fond, logo du titre et bande-annonce YouTube.
- Jusqu’à 20 membres de la distribution, les réalisateurs (les créateurs pour les séries), le studio ou la chaîne.
- La classification d’âge, utilisée pour les limites d’âge par utilisateur.
- La date de sortie et le slogan.
- La collection du film, pour afficher ensemble tous les James Bond.
- Pour les séries : le nom, le résumé, la date de diffusion et l’image de chaque épisode.
Les images sont stockées sur votre serveur, dans le dossier config.
TMDB ou TheTVDB
Chaque bibliothèque a sa propre source, choisie lors de son ajout et modifiable ensuite :
- TMDB est généralement le meilleur choix pour les films, et la seule source qui fournit des notes.
- TheTVDB est souvent le meilleur choix pour les séries : noms des épisodes et ordre des saisons tel que diffusé.
Changer de source relance la recherche de tous les titres de la bibliothèque. Ce que vous avez regardé est conservé.
Langue
ZIIX_METADATA_LANGUAGE dans .env définit la langue des titres et des résumés pour tout le serveur, par exemple en-US, da-DK, de-DE, fr-FR ou es-ES. Quand un résumé n’existe pas dans cette langue, la version anglaise est utilisée. Les classifications d’âge suivent le pays indiqué dans le code, avec la classification américaine par défaut.
Via ZiiX.TV, ou avec vos propres clés
Vous n’avez besoin d’aucune clé personnelle. Sans clé, votre serveur récupère les métadonnées via le service de métadonnées de ZiiX.TV à l’adresse metadata.ziix.tv, grâce à sa licence. Les images elles-mêmes viennent directement de TMDB et TheTVDB.
- Pendant l’essai, confirmez votre adresse e-mail dans Paramètres → Serveur pour utiliser le service de métadonnées. Il y a un essai par adresse e-mail.
- Avec une licence, tout fonctionne directement.
Si vous préférez interroger directement TMDB ou TheTVDB, indiquez vos propres clés dans .env et redémarrez :
# Gratuite sur themoviedb.org : Settings → API
ZIIX_TMDB_API_KEY=your-key
# Sur thetvdb.com : Dashboard → API Keys
ZIIX_TVDB_API_KEY=your-key
# Uniquement pour une clé achetée en tant qu'abonné
ZIIX_TVDB_PIN=your-pin
Les deux sources sont indépendantes : vous pouvez utiliser votre propre clé TMDB et ZiiX.TV pour TheTVDB, ou l’inverse. Paramètres → Serveur indique d’où viennent les métadonnées.
Comment fonctionne la correspondance
ZiiX.TV recherche le titre et l’année lus dans le nom du fichier, puis attribue un score à chaque résultat : le même titre, la même année et les mêmes numéros (« Part 2 », « Alien 3 ») comptent le plus. Le meilleur résultat est retenu. Si rien n’est trouvé avec l’année, il recherche à nouveau sans elle.
Un titre introuvable est marqué non identifié et n’est pas recherché à nouveau à chaque analyse. Rechercher à nouveau les titres non identifiés, dans Paramètres → Serveur, les essaie tous une nouvelle fois, par exemple après avoir renommé des fichiers. Le filtre Non identifiés d’une bibliothèque les liste.
Les titres identifiés conservent leurs détails ; les nouvelles saisons d’une série reçoivent les détails de leurs épisodes au fur et à mesure.
Corriger une mauvaise correspondance
- Ouvrez le titre et choisissez Corriger la correspondance.
- ZiiX.TV recherche aussitôt le titre actuel et affiche le fichier ou le dossier à partir duquel le titre a été créé. Modifiez la recherche ou ajoutez une année si nécessaire.
- Choisissez le bon résultat. Les détails, les images et les épisodes sont récupérés à nouveau ; ce que vous avez regardé est conservé.