Metadatos

De dónde saca ZiiX.TV carátulas, sinopsis y episodios: TMDB o TheTVDB por biblioteca, con su servicio de metadatos o tus claves, y cómo corregir errores.

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

  1. Abre el título y elige Corregir coincidencia.
  2. 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.
  3. Elige el resultado correcto. Los detalles, las imágenes y los episodios se vuelven a obtener; lo que has visto se conserva.