O guia de programação XMLTV: o que é, como se associa e como importar

5 min de leitura

Um guia de programação (EPG, na sigla em inglês) mostra o que está passando agora em cada canal e o que vem depois. Para as listas M3U, a forma mais comum de distribuí-lo é o XMLTV, um formato aberto em XML que existe há muitos anos e que quase todos os players entendem. Aqui você vai ver como ele é por dentro, como se liga aos seus canais e o que fazer quando ele não aparece ou aparece com o horário trocado.

Como é um arquivo XMLTV

Ele tem duas partes: a lista de canais e a lista de programas. Um exemplo resumido:

<?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 id é o identificador do canal. Não tem um formato fixo, embora seja comum algo como NombreDelCanal.es.
display-name é o nome legível; pode haver vários.
programme traz o canal a que pertence e os horários de início e fim, no formato AAAAMMDDhhmmss, seguido da diferença em relação ao horário universal: +0100 é o horário da Espanha peninsular no inverno, e +0200, no verão.
Dentro vão o título e, se houver, o subtítulo, a descrição, a categoria e uma imagem.

Os guias completos podem pesar centenas de megas; por isso, costumam ser publicados compactados, em .xml.gz ou .zip.

Como o guia se associa aos seus canais

O guia e a lista são arquivos diferentes, muitas vezes de fontes diferentes. Para saber qual programação vai com cada canal, o player procura correspondências. O Whatplay faz isso nesta ordem:

Pelo tvg-id do canal na M3U (ou o epgId na W3U), comparado com o channel id do guia.
Pelo nome, se não houver identificador ou se ele não coincidir: o nome do canal na sua lista comparado com o display-name do guia.

Não é preciso que eles coincidam letra por letra. O Whatplay compara sem maiúsculas, sem acentos e sem espaços nem sinais; tira do final as marcas de qualidade (HD, FHD, UHD, 4K) e, nos identificadores, o sufixo do país, como .es. Assim, “Canal Uno HD” na sua lista encontra “Canal Uno” no guia. Mas “C1” e “Canal Uno” não se parecem em nada: para isso existe o tvg-id.

Um canal bem preparado para o guia fica assim na M3U:

#EXTINF:-1 tvg-id="CanalUno.es" tvg-logo="https://example.com/logos/canal-uno.png",Canal Uno
https://example.com/emision/canal-uno.m3u8

Como importá-lo no Whatplay

Se a sua lista já o indica (na M3U, com url-tvg ou x-tvg-url na linha #EXTM3U; na W3U, com epg), o Guia avisa com a mensagem “A lista ‘…’ vem com guia de programação” e um botão para importá-lo.
Se não, vá ao Guia e toque em “Importar guia”. Cole o endereço de um guia XMLTV (.xml, .xml.gz ou .zip) ou toque em “De um arquivo” para escolher um do dispositivo.

O guia é baixado em segundo plano e vai aparecendo conforme chega. Em “Guias importados”, você vê quantos canais e programas ele traz, e dali pode removê-lo. O Guia tem duas visualizações: “Agora”, com o que está passando neste momento em cada canal, e “Grade”, com o dia inteiro e um seletor de dias. No player, abaixo do nome do canal, aparecem “Agora” e “Depois”. O Whatplay atualiza os guias de vez em quando e, se eles não mudaram, não os baixa de novo. A ajuda resume isso em Como coloco o guia de programação?

Problemas comuns

“Nenhum canal das suas listas aparece nos guias importados”

O guia foi importado, mas nenhum identificador nem nome coincide. Abra o guia em um editor de texto, procure como o seu canal se chama nos channel id e coloque esse valor no tvg-id da sua lista. Confira também se o guia é do mesmo país ou região dos seus canais.

Os programas aparecem com uma hora de diferença

O mais comum é o guia declarar o fuso horário errado: horários locais marcados como +0000, ou uma diferença que não muda com o horário de verão. O Whatplay respeita o que cada programa diz e converte para o seu horário; então, se o guia está errado, a correção tem que ser feita no guia.

“Não é um guia XMLTV ou não tem programas para estes dias”

Ou o endereço não leva a um XMLTV (por exemplo, abre uma página da web), ou o guia está vencido e só tem programas passados. Os guias são gerados de novo com frequência: uma cópia antiga logo deixa de servir.

Você colou o guia em “Adicionar lista”

O Whatplay percebe, avisa que é um guia de programação e não uma lista, e mostra onde importá-lo com o mesmo endereço.

Demora muito para carregar

Os guias grandes demoram para ser baixados e lidos. Use a versão compactada, se existir, e, se a fonte permitir, um guia só com os canais que você usa.

O guia está na sua rede de casa

A partir do Android 17, para baixar um guia de um computador ou de um NAS da sua rede, o Whatplay precisa da permissão “Dispositivos por perto”. O app pede essa permissão com um aviso.

Criar seu próprio guia

Se você transmite algo seu com horário fixo, como a rádio de uma associação ou o canal de uma escola, pode escrever um XMLTV à mão: basta um channel e seus programme, com o fuso horário certo e o arquivo em UTF-8. Para ligá-lo ao seu canal, use o mesmo identificador no tvg-id da sua lista M3U ou no epgId da sua W3U; os dois formatos estão explicados em M3U, M3U8 e W3U.