O que é EPG? O Guia de TV IPTV Explicado (XMLTV, Agora/Próximo, e Como Funciona Tudo)

Quando você abre um reprodutor IPTV e vê não apenas uma lista de nomes de canais, mas uma grade completa — "BBC One: Notícias às 22h até 22:30, depois Match of the Day" — você está olhando para o EPG: o Guia Eletrônico de Programação. É a diferença entre um reprodutor que parece uma pilha de URLs e outro que parece uma televisão.

EPG é também uma das partes mais incompreendidas do IPTV. As pessoas assumem que vem do mesmo lugar que os canais (não vem), que é trabalho do reprodutor gerá-lo (não é), e que um guia em branco significa que o aplicativo está quebrado (geralmente não está). Este post é o explicador em inglês simples — o acompanhamento educacional do nosso guia de solução de problemas EPG, e um irmão de what is Stalker Portal and M3U vs Xtream vs Stalker.

EPG em Uma Frase

EPG é um arquivo de dados separado que lista o que está sendo transmitido em cada canal e quando, que seu reprodutor sobrepõe à sua lista de canais para construir o guia de TV.

Esse é todo o conceito. Os canais são uma coisa (sua playlist M3U ou conta Xtream). O cronograma é uma coisa diferente (um arquivo EPG). O trabalho do reprodutor é correspondê-los.

De Onde os Dados EPG Realmente Vêm

O formato padrão para dados EPG é XMLTV — um arquivo XML (frequentemente comprimido com gzip, terminando em .xml ou .xml.gz) que contém dois tipos de entradas:

1. Definições de canal — cada canal que o guia conhece, com um ID único como bbc-one.uk ou ESPN.us.
2. Entradas de programa — para cada ID de canal, uma lista de programas com hora de início, hora de término, título, e geralmente uma descrição, categoria e informações do episódio.

Uma entrada de programa único se parece mais ou menos assim dentro do XML:

<programme start="20260611190000 +0000" stop="20260611210000 +0000" channel="bbc-one.uk">
  <title>FIFA World Cup 2026: Opening Match</title>
  <desc>Live coverage of the tournament opener.</desc>
  <category>Sport</category>
</programme>

De onde vem esse arquivo? Um de dois lugares, dependendo do tipo de provedor:

• Provedores Xtream Codes publicam seu próprio EPG automaticamente. Sua conta tem um endpoint EPG integrado (a URL xmltv.php), e um bom reprodutor descobre e busca isso para você sem você fazer nada. Este é o caso fácil.
• Provedores M3U simples podem lhe dar uma URL XMLTV separada para colar, ou nenhuma. Se te derem uma URL, você a cola no reprodutor uma vez. Se não derem, você pode usar uma fonte XMLTV de terceiros — mas correspondê-la aos seus canais é mais difícil (mais sobre isso abaixo).

A coisa fundamental a entender: o EPG é publicado pelo seu provedor (ou por terceiros), não gerado pelo reprodutor. Se seu provedor não publica dados de guia, nenhum reprodutor na terra pode inventá-lo.

Como o Reprodutor Corresponde Canais às Suas Listagens

É aqui que vive a maior parte da confusão EPG. O reprodutor tem dois conjuntos de dados separados — sua lista de canais e o guia XMLTV — e ele tem que descobrir quais entradas de programa pertencem a qual canal. Faz isso correspondendo a um identificador.

Em sua playlist M3U, cada linha de canal geralmente carrega um atributo tvg-id:

#EXTINF:-1 tvg-id="bbc-one.uk" tvg-name="BBC One HD" group-title="UK",BBC One HD

O reprodutor olha para tvg-id="bbc-one.uk", depois procura no arquivo XMLTV por uma <channel id="bbc-one.uk"> e todas as entradas <programme channel="bbc-one.uk">. Quando os IDs correspondem, as listagens se encaixam no canal. Quando não correspondem — ou quando tvg-id está faltando — o canal aparece com nenhum dado de guia, mesmo que o arquivo EPG esteja carregado corretamente e outros canais estejam preenchidos.

Essa falta de correspondência é a reclamação mais comum EPG, e é quase sempre um problema de dados no provedor, não um bug no reprodutor:

• O M3U tem tvg-id="bbcone" mas o XMLTV usa bbc-one.uk → sem correspondência.
• O M3U não tem tvg-id nenhum → nada para corresponder.
• O M3U e XMLTV do provedor são mantidos por pessoas diferentes que nunca concordaram com os IDs.

"Agora / Próximo" vs a Grade Completa

Dados EPG alimentam duas visualizações que você verá em qualquer bom reprodutor:

• Agora / Próximo — a forma compacta. Enquanto você está assistindo um canal, o reprodutor mostra o programa atual e o que vem a seguir, geralmente com uma barra de progresso mostrando o quanto do programa atual você assistiu. Este é o recurso EPG mais usado; é o que lhe diz "você entrou neste jogo no 60º minuto."
• O Guia / Grade — a visualização bidimensional completa. Canais em um eixo, tempo no outro, cada célula um bloco de programa. É assim que você navega "o que está passando hoje à noite" e planeja sua noite.

Ambos são construídos a partir dos mesmos dados XMLTV. A grade apenas mostra mais deles de uma vez.

Fusos Horários: Por Que Seu Guia Pode Estar Desalinhado por Algumas Horas

Um problema sutil mas comum: os tempos XMLTV incluem um deslocamento UTC (o +0000 no exemplo acima). Seu reprodutor os converte para sua hora local. Quando o guia mostra programas na hora errada — tudo deslocado por 1, 5 ou 8 horas — é quase sempre um de:

• O provedor publicou os tempos com o deslocamento errado (por exemplo, marcou tudo com +0000 quando o cronograma é na verdade hora local do Reino Unido durante o Horário de Verão Britânico).
• O fuso horário do seu dispositivo está configurado incorretamente.
• O EPG do provedor é para uma região diferente da que você está assistindo.

Um bom reprodutor permite que você aplique um deslocamento de tempo EPG manual por playlist para corrigir um guia consistentemente deslocado. Se apenas alguns canais forem deslocados, esse é o provedor misturando feeds regionais, e um deslocamento global não o corrigirá completamente.

Como EPG Alimenta Lembretes e Reprises

EPG não é apenas para navegar. Dois recursos dependem disso:

• Lembretes de programa. Porque o guia sabe que um programa começa às 19:00, o reprodutor pode notificá-lo pouco antes de começar. Defina um lembrete em um programa futuro na grade e o reprodutor o avisa quando está prestes a começar.
• Reprises / mudança de tempo. A reprisa do lado do provedor usa EPG para conhecer os limites de cada programa passado, então "retroceder para o início das notícias das 18:00" funciona. Sem um EPG preciso, a reprisa não consegue encontrar os limites do programa. Veja nosso explicador de TV de reprisa.

Então um EPG preciso é essencial para mais do que apenas a grade bonita — é a espinha dorsal de lembretes e retrocesso.

Como Tuneline Manipula EPG

Em Tuneline, o fluxo é projetado para precisar de o mínimo de trabalho manual possível:

• Contas Xtream Codes: EPG é descoberto automaticamente e buscado na primeira sincronização. Você não faz nada — abra o guia e está lá (assumindo que o provedor o publica).
• Playlists M3U: se seu provedor lhe deu uma URL XMLTV, cole-a ao adicionar a playlist. Tuneline busca e a coloca em cache, atualizando periodicamente.
• Correspondência: Tuneline corresponde primeiro em tvg-id, depois recua para correspondência fuzzy de nomes para canais onde tvg-id está faltando mas o nome do canal corresponde aproximadamente a um nome de canal XMLTV. Isso recupera alguns dados de guia que reprodutores somente com ID estrito deixariam em branco.
• Deslocamento de tempo: Configurações → EPG → Deslocamento de Tempo permite que você ajuste um guia consistentemente deslocado de volta ao alinhamento por playlist.
• Atualização: o guia armazena em cache localmente e se atualiza em um cronograma para que abrir a grade seja instantâneo em vez de esperar por uma busca de rede toda vez.

Se seu guia estiver em branco ou parcial, o guia de solução de problemas EPG orienta os cortes em ordem.

Perguntas Frequentes

O que é EPG na TV?

EPG significa Guia Eletrônico de Programação — o cronograma na tela mostrando o que está passando agora e o que vem a seguir. O conceito é idêntico em qualquer televisão; apenas a entrega muda. Na TV a cabo, satélite e terrestre, o guia é transportado dentro do próprio sinal de transmissão, então está simplesmente sempre lá. No IPTV não há sinal de transmissão para carregá-lo, então o guia é um arquivo XMLTV separado que seu reprodutor busca e corresponde aos seus canais.

Essa diferença explica a reclamação mais comum sobre IPTV: um guia que está em branco enquanto os canais funcionam perfeitamente. Em uma caixa de cabo essa combinação é impossível. No IPTV significa apenas que o arquivo de cronograma está faltando ou seus IDs de canal não correspondem.

EPG é o mesmo que os canais?

Não. Os canais vêm da sua M3U playlist ou conta Xtream. EPG (o guia) é um arquivo XMLTV separado. Eles são combinados pelo reprodutor. Um provedor pode te dar ótimos canais e nenhum EPG, ou vice-versa.

Por que alguns dos meus canais têm guia e outros ficam em branco?

Porque os em branco têm um tvg-id que não corresponde a nada no arquivo XMLTV (ou nenhum tvg-id). O EPG é carregado perfeitamente — ele simplesmente não tem nada para vincular a esses canais específicos. Este é um problema de dados do provedor, não um bug do reprodutor.

Posso adicionar minha própria fonte EPG se meu provedor não tiver uma?

Sim — você pode colar uma URL XMLTV de terceiros. O problema é que uma fonte EPG genérica usa seus próprios IDs de canal, que não corresponderão aos valores tvg-id do seu provedor, então a maioria dos canais permanecerá em branco a menos que os IDs coincidam. Funciona melhor para canais conhecidos com IDs padronizados.

Com que frequência o EPG é atualizado?

Os provedores normalmente publicam uma janela contínua — frequentemente "agora mais os próximos 3–7 dias". Os reprodutores fazem cache e buscam novamente em uma programação (Tuneline atualiza periodicamente e no puxar para atualizar manual). Além da janela publicada, a grade simplesmente não tem dados ainda.

Meu guia inteiro está deslocado por algumas horas. Como faço para corrigir?

Aplique um deslocamento de hora EPG (Configurações → EPG → Deslocamento de Hora em Tuneline) para deslocá-lo para trás. Primeiro, confirme se o fuso horário do seu dispositivo está correto. Se apenas alguns canais estiverem desalinhados, o provedor está misturando feeds regionais e um deslocamento global não corrigirá todos eles.

O EPG usa muitos dados?

Não. Um arquivo XMLTV para alguns centenas de canais com uma semana de programação é normalmente alguns MB comprimidos — trivial em comparação com um único minuto de vídeo. É a parte mais barata do IPTV de longe.

Por que o guia fica em branco logo quando adiciono uma nova playlist?

A primeira busca de EPG acontece em segundo plano e pode levar alguns segundos a um minuto para guias grandes. Aguarde um momento e depois puxe para atualizar. Se ainda estiver em branco após um minuto, consulte o guia de resolução de problemas.

Qual é a diferença entre EPG e XMLTV?

EPG é o conceito (o guia de programas na tela). XMLTV é o formato de arquivo que carrega os dados. As pessoas usam os termos livremente — "meu EPG" geralmente significa "meu arquivo XMLTV". Também existe um EPG baseado em JSON que alguns painéis Xtream servem, mas XMLTV é o padrão universal.

---

A Conclusão

EPG transforma uma lista de canais em uma televisão. É um arquivo XMLTV separado — publicado pelo seu provedor, não gerado pelo reprodutor — que o reprodutor combina aos seus canais usando o campo tvg-id, então exibe como Agora/Próximo e uma grade completa. Quando as listagens estão faltando ou erradas, a causa é quase sempre os dados do provedor (IDs incompatíveis, IDs ausentes, fuso horário errado), não o app.

Tuneline detecta automaticamente EPG para contas Xtream, aceita uma URL XMLTV para playlists M3U, faz correspondência em tvg-id com fallback baseado em nome, e permite corrigir um guia deslocado com um deslocamento de hora por playlist — portanto, o guia é tão completo quanto os dados do seu provedor permitem.