Guia de Programação · 6 min de leitura · Atualizado em 2026-11-17

O que é EPG e como funciona o guia de programação

O EPG (Electronic Program Guide) é a grade eletrônica que mostra qual programa está passando agora e o que vem a seguir em cada canal ao vivo. Entenda como ele é sincronizado via XMLTV ou API Xtream e como o ZavoxPlayer processa esses dados sem travar o navegador.

Painel principal do ZavoxPlayer mostrando a seção TV com suporte a EPG
A seção TV do ZavoxPlayer organiza canais por pastas e exibe suporte ao guia de programação da sua lista.

O que significa EPG e para que ele serve na prática

EPG é a sigla para Electronic Program Guide, ou Guia Eletrônico de Programação em português. É o recurso equivalente à antiga revista impressa de programação ou à grade que aparece na tela de televisores tradicionais, mostrando o nome do programa que está sendo exibido no momento, horário de início, horário de término, progresso em percentual e o próximo programa da grade.

Em listas M3U e conexões Xtream Codes, o EPG não vem "dentro" do arquivo de vídeo em si. Ele trafega em paralelo como um arquivo de dados estruturados — na maioria absoluta das vezes no formato padrão aberto XMLTV (.xml ou .xml.gz) — onde cada emissora ou transmissão possui um identificador único chamado tvg-id ou channel id.

Quando o identificador tvg-id declarado na linha do canal na lista M3U coincide exatamente com o id presente no arquivo XMLTV do guia, o reprodutor consegue cruzar as duas informações e exibir a grade atualizada na tela do usuário.

Como o formato XMLTV funciona nos bastidores

Um arquivo XMLTV é essencialmente um catálogo textual estruturado com dois grandes blocos de informação. O primeiro bloco declara os canais conhecidos (<channel id="...">) com nomes de exibição e eventuais logotipos. O segundo bloco lista centenas ou milhares de blocos horários (<programme start="..." stop="..." channel="...">) contendo título, subtítulo e descrição de cada atração.

Como grades semanais completas de dezenas de canais podem gerar arquivos XML com dezenas de megabytes, processá-los na thread principal do navegador faria a página congelar por vários segundos no celular. Por isso, o ZavoxPlayer executa o parsing de EPG e M3U dentro de Web Workers em segundo plano e persiste os resultados em cache no IndexedDB do seu dispositivo.

Outro detalhe técnico importante é o fuso horário (offset UTC). Os horários em XMLTV trazem um sufixo como -0300 (horário de Brasília) ou +0000 (UTC). O reprodutor converte automaticamente esses carimbos para o relógio local do sistema operacional onde o navegador está rodando, evitando que a grade apareça adiantada ou atrasada em 3 horas.

  • Padrão aberto XMLTV separa metadados de grade do fluxo de vídeo.
  • Cruzamento feito pelo campo tvg-id da lista M3U ou epg_channel_id da API Xtream.
  • Conversão automática de fuso horário para o relógio local do aparelho.
  • Cache em IndexedDB impede re-downloads repetitivos do XML pesado.

Por que alguns canais exibem "Sem programação" mesmo com EPG ativo

Muitos usuários acreditam que há um defeito no aplicativo quando veem parte dos canais com grade completa e outros com aviso de programação indisponível. Na imensa maioria dos casos, a causa está nos metadados entregues pela fonte original da lista.

Se o fornecedor da lista deixou o atributo tvg-id vazio naquela entrada M3U, usou um nome ligeiramente diferente do ID no XMLTV (por exemplo, "Canal HD" vs "Canal.br") ou simplesmente não inclui eventos de programação para transmissões 24h ou feeds alternativos no XMLTV, nenhum reprodutor consegue inventar os horários.

Além disso, arquivos XMLTV que não são atualizados periodicamente pela origem ficam com todos os blocos no passado após alguns dias. Quando isso acontece, apenas o administrador da sua fonte consegue publicar um novo arquivo XMLTV atualizado.

Diferença entre EPG em listas M3U e na API Xtream Codes

Em playlists M3U puras, o endereço do guia costuma aparecer no cabeçalho da primeira linha do arquivo através da tag url-tvg="..." ou x-tvg-url="...". O parser lê esse endereço se disponível e busca a grade compatível.

Já na conexão Xtream Codes, a própria API disponibiliza endpoints específicos (como get_short_epg) que retornam apenas os próximos programas de um canal específico em JSON leve, economizando memória RAM e dados móveis no smartphone.

Passo a passo resumido

  1. 01.

    Conecte sua lista M3U ou conta Xtream Codes no ZavoxPlayer

    Acesse /app, entre com sua conta e carregue sua fonte normalmente. Na conexão Xtream Codes, o endpoint de guia já é consultado automaticamente quando suportado pelo servidor.

  2. 02.

    Acesse a categoria TV pelo menu principal

    Toque ou clique em TV na barra superior (PC) ou na barra inferior (celular) para visualizar os grupos de canais.

  3. 03.

    Aguarde o Web Worker indexar os horários em segundo plano

    Na primeira abertura, a leitura do guia ocorre fora da tela para não interromper sua navegação e é salva em cache local no IndexedDB.

  4. 04.

    Confira o programa atual e o próximo ao selecionar um canal

    Quando o tvg-id da sua lista corresponder ao XMLTV da origem, o nome da atração atual e o horário aparecerão junto ao canal selecionado.

Dúvidas frequentes deste guia

O ZavoxPlayer fornece um arquivo EPG próprio para os meus canais?

Não. O guia exibido reflete exclusivamente os dados de programação (XMLTV ou API Xtream) fornecidos pela lista ou servidor que você conectou.

O EPG funciona para filmes e séries sob demanda?

Não. Filmes e séries sob demanda trazem sinopse, ano e episódios quando informados pela lista; o EPG aplica-se apenas a transmissões contínuas ao vivo com grade horária.

Carregar um EPG grande deixa o player lento?

Não, porque o processamento é isolado em Web Worker e armazenado em cache local em IndexedDB no seu dispositivo.

Por que o guia sumiu depois de alguns dias sem atualizar a lista?

Arquivos XMLTV costumam conter a programação de apenas 2 a 7 dias. Basta atualizar a lista na aba Salvas para puxar os dados mais recentes publicados pela sua fonte.

Pronto para testar na prática?

Abra a demonstração sem cadastro ou entre com seu e-mail para liberar 48 horas de teste grátis no seu computador ou celular.