La guía de programación XMLTV: qué es, cómo se empareja y cómo importarla
5 min de lectura
Una guía de programación (EPG, por sus siglas en inglés) te dice qué se emite ahora en cada canal y qué viene después. Para las listas M3U, la forma más común de distribuirla es XMLTV, un formato abierto en XML que existe desde hace muchos años y que entienden casi todos los reproductores. Aquí verás cómo es por dentro, cómo se une a tus canales y qué hacer cuando no aparece o sale con la hora cambiada.
Cómo es un archivo XMLTV
Tiene dos partes: la lista de canales y la lista de programas. Un ejemplo reducido:
<?xml version="1.0" encoding="UTF-8"?><tv> <channel id="CanalUno.es"> <display-name>Canal Uno</display-name> <icon src="https://example.com/logos/canal-uno.png"/> </channel> <programme start="20261106210000 +0100" stop="20261106220000 +0100" channel="CanalUno.es"> <title>Informativo de la noche</title> <desc>Resumen de la actualidad del día.</desc> <category>Noticias</category> </programme></tv>
channel ides el identificador del canal. No tiene un formato fijo, aunque es habitual algo comoNombreDelCanal.es.display-namees su nombre legible; puede haber varios.programmelleva el canal al que pertenece y las horas de inicio y fin, con el formatoAAAAMMDDhhmmssseguido de la diferencia con la hora universal:+0100es la hora peninsular española en invierno, y+0200, en verano.- Dentro van el título y, si los hay, el subtítulo, la descripción, la categoría y una imagen.
Las guías completas pueden pesar cientos de megas, por eso suelen publicarse comprimidas, en .xml.gz o .zip.
Cómo se empareja la guía con tus canales
La guía y la lista son archivos distintos, a menudo de fuentes distintas. Para saber qué programación va con cada canal, el reproductor busca coincidencias. Whatplay lo hace en este orden:
- Por el
tvg-iddel canal en la M3U (o elepgIden W3U), comparado con elchannel idde la guía. - Por el nombre, si no hay identificador o no coincide: el nombre del canal en tu lista frente al
display-namede la guía.
No hace falta que coincidan letra por letra. Whatplay compara sin mayúsculas, sin tildes y sin espacios ni signos; quita del final las marcas de calidad (HD, FHD, UHD, 4K) y, en los identificadores, el sufijo del país, como .es. Así, «Canal Uno HD» en tu lista encuentra a «Canal Uno» en la guía. Pero «C1» y «Canal Uno» no se parecen en nada: para eso está el tvg-id.
Un canal bien preparado para la guía se ve así en la M3U:
#EXTINF:-1 tvg-id="CanalUno.es" tvg-logo="https://example.com/logos/canal-uno.png",Canal Unohttps://example.com/emision/canal-uno.m3u8
Cómo importarla en Whatplay
- Si tu lista ya la indica (en la M3U, con
url-tvgox-tvg-urlen la línea#EXTM3U; en W3U, conepg), la Guía te lo dice con el aviso «La lista «…» trae su guía de programación» y un botón para importarla. - Si no, ve a la Guía y toca «Importar guía». Pega la dirección de una guía XMLTV (.xml, .xml.gz o .zip) o toca «Desde archivo» para elegir una del dispositivo.
La guía se descarga en segundo plano y se va viendo según llega. En «Guías importadas» verás cuántos canales y programas trae, y desde ahí puedes quitarla. La Guía tiene dos vistas: «Ahora», con lo que se emite en este momento en cada canal, y «Parrilla», con el día entero y un selector de días. En el reproductor, bajo el nombre del canal, aparecen «Ahora» y «Después». Whatplay actualiza las guías de vez en cuando y, si no han cambiado, no las vuelve a descargar. Lo resume la ayuda en ¿Cómo pongo la guía de programación?
Problemas típicos
«Ningún canal de tus listas aparece en las guías importadas»
La guía se ha importado, pero ningún identificador ni nombre coincide. Abre la guía en un editor de texto, busca cómo se llama tu canal en sus channel id y pon ese valor en el tvg-id de tu lista. Comprueba también que la guía sea del mismo país o región que tus canales.
Los programas salen con una hora de diferencia
Lo habitual es que la guía declare mal su zona horaria: horas locales marcadas como +0000, o una diferencia que no cambia con el horario de verano. Whatplay respeta lo que dice cada programa y lo pasa a tu hora, así que, si la guía está mal, el arreglo está en la guía.
«No es una guía XMLTV o no tiene programas para estos días»
O la dirección no lleva a un XMLTV (por ejemplo, abre una página web), o la guía está caducada y solo tiene programas pasados. Las guías se regeneran a menudo: una copia antigua deja de servir enseguida.
Has pegado la guía en «Añadir lista»
Whatplay lo detecta, te dice que es una guía de programación y no una lista, y te indica dónde importarla con la misma dirección.
Tarda mucho en cargar
Las guías grandes cuestan de descargar y de leer. Usa la versión comprimida si existe y, si la fuente lo permite, una guía solo con los canales que usas.
La guía está en tu red de casa
Desde Android 17, para descargar una guía de un ordenador o un NAS de tu red, Whatplay necesita el permiso «Dispositivos cercanos». La app te lo pide con un aviso.
Hacer tu propia guía
Si emites algo tuyo con horario fijo, como la radio de una asociación o el canal de un centro educativo, puedes escribir un XMLTV a mano: basta con un channel y sus programme, con la zona horaria bien puesta y el archivo en UTF-8. Para unirlo a tu canal, usa el mismo identificador en el tvg-id de tu lista M3U o en el epgId de tu W3U; tienes las dos explicadas en M3U, M3U8 y W3U.