EPG no IPTV: o que é, como carregar e como corrigir o guia de programação

EPG é a sigla de Electronic Program Guide, o guia eletrônico de programação. É aquela grade que aparece quando você aperta o botão de guia no controle: o que está passando agora, o que vem a seguir, horário de início e fim de cada programa. No IPTV, o EPG não vem “junto do sinal” como na TV tradicional. Ele é um arquivo separado que o player baixa e cruza com a sua lista de canais. Entender isso é o que permite corrigir o guia quando ele aparece errado.

Como o EPG funciona no IPTV

O seu acesso IPTV tem duas partes independentes:

• A lista de canais, que diz ao player onde buscar o vídeo de cada canal. Ela pode ser um link M3U ou um login Xtream Codes. A página sobre lista IPTV explica os dois formatos.
• O arquivo de EPG, que traz a programação de cada canal em um formato chamado XMLTV.

O player junta as duas coisas usando um identificador em comum. Se o identificador bate, a programação aparece. Se não bate, o canal funciona normalmente, mas o guia fica vazio.

O formato XMLTV por dentro

XMLTV é um padrão aberto, em XML, usado pela maioria dos players. Um trecho simplificado se parece com isto:

<tv>
  <channel id="canal-exemplo.br">
    <display-name>Canal Exemplo</display-name>
  </channel>
  <programme start="20260924200000 -0300" stop="20260924210000 -0300" channel="canal-exemplo.br">
    <title>Jornal da Noite</title>
  </programme>
</tv>

Três detalhes importam:

1. O id do canal (canal-exemplo.br) precisa ser igual ao tvg-id do mesmo canal na lista M3U.
2. O horário vem no formato ano-mês-dia-hora-minuto-segundo, seguido do deslocamento em relação ao UTC. -0300 é o horário de Brasília.
3. O arquivo pode vir compactado como .xml.gz, o que é normal e mais leve.

Na lista M3U, a linha de cada canal traz o identificador assim: #EXTINF:-1 tvg-id="canal-exemplo.br" tvg-name="Canal Exemplo",Canal Exemplo. É essa correspondência que faz a mágica acontecer.

Como carregar o EPG no player

Se você usa login Xtream Codes

É o cenário mais simples. Players como IPTV Smarters Pro, XCIPTV, TiviMate e IBO Player baixam o EPG automaticamente a partir do mesmo servidor do login. Normalmente basta entrar com usuário, senha e URL e esperar a primeira atualização. Se o guia não aparecer, procure a opção “Atualizar EPG” ou “Refresh EPG” no menu.

Se você usa link M3U

Aqui o player pode pedir uma fonte de EPG separada. No TiviMate, por exemplo, o caminho é Configurações, Playlists ou EPG, Adicionar fonte, e então colar o link XMLTV. No IPTV Smarters, a opção fica nas configurações da lista. Peça o link de EPG ao atendimento pelo WhatsApp se ele não veio junto dos dados de acesso.

Em Smart TVs Samsung (Tizen) e LG (webOS), o carregamento costuma ser feito pelo painel web do próprio app, onde você cadastra a lista e o EPG vinculando ao endereço MAC da TV. O guia de aplicativos IPTV mostra qual player funciona melhor em cada sistema.

Por que o EPG fica errado

1. Fuso horário

É a causa número um. Se a grade está exatamente uma, duas ou três horas adiantada ou atrasada, o problema é fuso. Isso acontece quando:

• o aparelho está com fuso errado ou em “automático” sem sincronizar corretamente;
• o arquivo XMLTV foi gerado com horário UTC e o player não converte;
• você mora em um estado com fuso diferente do de Brasília, como no Amazonas, no Acre ou em Fernando de Noronha.

Vale lembrar que o Brasil não adota horário de verão desde 2019. Configurações antigas que ainda aplicam essa regra deslocam a grade em uma hora.

2. ID de canal diferente

Se o horário está certo, mas alguns canais aparecem sem programação, o tvg-id da lista não corresponde a nenhum id do XMLTV. Pode ser uma letra diferente, um sufixo como .br a mais ou a menos, ou um canal novo que ainda não foi mapeado.

3. Guia vencido

Se o guia mostra a programação de ontem ou fica vazio depois de alguns dias, o player não está atualizando o arquivo. O XMLTV cobre um período limitado à frente e precisa ser baixado de novo periodicamente.

4. Cache corrompido

Às vezes uma atualização interrompida deixa o guia pela metade. Limpar o cache do app resolve.

Como corrigir, caso a caso

Sintoma	Causa provável	Correção
Grade adiantada ou atrasada em horas inteiras	Fuso horário	Acerte o fuso do aparelho e ajuste o deslocamento do EPG no player (por exemplo, -1 h ou +1 h)
Alguns canais sem programação	tvg-id não corresponde	Use “vincular EPG” manualmente ou peça ao suporte o mapeamento
Guia vazio após alguns dias	Atualização desligada	Ative a atualização automática a cada 12 ou 24 h
Guia pela metade ou com erro	Cache corrompido	Limpe o cache do app e atualize o EPG
Nenhum canal com guia	Fonte de EPG ausente ou link errado	Confira o link XMLTV e adicione novamente

No TiviMate, o ajuste de fuso fica em Configurações, EPG, “Deslocamento de horário do EPG”. No XCIPTV e no IPTV Smarters, procure por “Time shift” ou “EPG timeshift” nas configurações. Ajuste em passos de uma hora e confira contra um programa cujo horário você conhece.

EPG e recursos extras

Com o guia funcionando, alguns players liberam recursos úteis: lembretes de programa, busca na grade por nome e, quando o servidor oferece, catch-up, que permite voltar programas já exibidos. Para quem assiste esporte, o guia também ajuda a achar rapidamente onde está o jogo, assunto do post sobre IPTV para futebol ao vivo.

Se o problema não é o guia, e sim a imagem que congela, o caminho é outro: veja IPTV travando: como resolver. E para conhecer as categorias da grade antes de assinar, confira os canais IPTV e faça o teste IPTV grátis de 6 horas para ver o EPG funcionando no seu aparelho.