Sessenta segundos de teoria que economizam uma hora de tentativa
Três peças precisam se encaixar para um guia aparecer:
- A lista traz seus canais, cada um idealmente com uma tag
tvg-id. - O arquivo XMLTV — o EPG — traz canais por
ide programas com carimbos de início e fim. Com login Xtream ele chega sozinho, de um endereço padrão; com lista M3U, você adiciona a URL dele por conta própria. - A conexão: um canal só mostra programação quando sua
tvg-idcorresponde a umidde canal no XMLTV — e quando esse canal tem, de fato, programas com horários que fazem sentido.
Todo defeito de EPG é a falha de uma das três: sem arquivo, arquivo ruim, ou conexão rompida. O sintoma revela qual.
Sintoma: o guia está completamente vazio
-
Confirme que existe uma fonte conectada
Listas M3U não carregam programação própria. Se você adicionou só a URL M3U e mais nada, não há guia para mostrar — edite a lista e acrescente a URL de EPG/XMLTV da mensagem de boas-vindas (costuma terminar em
.xmlou.xml.gz). Conexões Xtream buscam o guia automaticamente. -
Teste a própria fonte
Cole a URL do EPG no verificador de EPG. Ele informa quantidade de canais, quantidade de programas e o intervalo de datas em segundos. Zero programas — ou datas todas no passado — significa fonte quebrada na origem: nenhum player exibe dados que não existem. Isso vira um chamado ao provedor, agora com evidência anexada.
-
Atualize uma vez, espere uma vez
Arquivos de guia são grandes e são regenerados no cronograma do provedor. Depois de conectar uma fonte boa, atualize a lista; se o arquivo estiver sendo regenerado naquele momento, dê uma hora antes de concluir qualquer coisa.
Sintoma: alguns canais têm dados, outros nada
É a conexão rompendo canal por canal. Os canais vazios carregam uma tvg-id que não corresponde a
nada no XMLTV — ou não carregam nenhuma. É falha de mapeamento na lista do provedor, e é comum: listas grandes
são montadas às pressas, e as tags apodrecem.
- Rode o verificador — ele aponta canais declarados sem nenhum programa, uma das duas metades de uma conexão rompida.
- Peça ao provedor para corrigir as tags
tvg-iddos canais que importam para você — cite-os especificamente. (Se você mantém a própria lista, corrija as tags você mesmo.) - Variantes duplicadas às vezes mapeiam de forma desigual — a entrada HD com tag, a 4K sem. A limpeza do Flipbox agrupa variantes sob um canal só, o que disfarça exatamente essa desigualdade.
Sintoma: tudo deslocado pelas mesmas horas
Deslocamento uniforme é defeito de fuso no arquivo XMLTV. Carimbos no formato
20261007203000 +0000 carregam o fuso junto; quando o provedor gera o arquivo com o fuso errado —
ou remove os fusos e deixa cada player adivinhar —, a grade inteira cai mais cedo ou mais tarde por um valor
constante.
- Confira antes o relógio e o fuso do próprio iPhone (Ajustes → Geral → Data e Hora, no automático). Aparelho preso no fuso errado desloca a agenda de todos os apps, não só a do guia.
- Passe a fonte pelo verificador — ele marca fusos ausentes e padrões suspeitos de horário explicitamente. “Meu guia está três horas errado” vira um relatório que o provedor consegue usar.
- Se o arquivo está errado na origem, o conserto duradouro é do provedor. Horário de grade é dado, não opinião.
Sintoma: o guia acaba poucas horas à frente
Duas possibilidades honestas — uma delas é nossa:
- A fonte é rasa. Alguns provedores publicam só algumas horas à frente. O verificador mostra a profundidade real do arquivo — se os dados param ali, todo player para ali.
- Você está no plano gratuito do Flipbox. O gratuito mostra uma janela de 3 horas por design; o Pro estende grade e busca do guia para 24 horas. Se o verificador mostra fonte funda mas a sua grade para em três horas, é o plano, não um defeito — e a janela gratuita nunca encolhe.
Sintoma: a programação é de ontem
- Dados velhos significam gerador parado no provedor — o intervalo de datas do verificador escancara (último programa já no passado).
- Atualize uma vez para descartar cópia em cache, depois reporte. Fontes que morrem na sexta e ressuscitam na segunda são uma espécie conhecida.
- Se o provedor oferece um endereço alternativo de EPG (alguns listam vários), troque e teste de novo.
Antes de culpar qualquer player — Flipbox incluído —, passe a fonte de EPG pelo verificador. Ele responde a única pergunta que vem primeiro: os dados existem? Tudo depois disso é exibição — e exibição não inventa programa.
Perguntas que sempre aparecem
Por que meu guia de IPTV está completamente vazio?
Com lista M3U, o motivo usual é não haver fonte de EPG conectada — a programação viaja separada da lista de canais, como arquivo XMLTV. Adicione a URL de EPG do seu provedor. Com login Xtream o guia chega automaticamente; se ficar vazio ali, normalmente a própria fonte do provedor está vazia ou parada.
Por que os horários do meu guia estão deslocados em algumas horas?
Os carimbos de hora do XMLTV carregam o fuso junto. Quando o provedor gera o arquivo com o fuso errado — ou remove os fusos e deixa cada player adivinhar —, toda a grade desloca pelo mesmo tanto. O dado está errado na origem; o verificador de EPG mostra se os fusos existem e fazem sentido.
Por que alguns canais têm programação e outros não?
A programação se conecta aos canais pela tag tvg-id da lista. Canais cuja tvg-id não
corresponde a nenhum id no arquivo XMLTV ficam vazios — uma falha de mapeamento na lista do
provedor, não do player.
Por que meu guia acaba três horas à frente?
Dois motivos possíveis: a fonte do provedor pode publicar só algumas horas à frente, ou você está no plano gratuito do Flipbox, que mostra três horas de guia por design. Verifique a profundidade real da fonte com o verificador de EPG; se ela for mais funda, o Pro estende a grade para 24 horas.
Meu provedor não me deu URL de EPG. Isso é normal?
Com login Xtream, sim — o guia vem junto com a conexão. Com link M3U puro, é caso de pedir a URL XMLTV ao provedor; a maioria tem, mesmo quando a mensagem de boas-vindas esquece.
O arquivo termina em .xml.gz — problema?
Não. XMLTV comprimido é padrão em guias grandes, e o Flipbox lida com isso. O verificador também lê fontes gzip nos navegadores modernos.
Com que frequência o Flipbox atualiza o guia?
No próprio cronograma e sempre que você puxa para atualizar — nenhum ajuste necessário. Se há dado fresco na origem, a atualização manual o traz na hora.
O Flipbox pode mostrar guia para canal sem dado na origem?
Não — e nada pode. Um player exibe o que o XMLTV entrega. O conserto de dado ausente é sempre rio acima; o passo prático é identificar qual metade quebrou — exatamente para isso existem o verificador e esta página.
Continue por aqui
- Verificador de EPG gratuito — leia qualquer fonte XMLTV em segundos
- Adicionar lista M3U — incluindo onde entra a URL do EPG
- Login Xtream — a conexão com programação automática
- Resolver travamentos — quando o problema é a imagem, não o guia