EPG · XMLTV

O que é o EPG?

O EPG, guia eletrónico de programação, é a lista do que dá em cada canal e quando. Em IPTV chega quase sempre como um ficheiro XMLTV: um documento com o seu próprio endereço, que um player transfere e apresenta como guia.

O Lumen·TV é um player IPTV para Android TV, Google TV, Fire TV e telemóveis e tablets Android. Precisa do Android 8.0 ou posterior. Reproduz a lista M3U ou Xtream Codes que já tem e não inclui canais. 21 dias grátis e depois 0,99 € por mês para um dispositivo, ou 19,99 € uma só vez para 2 dispositivos, ou 29,99 € uma só vez para 5. O teste não pede cartão e termina sozinho.

Atualizado a 28 de outubro de 2026

O que um ficheiro XMLTV contém.

Dois tipos de entrada. Um <channel> para cada canal abrangido pelo guia, com um id e um nome; e um <programme> para cada programa, que indica o seu canal por esse id, com um início, um fim, um título e muitas vezes uma descrição.

<tv>
  <channel id="news24.example">
    <display-name>News 24</display-name>
  </channel>
  <programme channel="news24.example" start="20261021190000 +0200" stop="20261021200000 +0200">
    <title>Evening bulletin</title>
    <desc>Headlines, weather, sport.</desc>
  </programme>
</tv>

Um canal e um dos seus programas. Cada hora traz o seu próprio desfasamento em relação a UTC, aqui duas horas a mais.

O tamanho: Uma semana de programas para uma lista grande chega a muitos megabytes, por isso os guias são muitas vezes publicados comprimidos, como .xml.gz.
Até quando: Até onde quem o publica o preencher: alguns dias, uma semana, por vezes mais.

Como um guia encontra os seus canais: tvg-id.

O guia e a lista são ficheiros separados, muitas vezes de origens diferentes, e há uma única coisa que os liga: o tvg-id na linha de um canal da lista M3U tem de ser exatamente o id de um canal do guia. tvg-id="news24.example" encontra os programas de channel="news24.example"; tvg-id="News24" não encontra nenhum.

Por isso, quando um guia carrega mas não mostra nada para os seus canais, o motivo habitual é que os dois ficheiros dão nomes diferentes aos canais, e só quem os publica os pode pôr de acordo. Um servidor Xtream Codes publica a lista de canais e o guia em conjunto, e é por isso que os dois normalmente coincidem.

De onde vem o endereço do guia.

Com um acesso Xtream Codes: O servidor publica o guia em xmltv.php, aberto com o mesmo utilizador e a mesma palavra-passe, por isso um player consegue encontrá-lo sozinho. Veja o que é o Xtream Codes.
Com uma lista M3U: O guia é um segundo endereço, que os fornecedores costumam publicar ao lado da ligação da lista. Alguns escrevem-no na primeira linha da lista, como url-tvg; se um player o lê daí depende do player.
De outro sítio: Serve qualquer endereço XMLTV, desde que os seus ids correspondam aos da lista.

O que o Lumen·TV faz com um guia.

Um guia por lista, desenhado como uma grelha que percorre meia hora ou um dia de cada vez, e como agora e a seguir sobre a imagem.
Tantos dias quantos o seu fornecedor publicar, até sete.
Um acesso Xtream Codes, ou uma ligação get.php, encontra o seu guia sozinho. Uma M3U simples precisa que o endereço do guia seja indicado à parte: o Lumen·TV não lê um endereço escrito dentro da lista. Adicionar um guia, passo a passo.
Associa os programas aos canais apenas pelo tvg-id, e lê um guia publicado comprimido (.xml.gz) tal como um não comprimido.
Diz porque é que um guia está vazio: sem endereço, um endereço sem programas, canais sem tvg-id, ids que não correspondem a nada, ou um guia que o fornecedor deixou de atualizar.
Vários guias juntos num só, um desfasamento horário do guia e lembretes não fazem parte da aplicação.