ZiiX.TV busca cada título en TMDB (The Movie Database) o TheTVDB y obtiene sus carátulas, imagen de fondo, sinopsis y más.
Qué se obtiene
- Título, título original, año, sinopsis, puntuación, duración y géneros.
- Carátula e imagen de fondo, el logotipo del título y un tráiler de YouTube.
- Hasta 20 miembros del reparto, directores (creadores en las series), estudio o cadena.
- Clasificación por edad, que se usa para los límites de edad por usuario.
- Fecha de estreno y eslogan.
- La colección de la película, para que todas las películas de Bond se puedan mostrar juntas.
- Para las series: el nombre, la sinopsis, la fecha de emisión y la imagen de cada episodio.
Las imágenes se guardan en tu servidor, en la carpeta config.
TMDB o TheTVDB
Cada biblioteca tiene su propia fuente, que eliges al añadirla y puedes cambiar después:
- TMDB suele ser la mejor para películas, y es la única fuente con puntuaciones.
- TheTVDB suele ser la mejor para series: nombres de episodios y el orden de las temporadas tal como se emitieron.
Al cambiar la fuente, se vuelven a buscar todos los títulos de la biblioteca. Lo que has visto se conserva.
Idioma
ZIIX_METADATA_LANGUAGE en .env define el idioma de los títulos y las sinopsis para todo el servidor, por ejemplo en-US, da-DK, de-DE, fr-FR o es-ES. Cuando una sinopsis no existe en ese idioma, se usa la inglesa. Las clasificaciones por edad siguen el país del código, con la clasificación de EE. UU. como alternativa.
A través de ZiiX.TV o con tus propias claves
No necesitas claves propias. Sin ellas, tu servidor obtiene los metadatos a través del servicio de metadatos de ZiiX.TV en metadata.ziix.tv, usando su licencia. Las imágenes en sí llegan directamente de TMDB y TheTVDB.
- Durante la prueba, confirma tu dirección de email en Ajustes → Servidor para usar el servicio de metadatos. Hay una prueba por dirección de email.
- Con una licencia, funciona sin más.
Si prefieres conectar directamente con TMDB o TheTVDB, define tus propias claves en .env y reinicia:
# Gratis en themoviedb.org: Settings → API
ZIIX_TMDB_API_KEY=your-key
# En thetvdb.com: Dashboard → API Keys
ZIIX_TVDB_API_KEY=your-key
# Solo para una clave comprada como suscriptor
ZIIX_TVDB_PIN=your-pin
Las dos fuentes son independientes: puedes usar tu propia clave de TMDB y ZiiX.TV para TheTVDB, o al revés. Ajustes → Servidor muestra de dónde vienen los metadatos.
Cómo funciona la identificación
ZiiX.TV busca el título y el año leídos del nombre del archivo y puntúa cada resultado: el mismo título, el mismo año y los mismos números (“Part 2”, “Alien 3”) son lo que más cuenta. Se elige el mejor resultado. Si no encuentra nada con el año, vuelve a buscar sin él.
Un título que no se encuentra se marca como sin coincidencia y no se vuelve a buscar en cada escaneo. Volver a buscar los títulos sin coincidencia, en Ajustes → Servidor, los prueba todos otra vez, por ejemplo después de renombrar archivos. El filtro Sin coincidencia de una biblioteca los muestra.
Los títulos identificados conservan sus detalles; las temporadas nuevas de una serie reciben los detalles de sus episodios a medida que aparecen.
Corregir una coincidencia incorrecta
- Abre el título y elige Corregir coincidencia.
- ZiiX.TV busca el título actual al momento y muestra el archivo o la carpeta de la que salió el título. Cambia la búsqueda o añade un año si hace falta.
- Elige el resultado correcto. Los detalles, las imágenes y los episodios se vuelven a obtener; lo que has visto se conserva.