EPG no player: como fazer o guia de programação aparecer certo
Por Equipe Guia VU Player · Atualizado em 01/10/2026 · 7 min de leitura
Canal funcionando e grade vazia é o problema mais comum depois do cadastro. A causa quase nunca é o player: é a ligação entre a lista e o arquivo de guia.
O que é EPG e XMLTV
O arquivo XMLTV tem dois blocos: a lista de canais, cada um com um id, e os programas, cada um com início, fim, título e o channel a que pertence. Se o tvg-id da sua lista for igual ao id do XMLTV, a grade aparece.
De onde vem o endereço do guia
| Situação | Onde está o guia |
|---|---|
| Login Xtream | O player costuma buscar sozinho no servidor |
| M3U com x-tvg-url no cabeçalho | O player lê o endereço da primeira linha |
| M3U sem cabeçalho de guia | É preciso cadastrar o link XMLTV nas configurações |
Por que a grade fica vazia
- Endereço do guia não cadastrado: o player não sabe onde buscar.
- Arquivo grande ainda baixando: guias de vários dias podem ter dezenas de MB; aguarde.
- tvg-id diferente: “noticias1.br” na lista e “Noticias1” no guia não casam.
- Guia vencido: o arquivo cobre dias passados e não foi atualizado.
- Cache: o player guardou uma versão antiga.
Horário errado: fuso e deslocamento
O XMLTV registra horários com fuso (por exemplo, +0000). Se o player ou a TV estão com fuso diferente, a grade aparece adiantada ou atrasada. A maioria dos players tem um ajuste de deslocamento em horas. Para o horário de Brasília, normalmente basta o fuso do aparelho correto; se ainda assim errar, ajuste o deslocamento até casar com o programa no ar.
Configuração recomendada
| Ajuste | Valor sugerido | Motivo |
|---|---|---|
| Atualização automática | Diária | Mantém a grade sem pesar |
| Dias de guia | 2 a 3 | Arquivos menores carregam mais rápido |
| Deslocamento | 0, ajustando se necessário | Evita erro duplo de fuso |
| Atualizar ao abrir | Ligado em aparelhos rápidos | Grade sempre fresca |
Catch-up: assistir o que já passou
Alguns servidores guardam a programação recente de certos canais. Quando a lista e o player suportam, a grade passa a ter programas anteriores clicáveis. O recurso depende de três coisas: o servidor oferecer, a lista marcar os canais com catch-up e o player saber ler. Se faltar uma delas, os programas passados aparecem na grade, mas não abrem.
Guia em aparelhos lentos
Arquivos de guia com uma semana de programação e milhares de canais podem travar a carga inicial em TV Box de entrada. Se isso acontecer, reduza os dias de guia, limite a atualização a uma vez por dia e, se o player permitir, carregue a grade apenas dos favoritos. A experiência fica mais leve sem perder o essencial.
Teste rápido do guia
- Abra um canal de notícias e compare o programa no ar com o mostrado na grade.
- Repita em um canal de filmes, onde a programação é mais longa.
- Se houver diferença fixa de horas em todos, é fuso.
- Se só alguns canais estiverem errados, é identificador.
O guia como ferramenta
- Use a grade para planejar o que assistir, sem zapear.
- Em players que permitem, ative lembretes de programa.
- Combine com favoritos: grade só dos canais que você usa carrega mais rápido.
Organização de favoritos em favoritos e categorias.
Quando a culpa é da lista
Se você cadastrou o guia, aguardou, ajustou o fuso e ainda há canais sem grade, os identificadores não batem na origem. Só o fornecedor corrige. No nosso serviço, o endereço do guia vai junto com o acesso; teste em teste IPTV 6h ou leia o manual do VU Player.
Player pronto, falta a lista?
Receba um acesso de teste por 6 horas e veja canais, filmes e guia funcionando no seu player.
Perguntas e respostas
Todo canal tem guia de programação?
Não. Alguns canais não têm grade disponível na fonte do guia.
Por que o guia demora a carregar?
Arquivos XMLTV de vários dias são grandes. Reduzir os dias de guia ajuda.
Posso usar um guia de outra fonte?
Pode, mas os identificadores precisam bater com os da sua lista.