EPG Não Carrega? Guia Completo para Corrigir Seu Guia de TV IPTV em 2026

Você configurou seu player IPTV. Os canais carregam. Você pode alternar entre eles. Tudo parece ótimo — até você abrir o guia de TV e encontrar nada além de um mar de células vazias. Ou pior: células com programas errados nelas, listando programas que terminaram cinco anos atrás.

Problemas de EPG são a segunda reclamação mais reportada sobre IPTV depois de buffering, e a coisa frustrante é que os sintomas parecem idênticos independentemente da causa. Este guia aborda os cinco problemas reais por trás de EPGs quebrados, na ordem em que valem a pena verificar.

O que EPG Realmente É

EPG significa Guia de Programas Eletrônico. São os metadados que dizem ao seu player IPTV o que está sendo exibido atualmente em cada canal, o que vem a seguir e quais são as descrições dos programas. Não há magia nisso — seu player baixa um arquivo ou consulta uma API, extrai títulos e horários dos programas e os renderiza em uma grade ao lado de seus canais.

O formato padrão é XMLTV: um arquivo XML único listando cada canal, cada programa, cada horário de início, cada duração e opcionalmente pôsteres e descrições. Um arquivo XMLTV típico para um grande provedor pode ter 50–500 MB descompactado e conter centenas de milhares de entradas de programa.

A razão pela qual EPG quebra tão frequentemente é que este arquivo precisa:

1. Baixar com sucesso do seu provedor.
2. Descompactar corretamente (a maioria está compactada com gzip).
3. Analisar sem erros.
4. Corresponder aos IDs de canal em sua playlist — é aqui que a maioria das falhas acontece.
5. Ser exibido na grade do seu player sem expirar o tempo limite.

Uma falha em qualquer uma dessas cinco etapas resulta em um guia de TV vazio. Vamos examiná-las.

Um bug que enviei e depois descobri por conta própria (para que você possa identificá-lo em seu próprio player): uma compilação anterior de Tuneline mantinha o EPG analisado na memória e não o invalidava quando o usuário alternava entre fontes Xtream. Sintoma: o guia parecia completo, mas os títulos dos programas eram do canal do provedor anterior. Se você reinstalar ou forçar uma atualização e o guia correto aparecer, esse é este tipo de bug — e é surpreendentemente comum em players que fazem cache agressivamente sem escopo do cache por fonte.

---

Causa 1: Sua URL EPG está desatualizada ou faltando

Esta é a causa mais comum e a mais simples de corrigir. Se você está usando uma playlist M3U, seu EPG vem de uma URL XMLTV separada que você tem que inserir manualmente em seu player. Muitos usuários:

• Nunca inseriram uma URL EPG (o M3U tem canais mas nenhuma fonte de guia).
• Inseriram uma URL EPG meses atrás que desde então ficou offline.
• Inseriram a URL errada — um guia para a lista de canais de um provedor diferente.

Como corrigir

Encontre a página de documentação do seu provedor. Quase todo provedor IPTV pago publica uma URL M3U e uma URL XMLTV. Eles geralmente se parecem com:

http://your-provider.example/xmltv.php?username=USER&password=PASS

Ou:

http://your-provider.example/epg.xml.gz

Cole isso nas configurações EPG do seu player, force uma atualização e veja o guia ser preenchido. Em Tuneline, isto é Configurações → EPG → URL XMLTV, com um botão de atualização logo ao lado, e o guia geralmente é preenchido em segundos após uma atualização.

Se você está usando Xtream Codes, você geralmente não precisa definir uma URL EPG — o EPG vem através da mesma API dos canais. Se seu guia está vazio no Xtream, vá para Causa 3.

---

Causa 2: O EPG foi baixado mas os IDs do canal não correspondem

Esta é a falha EPG mais frustrante porque parece que o EPG funcionou — seu player diz que carregou com sucesso — mas a grade ainda está vazia.

O que aconteceu: seu arquivo XMLTV tem milhares de canais, cada um identificado por um tvg-id como news.us ou sport.de. Sua playlist M3U tem seus próprios valores tvg-id. Se os IDs não corresponderem, o player não pode vincular um programa ao seu canal. Você acaba com um EPG totalmente carregado que é inútil porque nada se conecta.

Como identificar

Procure a entrada de um canal em seu arquivo M3U. A linha será parecida com:

#EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-logo="...",CNN

Agora procure em seu arquivo XMLTV (a maioria dos provedores deixa você baixá-lo diretamente). Procure pelo ID do canal. Existe uma entrada <channel id="cnn.us"> correspondente? Se não — ou se os IDs forem ligeiramente diferentes (por exemplo, CNN.us vs cnn.us) — esse é seu problema.

Como corrigir

Algumas opções, dependendo de seu player:

• Melhor solução: Use um player que faça correspondência difusa — ou seja, retorna ao emparelhamento de canais por nome normalizado quando o tvg-id está faltando ou mal-caixo. O matcher de Tuneline converte ambos os lados para minúsculas, remove sufixos comuns como "HD"/"FHD"/"4K" e códigos de região à direita, e recolhe espaços em branco antes de comparar. Não é perfeito (dois canais genuinamente nomeados da mesma forma colidirão), mas resgata 70–80% das playlists onde os IDs do provedor são apenas desleixados.
• Solução manual: Edite seu arquivo M3U e altere os valores tvg-id para corresponder ao arquivo XMLTV. Isto é tedioso mas funciona.
• Solução do provedor: Envie um e-mail para seu provedor IPTV e diga-lhe que seus IDs M3U e IDs XMLTV não correspondem. Surpreendentemente, frequentemente eles regenerarão o arquivo — eles recebem essa reclamação constantemente.

---

Causa 3: O servidor EPG do seu provedor é lento ou tem limitação de taxa

Arquivos XMLTV grandes levam tempo real para baixar. Se o servidor EPG do seu provedor estiver sobrecarregado (muito comum durante horários de pico), seu player pode expirar antes de terminar o download. Alguns provedores também limitam a taxa de downloads de EPG — se você atualizou o EPG cinco vezes na última hora, a próxima solicitação pode ser silenciosamente descartada.

Sintomas

• EPG carrega às vezes mas nem sempre.
• A primeira atualização após a instalação funciona, depois atualizações subsequentes retornam vazias.
• EPG funciona às 3 da manhã mas falha às 8 da noite.

Como corrigir

• Aumente o tempo limite de EPG no seu player. A maioria dos players usa 30 segundos como padrão. Aumente para 120.
• Atualize o EPG com menos frequência. Uma vez a cada 12 ou 24 horas é suficiente para dados de programação ao vivo.
• Use a versão compactada com gzip. Se seu provedor expõe epg.xml e epg.xml.gz, sempre use a URL compactada com gzip — geralmente é 5–10× menor.
• Se o provedor limitar a taxa, espere uma hora. Então atualize e não atualize novamente por um dia.

---

Causa 4: Seu arquivo XMLTV está corrompido

Algumas exportações XMLTV de provedores incluem entradas malformadas — formatos de data inválidos, caracteres UTF-8 quebrados, tags não fechadas. Um analisador XML rígido se recusará a carregar o arquivo inteiro por causa de uma única entrada quebrada, deixando você com um EPG vazio.

Como identificar

Se os logs do seu player (todo player sério tem) mostrarem erros como "Erro de análise XML na linha 47291" ou "fim de entrada inesperado", você encontrou um arquivo corrompido.

Como corrigir

Você geralmente tem três opções:

• Use um player mais tolerante. Alguns players (Tuneline incluído) são configurados para pular entradas malformadas e carregar o resto. Players rígidos desistem do arquivo inteiro.
• Use uma fonte EPG diferente. Muitos agregadores EPG públicos gratuitos republicam dados de provedores com formatação mais limpa. Tenha cuidado com os termos de licença.
• Relate o arquivo ruim ao seu provedor. Eles geralmente podem consertá-lo em um dia.

---

Causa 5: Seu player é simplesmente ruim em renderizar EPGs grandes

Alguns players afirmam apoiar EPG mas se engasgam quando a grade tem mais de algumas centenas de canais. Os dados estão lá, a análise foi bem-sucedida, mas a interface congela ou mostra células vazias porque renderizar milhares de entradas de programa simultaneamente é muito lento.

Sintomas

• Rolar o EPG é lento.
• As células aparecem e desaparecem enquanto você rola.
• Os primeiros 50 canais mostram programas mas qualquer coisa abaixo disso está vazia.

Como corrigir

Esta é uma limitação do player. As soluções são:

• Use um player com renderização EPG virtualizada. Os players modernos só renderizam as células que você realmente consegue ver, então um guia com 5.000 canais rola tão rápido quanto um guia com 50 canais. A grade EPG do Tuneline é virtualizada e testada em playlists com mais de 10.000 canais — guias grandes não devem ser uma razão para sua experiência de TV ficar lenta.
• Filtre sua lista de canais. Se você só assiste a 30 canais regularmente, esconda tudo o resto. O EPG renderiza muito mais rápido em uma lista menor.
• Mude de player. Essa é frequentemente a resposta correta se você está lutando com EPG há meses.

---

Uma Ordem Diagnóstica que Economiza Tempo

Quando alguém nos pergunta "por que meu EPG não está carregando?", guiamos através disso em ordem:

1. Há uma URL EPG configurada? (Se em M3U.) A maioria dos usuários pulou este passo.
2. A URL ainda funciona? Abra-a em um navegador — você deve ver XML ou obter um download.
3. Os IDs de canal em M3U correspondem aos IDs em XMLTV? Escolha um canal e verifique manualmente.
4. O servidor EPG do seu provedor está responsivo agora? Tente atualizar em um horário diferente do dia.
5. O arquivo XMLTV é analisado corretamente? Verifique os logs do player para erros de análise.
6. Seu player consegue lidar com o tamanho deste guia? Tente um subconjunto menor.

Se você trabalhar sistematicamente através desses passos, encontrará a causa todas as vezes.

---

O Que "Um Bom EPG" Realmente Parece

Aqui está o padrão que você deve exigir de seu player IPTV:

• Primeira carga < em 60 segundos para um guia de 200 MB em Wi-Fi.
• Atualização em segundo plano que não interrompe a reprodução.
• Correspondência fuzzy de ID para que playlists ligeiramente incompatíveis ainda se vinculem.
• Barra Agora/Próximo mostrando o que está ao vivo agora e o que vem a seguir sem abrir a grade completa.
• Pesquise em EPG — encontre "que horas é o jogo?" sem rolagem.
• Lembretes — me alerte quando um programa específico está prestes a começar.
• Integração de catch-up — clicar em um programa que foi ao ar há 3 horas reproduz o catch-up se seu provedor suportar.

Se seu player atual não faz a maioria dessas coisas, isso não é normal. É um sinal de que seu player está atrás do estado da arte.

---

Perguntas Frequentes

Por que meu EPG mostra programas antigos de anos atrás?

Seu arquivo XMLTV está desatualizado. Seu player baixou um guia uma vez e não o atualizou desde então. Force uma atualização manual e verifique se a atualização automática está habilitada em um cronograma diário.

Por que o EPG funciona para alguns canais mas não para outros?

Quase sempre é um problema de correspondência de tvg-id (Causa 2). Os canais com EPG têm IDs que correspondem ao arquivo XMLTV; os canais sem não têm.

Existe uma fonte pública gratuita de EPG que eu possa usar?

Sim — projetos como iptv-org/epg mantêm XMLTV curadas pela comunidade para muitos países. A qualidade varia. Eles são melhores como um suplemento para EPG do seu provedor, não como uma substituição.

Tuneline tem melhor suporte a EPG do que players IPTV mais antigos?

Construímos suporte a EPG especificamente porque todos os outros players que testamos falharam em uma das cinco causas acima. Tuneline faz correspondência fuzzy de ID, renderização de grade virtualizada, atualização em segundo plano, pesquisa, lembretes e integração de catch-up onde suportado. Nada disso é mágica — é apenas o que um guia de TV deve fazer em 2026.

Com que frequência devo atualizar meu EPG?

Uma vez por dia é mais do que suficiente para dados de programação ao vivo. A maioria dos provedores atualiza seu XMLTV uma ou duas vezes por dia. Atualizar a cada 15 minutos não lhe dará dados mais novos — apenas sobrecarregará seu provedor e provavelmente resultará em limitação de taxa.

---

A Versão Curta

Os problemas de EPG parecem misteriosos, mas quase sempre são causados por um de cinco problemas correláveis: URL ausente, IDs de canal incompatíveis, provedor lento, arquivo corrompido ou renderização fraca do player. Passe por eles em ordem e você corrigirá o guia em menos de uma hora.

Se você está cansado de lutar contra as mesmas peculiaridades de EPG a cada poucas semanas, experimente Tuneline — correspondência fuzzy de ID, renderização virtualizada e atualização em segundo plano vêm como padrão. Seu guia deve funcionar.