XMLTV¶

mw.epg.xmltv

Direcciones¶

Las direcciones son relativas a la raíz de la instalación: si la vitrina se abre en https://tv.example.com/tv/, la lista habitual está en https://tv.example.com/playback/tv/playlist.m3u8, y la IPTV en https://tv.example.com/playback/tv/iptv.m3u8.

Vale cualquiera de los dos tokens:

• el token de reproducción del suscriptor — el que el operador ve en su ficha, campo Token de reproducción;
• un token de dispositivo obtenido al entrar en la vitrina.

La diferencia está solo en la revocación: al revocar un dispositivo se apaga también su enlace, mientras que el token de reproducción vive con el propio suscriptor.

Qué hay dentro del XMLTV¶

El archivo contiene las declaraciones de canales y sus programas. La ventana por omisión es de un día atrás y seis adelante: el día pasado es lo que necesita el catch-up, y seis días es el propio límite de la guía.

La ventana puede fijarse con los parámetros from y to — momentos en formato RFC 3339, por ejemplo ?from=2026-08-20T00:00:00Z&to=2026-08-22T00:00:00Z.

Las horas de los programas siempre se pasan a UTC y se escriben en la forma XMLTV YYYYMMDDHHMMSS +0000. Un programa cuyos límites no se pueden leer se omite: una sola fecha rota hace que el reproductor dibuje todo el archivo como una parrilla vacía, no solo esa fila.

El horario viene de la guía de programación. Si está vacía, el XMLTV llegará con las declaraciones de canales y sin programas — y eso se arregla en la fuente, no en la exportación.

Límites¶

• El límite de pantallas rige también aquí. Una reproducción desde un reproductor externo ocupa una pantalla igual que una en la vitrina; al llegar al límite, el reproductor recibe un rechazo (Cuántas pantallas a la vez).
• El catch-up en la lista habitual lo construye el propio reproductor con los límites del programa que trae el XMLTV. En la lista IPTV la ventana se declara en la entrada si el stream tiene archivo. Lo que está grabado lo decide el archivo del stream: más allá no hay nada que reproducir.
• El archivo no se actualiza solo. Si aparece un canal nuevo en la suscripción, el suscriptor vuelve a descargar la lista. La lista IPTV también se vuelve a descargar cuando ha caducado el permiso de los enlaces.