EPG não funciona na IPTV: como diagnosticar e resolver

Um EPG vazio, incompleto ou defasado quase nunca indica problema na conta de IPTV: em geral, há uma configuração incorreta no aplicativo ou na fonte do EPG que impede a exibição. Este guia reúne as quatro verificações que resolvem a grande maioria dos casos e complementa a nossa visão geral do EPG.

Primeiro, qual é o sintoma exato?

Antes de resolver, identifique exatamente o que está errado, porque a causa muda conforme o sintoma:

O EPG não aparece em nenhum canal: na maioria dos casos, falta o URL do EPG, o endereço está errado ou o aplicativo não carrega esse tipo de dados (veja abaixo o caso do VLC).
O EPG está vazio só em alguns canais: quase sempre é um problema de mapeamento entre o nome do canal e o respectivo identificador no EPG.
O EPG aparece, mas os horários estão defasados: a causa costuma ser a configuração do fuso horário no aplicativo, não os dados em si.
A programação aparecia no EPG, mas sumiu: é comum ter havido uma atualização interrompida ou o URL do EPG ter ficado inválido no meio do caminho.

1º O URL do EPG está correto?

Abra as configurações do EPG no aplicativo (o nome varia: "URL do EPG", "Fonte XMLTV" ou uma opção integrada direto no perfil Xtream Codes).
Confirme se o endereço está completo e sem espaços ou caracteres faltando no início ou no fim do campo.
Numa configuração M3U, o EPG costuma exigir um URL diferente do endereço do próprio fluxo: confirme que você não trocou os dois endereços.
Com Xtream Codes, o EPG geralmente vem automático com a conta; se não aparecer, recrie o perfil em vez de procurar um URL de EPG manual.
Salve e force uma atualização manual do EPG nas configurações do aplicativo.

2º O fuso horário está certo?

Um fuso horário mal configurado no aplicativo é a causa mais comum quando o EPG mostra os programas certos na hora errada:

Abra as configurações gerais do aplicativo, não só as do EPG, e procure a opção de fuso horário ou de defasagem UTC.
Selecione o seu fuso horário real, em vez de manter uma configuração automática que pode detectar a localização errado.
Reinicie o aplicativo depois da mudança: a defasagem nem sempre é corrigida em tempo real.

Essa configuração afeta só a exibição da grade, nunca a reprodução do vídeo. Se a imagem e o som também estiverem fora de sincronia, consulte o nosso guia sobre atraso de áudio na IPTV.

3º O aplicativo suporta o formato XMLTV?

A maioria dos aplicativos de IPTV usa um formato padronizado próximo do XMLTV, criado em 2002 para descrever grades de programação de TV de forma estruturada. Se o EPG continuar vazio mesmo com o URL correto:

Verifique se o aplicativo usado suporta o formato XMLTV e não só um formato proprietário.
Teste o mesmo URL do EPG em outro aplicativo compatível para isolar se o problema está no aplicativo ou na fonte de dados.
Se o aplicativo mostrar um erro de carregamento em vez de um EPG vazio, o arquivo pode estar temporariamente fora do ar: tente de novo depois de alguns minutos.

4º O mapeamento do canal está certo?

O mapeamento associa o nome de um canal, como aparece na lista, ao identificador usado nos dados do EPG. Se a grade estiver vazia só em alguns canais e funcionar bem nos demais, a causa quase sempre está nessa associação:

Abra o canal em questão e procure uma opção de mapeamento de EPG manual (geralmente acessível segurando o canal selecionado ou num menu de edição de lista).
Encontre o identificador correspondente na lista oferecida pelo aplicativo e associe manualmente.
Atualize o EPG após cada correção para ver se a grade aparece.

Aplicativos como o TiviMate e o IPTV Smarters Pro permitem fazer esse ajuste manual. O nosso guia completo do TiviMate mostra exatamente onde encontrar a opção.

Solução de problemas

O EPG continua vazio depois de todas essas verificações: apague e recrie o perfil Xtream Codes ou a fonte M3U/EPG no aplicativo, obrigando-o a recarregar todos os dados.
O EPG funcionava e parou sem a configuração ter sido alterada: inicie uma atualização manual antes de reconfigurar tudo; a interrupção pode ser temporária.
Só o VLC não mostra o EPG: não há o que corrigir. O VLC não foi feito para criar uma interface de EPG a partir de dados XMLTV, seja qual for a configuração.

Em resumo

Um EPG que não funciona quase sempre se resolve verificando, na ordem, o URL do EPG, o fuso horário do aplicativo, a compatibilidade com o formato XMLTV e o mapeamento dos canais. Se nada resolver, recriar o perfil obriga o aplicativo a recarregar todos os dados. Para uma visão mais geral do funcionamento do EPG, consulte o nosso guia do EPG para IPTV.

Perguntas frequentes

Por que o EPG mostra "sem dados" só em alguns canais?

Esse é o sinal mais comum de um problema de mapeamento: o aplicativo não associa o nome exato do canal ao identificador usado no arquivo de dados do EPG. Os demais canais, associados corretamente, seguem mostrando a grade normal.

Preciso reiniciar o aplicativo depois de corrigir o URL do EPG?

Sim. Na maioria dos aplicativos, um novo URL do EPG só é aplicado depois de reiniciar o aplicativo ou atualizar os dados manualmente nas configurações; a mudança não aparece sozinha na tela seguinte.

A diferença de horário do EPG também afeta a imagem e o som?

Não. Uma defasagem do EPG afeta só os horários mostrados na grade, não a reprodução do vídeo. Se a imagem e o som também estiverem fora de sincronia, é outro problema, tratado no nosso artigo sobre atraso de áudio na IPTV.

Por que o VLC nunca mostra um EPG, mesmo com um URL válido?

O VLC é um reprodutor de mídia genérico, não um aplicativo de IPTV completo: ele abre um fluxo a partir de um endereço, mas não cria uma interface de EPG estruturada a partir de dados XMLTV. Não é um problema de configuração, e sim uma limitação desse reprodutor.

Quanto tempo depois de uma atualização o EPG deve reaparecer?

Depende do tamanho do arquivo de dados e da conexão, mas a atualização costuma ser rápida. Se o EPG continuar vazio vários minutos depois de uma atualização manual, confira o URL de novo antes de repetir o processo.

Apagar e adicionar a conta de novo pode resolver um EPG travado?

Sim, essa é uma solução eficaz quando a atualização manual não basta, sobretudo com Xtream Codes: recriar o perfil obriga o aplicativo a baixar tudo de novo, inclusive o EPG.