Saltar al contenido principal

Integración domótica XMLTV TV guide, gratuita y de código abierto

Integración XMLTV TV guide para Gladys Assistant

Lo que se emite ahora, después y esta noche en sus cadenas, desde cualquier guía XMLTV.

Lo que se emite ahora, después y esta noche en las cadenas que sigue, leído de cualquier guía XMLTV: un dispositivo por cadena, un widget para el panel, un disparador de escena por palabras clave («LaLiga», «MasterChef») y dos acciones de escena.

Probada con guías públicas reales (xmltvfr.fr, epgshare01), todavía no en muchas instalaciones de Gladys: sus comentarios son bienvenidos en el foro de Gladys.

Qué necesita​

  • Gladys Assistant 5.1.0 o posterior.
  • La dirección de una guía XMLTV que cubra sus cadenas, .xml o .xml.gz (vea más abajo). Sin cuenta ni clave de API.

Encontrar una guía​

  • Francia, Bélgica, Suiza, África francófona: xmltvfr.fr publica guías gratuitas, rehechas cada día, por ejemplo https://xmltvfr.fr/xmltv/xmltv_tnt.xml.gz (TDT francesa, 1 MB) o https://xmltvfr.fr/xmltv/xmltv.xml.gz (todas las cadenas, 18 MB).
  • Otros países: el proyecto iptv-org/epg reúne las fuentes y las herramientas para crear una guía; sitios comunitarios publican guías listas por país.
  • Su box o proveedor IPTV: muchos ofrecen una dirección XMLTV (a menudo …/xmltv.php?username=…&password=…). Se acepta tal cual y nunca se escribe en los registros.
  • Un archivo: una guía copiada en el volumen de datos de la integración se lee con una dirección como /data/guide.xml.gz.

Configuración​

  1. En Integraciones → XMLTV TV guide → Configuración, indique la dirección de la guía.
  2. En Cadenas seguidas, enumere las cadenas, separadas por comas, 20 como máximo: su identificador en la guía (La1.es) o su nombre (Antena 3). El botón Listar las cadenas (con una búsqueda como tve) muestra los identificadores y nombres de la guía.
  3. Elija el inicio de la noche (21:00 por defecto) y cada cuánto se descarga la guía (cada 12 horas por defecto).
  4. Si lo desea, indique palabras clave para las escenas y el aviso anticipado.
  5. Pulse Probar la guía: descarga la guía e indica qué cadenas seguidas contiene y hasta cuándo.
  6. En la pestaña Descubrimiento, añada a Gladys las cadenas que desee.

El idioma de los textos define los nombres de las funciones, los textos publicados y las salidas de las escenas (francés por defecto).

El dispositivo de cada cadena​

FunciónEjemplo
AhoraMasterChef
Fin del programa actual00:30
Tiempo restante (min)42
A continuación00:30 · Telediario 3
Esta noche22:00 · MasterChef

«Esta noche» es el primer programa de al menos 20 minutos que empieza a partir de 10 minutos antes del inicio de la noche (se saltan el tiempo y los avances), o el programa en emisión a esa hora. Una vez terminado, muestra el de la noche siguiente, precedido de «mañana». Las horas están en la zona horaria de Gladys.

Panel​

El widget Guía de TV muestra hasta 8 cadenas añadidas a Gladys, con el nombre que usted les dio: lo que se emite ahora con el tiempo restante, o (ajuste Mostrar) esta noche con la hora de inicio. La insignia se puede ocultar. Al tocar una cadena se ve ahora, después y esta noche, con los horarios, el episodio y la categoría.

Escenas​

Disparadores​

Programa con una palabra clave: un programa cuyo título contiene una de las palabras clave configuradas empieza en una cadena seguida (sin tener en cuenta acentos ni mayúsculas). Filtros: la palabra clave (tal como está escrita en la configuración), la cadena y el momento — al inicio, o antes del inicio según el aviso anticipado configurado. Variables: palabra clave, cadena, título, subtítulo, categoría, inicio, fin, duración. Un programa ya empezado cuando arranca la integración no activa nada.

Acciones​

  • Leer el programa de una cadena: ahora, después o esta noche en una cadena. Salidas: encontrado (1 o 0), cadena, título, subtítulo, categoría, día, inicio, fin, y los minutos hasta el inicio (o restantes, para ahora).
  • Buscar un programa: la próxima emisión de un título (o de una parte) en las cadenas seguidas, mismas salidas.

Ideas de escenas​

  • A las 20:00, decir «Esta noche en La 1: {{title}} a las {{start}}».
  • «LaLiga» empieza en 10 minutos: enviar un mensaje y encender la tele.
  • Cada sábado por la mañana, buscar «MasterChef» y anunciar su día.

Descargas y carga​

  • La guía se descarga al arrancar y luego cada 6, 12 o 24 horas, con una petición condicional: una guía sin cambios no se vuelve a descargar. Un fallo se reintenta 30 minutos después, y los programas ya conocidos se siguen mostrando.
  • La guía se lee en flujo, aunque pese cientos de megabytes: solo se guardan las cadenas seguidas (unos 100 MB de memoria como máximo al leer la guía completa de xmltvfr.fr, menos de 60 MB en reposo).
  • Los programas de las cadenas seguidas se guardan en caché en el volumen de datos: un reinicio no vuelve a descargar la guía antes de tiempo.
  • Los estados se calculan cada minuto en memoria y solo se publican cuando cambian.

Respete las condiciones de la guía utilizada: las guías gratuitas se rehacen una o dos veces al día, descargarlas más a menudo no aporta nada.

Solución de problemas​

  • «La dirección no lleva a una guía XMLTV»: la dirección devuelve una página web (inicio de sesión, error). Ábrala en un navegador: debe descargar un archivo .xml o .xml.gz.
  • Una cadena seguida «no se encuentra»: use Listar las cadenas con una parte de su nombre y copie su identificador.
  • «Ningún programa»: la guía no tiene programas para esa cadena a esa hora; algunas guías solo cubren pocos días.
  • Horas desfasadas: compruebe la zona horaria de Gladys; las fechas de la guía llevan su propio desfase.

Límites​

  • Solo XMLTV (.xml o gzip .xml.gz; ni .zip ni .xz).
  • 20 cadenas seguidas, programas guardados hasta 8 días por adelantado.
  • Sin imagen, sin resumen, sin grabación: es una guía, no un receptor (para los receptores, vea la integración Enigma2).

Parámetros de configuración​

Estos son los parámetros que XMLTV TV guide te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
FuncionamientosectionNoIndique la dirección de una guía XMLTV (.xml o .xml.gz) y las cadenas que sigue. Pulse «Probar la guía» y añada las cadenas desde la pestaña Descubrimiento. La guía se descarga como máximo cada 6 horas.
Dirección de la guíastringSíUna dirección https:// o http://, o un archivo del volumen de datos (/data/guide.xml.gz).
Cadenas seguidasstringNoIdentificadores o nombres de las cadenas de la guía, separados por comas, 20 como máximo. «Listar las cadenas» los muestra.
Inicio de la nocheselectNoEl programa «Esta noche» es el primero que empieza a partir de esta hora.
Descargar la guíaselectNo
Palabras clave para las escenasstringNoTítulos que vigilar en las cadenas seguidas, separados por comas. Su inicio activa «Programa con una palabra clave».
Aviso anticipadoselectNoEl disparador también puede activarse tantos minutos antes del inicio.
Idioma de los textosselectNoNombres de las funciones, textos publicados y salidas de las escenas. El widget sigue el panel.

Cómo instalar XMLTV TV guide en Gladys​

  1. En Gladys, abre Integraciones: XMLTV TV guide aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-xmltv:1.0.0), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-xmltv.

XMLTV TV guide requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

XMLTV TV guide es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene guim31, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂