Cómo funciona el escaneo

Cuándo escanea ZiiX.TV tus bibliotecas, qué hace con los archivos nuevos, cambiados y eliminados, y lo que viene después: metadatos, imágenes e intros.

ZiiX.TV mantiene tus bibliotecas al día con tus carpetas por sí solo. También puedes iniciar un escaneo a mano.

Cuándo se escanean las bibliotecas

  • Cuando arranca el servidor, porque los archivos pueden haber cambiado mientras estaba apagado.
  • Cada 15 minutos después. Define ZIIX_SCAN_INTERVAL para cambiarlo, por ejemplo 30m o 1h; 0 desactiva los escaneos automáticos.
  • Cuando añades una biblioteca, al momento.
  • A mano: Escanear, junto a la biblioteca en Ajustes → Bibliotecas.
  • Cuando cambias el tipo de una biblioteca entre Películas y Series, porque entonces los nombres se leen con otras reglas.

Solo se ejecuta un escaneo por biblioteca a la vez.

Qué hace un escaneo

  1. Encuentra lo que ha cambiado. ZiiX.TV recuerda el tamaño y la fecha de modificación de cada archivo. Los archivos sin cambios no se vuelven a leer, así que escanear una biblioteca grande que no ha cambiado lleva unos segundos.
  2. Lee los archivos nuevos y cambiados con ffprobe: duración, contenedor, códecs de video y audio, resolución, HDR, Dolby Vision y Atmos. Se leen cuatro archivos a la vez.
  3. Quita los archivos que ya no están, con su historial. Un título que se queda sin archivos se quita.
  4. Agrupa los archivos en títulos según sus nombres; consulta cómo nombrar los archivos.
  5. Busca los títulos nuevos en TMDB o TheTVDB; consulta metadatos.

Durante un primer escaneo largo, los títulos empiezan a aparecer en unos 15 segundos; no hace falta esperar a que termine. La app web y las apps se actualizan solas mientras tanto.

Si falta la carpeta de medios

Si una biblioteca que tenía archivos de repente no tiene ninguno (una carpeta de red sin montar, un disco apagado), el escaneo se detiene y no quita nada. La biblioteca muestra el error, y el siguiente escaneo continúa con normalidad cuando la carpeta vuelve.

Archivos que no se pudieron leer

Si ffprobe no puede leer un archivo, este se añade igualmente y se puede reproducir, pero sin duración ni detalles de códecs. La biblioteca muestra cuántos archivos no se pudieron leer.

Qué pasa después de un escaneo

Cada escaneo pone en marcha tres tareas en segundo plano:

  • Metadatos para los títulos nuevos.
  • Imágenes de la barra de progreso: una imagen cada 10 segundos de cada video, para que veas adónde vas al arrastrar la barra de progreso. Se guardan en /previews. El archivo que empiezas a reproducir va primero.
  • Detección de intros y créditos: ZiiX.TV escucha los episodios de cada temporada, y el tramo de sonido que comparten cerca del principio es la intro (de 15 segundos a 2 minutos y medio). Los créditos finales se encuentran del mismo modo. Así funcionan Saltar intro y la cuenta atrás de Siguiente episodio.

Las imágenes de la barra de reproducción y la detección de intros usan la CPU y cada una se puede desactivar en Ajustes → Servidor. En ese caso, las imágenes y las intros se crean cuando se reproduce por primera vez un archivo o una temporada.

Seguir el proceso

  • Ajustes → Bibliotecas muestra el estado de cada biblioteca: Escaneando… N archivos encontrados, la hora del último escaneo o el error.
  • Ajustes → Sistema muestra el registro del servidor y lo que está haciendo en este momento.