EPG no IPTV: como funciona o guia de programação

Atualizado em

O EPG no IPTV, o guia eletrônico de programação, é a programação por trás do guia de TV do seu player. Os provedores o oferecem como um arquivo XMLTV num endereço próprio. Com um login Xtream Codes, o guia de TV normalmente vem sozinho; com uma playlist M3U, você mesmo adiciona o link de EPG. Se o guia fica vazio, quase sempre o problema está no link, nos IDs dos canais ou no relógio.

O que é EPG?

O EPG é um arquivo com canais e, para cada canal, os próximos programas, com início, fim, título e muitas vezes uma descrição. Quase todos os provedores de IPTV usam o mesmo formato para isso, o XMLTV. Um arquivo XMLTV minúsculo é assim:

<tv>
  <channel id="noticias.example">
    <display-name>Exemplo Notícias</display-name>
  </channel>
  <programme start="20261002180000 -0300" stop="20261002183000 -0300" channel="noticias.example">
    <title>Jornal da Noite</title>
    <desc>As notícias do dia.</desc>
  </programme>
</tv>

Cada channel tem um ID. Cada programme diz a que canal pertence. Os horários trazem a diferença em relação ao UTC, aqui -0300, e assim o player os mostra no seu fuso horário. O guia de TV real de um provedor cobre milhares de canais e vários dias, muitas vezes com muitos megabytes.

O player transforma isso na grade que você percorre: os canais de lado, o horário em cima e uma linha marcando o agora.

O guia de TV do ZiroTV na TV: no alto, a barra de seções e os dias, abaixo o título, o horário, o progresso e a descrição do programa escolhido. Embaixo, canais numerados com os programas numa linha do tempo, com o horário atual marcado.

EPG na TV comum e no IPTV

Uma TV com antena, cabo ou satélite recebe o EPG junto com o sinal digital: as próprias emissoras o mandam. Em muitos controles remotos, um botão chamado EPG ou Guia abre essa grade. Um player IPTV não tem sinal de transmissão: ele baixa a programação como um arquivo de um endereço da web. Por isso precisa de um link, e todo o resto desta página depende desse link.

Com um login Xtream Codes, o servidor oferece a programação num endereço fixo, que sai do seu login. O player busca sem perguntar nada. No ZiroTV, deixe vazio o campo do link de EPG. Só preencha se o seu provedor passou outro link, porque um link adicionado substitui o guia de TV do login.

Com um link M3U, a programação não vem na playlist, então o guia de TV precisa de um link próprio. Os provedores costumam mostrá-lo ao lado do link M3U, na área do cliente ou no e-mail de boas-vindas, às vezes como link XMLTV. Ele muitas vezes termina em .xml ou contém xmltv.php.

Use o guia de TV do seu provedor. Os IDs de canal dele batem com a playlist dele, e é isso que coloca os programas nos canais certos. O ZiroTV não fornece dados de programação e não indica fontes de terceiros: pergunte ao seu provedor. Xtream Codes ou M3U explica melhor os dois tipos de acesso.

Como o guia de TV encontra os seus canais

O player precisa decidir qual programação pertence a qual canal. O ZiroTV faz isso em três rodadas:

  1. Pelo ID. Um canal cujo tvg-id está no guia de TV recebe essa programação. O que tem dentro de um arquivo M3U está no nosso tutorial.
  2. Pelo nome. Um canal sem ID correspondente é procurado pelo nome entre os nomes de canal do guia de TV.
  3. Por nome parecido. O que ainda faltar o ZiroTV compara uma última vez, sem acréscimos como HD ou FHD, siglas de país e texto entre parênteses. Ele só aceita um nome muito parecido, para que nenhum programa vá parar no canal errado.

Os canais que não encontram nada mostram o nome sem programas. Em alguns canais isso é normal em quase toda playlist: nem todo canal de um provedor está no guia de TV dele.

Como adicionar o link de EPG no ZiroTV

Ao adicionar uma playlist, você cola o link no campo do link de EPG antes de adicionar e sincronizar. Para colocar ou trocar o link numa playlist que você já tem:

  1. Abra as configurações.
  2. Ao lado da playlist, selecione o lápis para editá-la.
  3. Cole o link no campo do link de EPG, substituindo o antigo.
  4. Salve. O ZiroTV sincroniza a playlist de novo.

Na TV, você também pode adicionar uma playlist nova pelo celular. Aí você cola o link de EPG comprido no celular, em vez de digitar com o controle remoto.

Como o guia de TV se mantém atualizado

O ZiroTV mostra os seus canais assim que eles carregam e logo depois busca a programação. Por isso a grade se preenche um instante depois. O ZiroTV guarda o guia de TV por 30 minutos e depois o baixa de novo na próxima verificação: a cada 15 minutos enquanto o app está aberto, quando você volta ao app e quando você para de assistir. Enquanto um canal está tocando, ele não começa nenhum download, para a imagem ter a conexão só para ela. Você não precisa atualizar nada à mão.

O guia de TV no ZiroTV vai de algumas horas atrás até onde o seu provedor programa, muitas vezes vários dias. Os programas que já passaram aparecem na lista de catch-up, que consulta direto o seu provedor. Isso funciona com um login Xtream Codes, nos canais que o seu provedor arquiva. Com uma playlist M3U com tags de catch-up, ela mostra o que o seu guia ainda tem. Depois de voltar na TV ao vivo, você também pode pausar. Como o catch-up funciona.

Por que o meu guia de TV está vazio?

Siga estes pontos na ordem. A maioria dos guias vazios se resolve num dos três primeiros.

Não há link de EPG

Uma playlist M3U sem link de EPG não tem guia de TV nenhum. Peça o link ao seu provedor e adicione como mostrado acima.

O link está errado ou expirou

Um link de EPG muitas vezes contém o seu usuário e a sua senha. Se eles mudam ou a sua assinatura acaba, o link para de funcionar. Copie de novo do seu provedor e confira se não há espaços nem falta nenhum caractere.

O guia de TV precisa de um momento

Um guia de TV grande leva um tempo para carregar e ser ligado aos canais depois de uma sincronização. Espere um minuto antes de mudar qualquer coisa e deixe o app aberto enquanto isso.

O link aponta para um arquivo compactado

Alguns links de EPG terminam em .gz, uma cópia compactada do arquivo. O ZiroTV lê o arquivo XMLTV normal. Peça ao seu provedor a versão sem compactação, normalmente o mesmo endereço sem o .gz.

O download demora demais

O ZiroTV dá dois minutos para o download. Um guia de TV com muitos dias por canal ou um servidor muito lento pode deixar alguns canais vazios. Se o seu provedor oferecer um guia com menos dias ou menos canais, use esse.

IDs e nomes não batem

Um guia de TV de outra fonte que não o seu provedor usa IDs e nomes que a sua playlist não tem. O mesmo vale para um guia feito para outra região do mesmo serviço. Use o link de EPG que acompanha a sua playlist.

O servidor de EPG do provedor caiu

Acontece. O guia de TV volta sozinho assim que o servidor responder de novo. O ZiroTV tenta outra vez na próxima verificação.

Por que os horários do guia de TV estão errados?

Se todos os programas estão adiantados ou atrasados no mesmo tanto, normalmente uma hora ou mais, provavelmente o fuso horário do aparelho está errado. No Fire TV, ele fica nas configurações, nas preferências; no Google TV, nas configurações, em Sistema, na parte de data e hora. Se o relógio está certo, talvez o próprio guia de TV não traga a diferença em relação ao UTC. Aí o ZiroTV lê os horários como UTC, e só o seu provedor pode corrigir o arquivo.

Se só alguns programas estão errados, a programação do seu provedor para esses canais está desatualizada. O guia de TV é tão bom quanto o arquivo de onde vem. Mais sobre o guia de TV e a ligação com os canais está nos recursos do ZiroTV.

Perguntas sobre EPG no IPTV.

O que é EPG no IPTV?

EPG quer dizer Electronic Program Guide, o guia eletrônico de programação. É a programação por trás do guia de TV: qual programa passa em qual canal, e quando. Os provedores de IPTV a oferecem como um arquivo XMLTV. O player baixa o arquivo e o liga à sua lista de canais.

Onde encontro o link de EPG para IPTV?

Com o seu provedor. Com um login Xtream Codes, a programação normalmente vem sozinha. Para um link M3U, peça o link de EPG ou XMLTV. Muitas vezes ele aparece ao lado do link da playlist na sua área de cliente ou no e-mail de boas-vindas. O ZiroTV não fornece dados de programação.

Por que o EPG do meu IPTV não funciona?

Quase sempre o link de EPG está faltando, expirou ou aponta para um arquivo compactado. Muitas vezes os IDs de canal da programação também não batem com a sua playlist. Confira se o link está na playlist e se ainda funciona. Depois de uma sincronização, dê um minuto ao player: um guia de TV grande leva um tempo para carregar e ser ligado aos canais.

Como atualizar o EPG?

Normalmente você não precisa. O ZiroTV baixa a programação de novo quando ela tem mais de 30 minutos, enquanto o app está aberto. Se o seu provedor passar um novo link de EPG, edite a playlist nas configurações do ZiroTV, cole o novo link e salve. O ZiroTV sincroniza de novo.

Todas as perguntas e respostas

Um guia de TV que se preenche sozinho.

Adicione a sua playlist no ZiroTV e ele liga o guia de TV aos seus canais. Experimente todos os recursos por 7 dias, sem cartão.