O que é o EPG? O guia de programação eletrónico explicado

Última atualização: · Pela equipa WatchlyGuide

Um EPG (Electronic Program Guide) é a grelha de programação que aparece no ecrã e mostra o que está a dar agora e a seguir em todos os canais, com títulos, horas, descrições e categorias numa grelha percorrível. É o substituto digital das grelhas de televisão impressas, e permite consultar a programação, ler os detalhes dos programas e, muitas vezes, definir lembretes ou gravações. Este guia explica como funciona um EPG, o formato XMLTV que está por trás e como configurar um.

Uma televisão a mostrar a grelha do EPG, o guia de programação eletrónico, com os canais na vertical e os programas numa linha temporal
Um EPG transforma uma lista de canais nua numa grelha percorrível do «o que está a dar».
Nesta página

O que faz um EPG

Um EPG é a programação interativa sobreposta aos seus canais. Numa vista rápida, mostra normalmente:

  • Agora e a seguir — o que está a dar neste momento e o que vem depois em cada canal.
  • Uma grelha temporal — os canais de um lado, um eixo de tempo percorrível ao longo do topo.
  • Detalhes do programa — título, hora de início e de fim, uma sinopse e, muitas vezes, o género ou a classificação etária.
  • Ações — definir um lembrete, recomeçar um programa em direto ou agendar uma gravação, onde tal for suportado.

Sem um EPG, uma lista de canais de IPTV é só um conjunto de nomes. É o EPG que a faz parecer televisão a sério, com um guia decente à volta do qual pode planear a sua noite.

Como funciona um EPG

Um EPG é um conjunto de dados separado da sua lista de canais, e é o leitor que junta os dois.

  1. A lista de canais — normalmente uma lista M3U — define que canais existem e onde está cada emissão. Todos os canais trazem um identificador chamado tvg-id.
  2. Os dados de EPG — um ficheiro XMLTV — enumeram os programas e as respetivas horas, cada um associado a um identificador de canal.
  3. A correspondência — o leitor liga um canal à sua programação quando o tvg-id da lista é igual ao identificador de canal do ficheiro de EPG.

Esse identificador partilhado é todo o truque. Quando bate certo, cada canal mostra a sua programação; quando não bate, o guia fica em branco — o que é, de longe, o problema de EPG mais comum.

Diagrama que mostra uma lista M3U e um ficheiro de EPG XMLTV ligados por um tvg-id partilhado para construir o guia
O leitor junta a sua lista de canais e os dados de EPG através de um identificador de canal partilhado (tvg-id).

O formato XMLTV

Quase todos os EPG de IPTV usam o XMLTV, um formato XML aberto para grelhas de televisão. Um ficheiro XMLTV tem dois tipos de entradas: definições de canais e entradas de programas.

<channel id="bbcone.uk">
  <display-name>BBC One</display-name>
</channel>
<programme start="20260723183000 +0000" stop="20260723190000 +0000" channel="bbcone.uk">
  <title>Evening News</title>
  <desc>The day's top stories and weather.</desc>
</programme>

Na prática, há dois pormenores que contam:

  • O identificador channel tem de ser igual ao tvg-id da sua lista. No exemplo, ambos são bbcone.uk. É esta a ligação que faz o guia aparecer.
  • As horas incluem um fuso horário (+0000, acima). Se o fuso horário do seu leitor estiver mal definido, os programas aparecem desfasados em várias horas.

Os ficheiros de EPG são muitas vezes servidos comprimidos em gzip, como .xml.gz, para poupar largura de banda, já que uma semana completa de grelhas para centenas de canais é pesada. Os leitores descomprimem-nos automaticamente.

Como configurar um EPG

Acrescentar um EPG é um trabalho curto e único na maioria dos leitores:

  1. Obtenha o URL do EPG. A sua fonte licenciada fornece uma ligação XMLTV (.xml ou .xml.gz).
  2. Abra as definições de EPG do seu leitor. Em aplicações como o TiviMate ou o IPTV Smarters, procure «EPG» ou «Guide».
  3. Cole o URL e guarde.
  4. Deixe transferir. A primeira atualização pode demorar um minuto em guias grandes.
  5. Defina o intervalo de atualização e o fuso horário. Uma atualização automática diária mantém o guia certo; o fuso horário correto mantém os programas alinhados.

Para um percurso específico por aplicação, siga o nosso guia de instalação do TiviMate, e veja como encaixa o lado da lista de canais em o que é uma lista de reprodução M3U.

Dica: use uma fonte de EPG feita para a sua lista de canais, para que os identificadores de canal já coincidam com os tvg-id da lista. Misturar uma lista com um EPG que nada tem que ver com ela é a principal razão para os guias aparecerem vazios.

Resolver um EPG que não funciona

Se o guia estiver em branco, errado ou desfasado no tempo, percorra estes pontos por ordem:

Sintoma Causa provável Solução
Guia completamente vazio tvg-id ≠ identificador de canal do EPG Alinhe os identificadores ou use uma fonte de EPG compatível
Alguns canais não têm guia Esses canais não têm tvg-id Acrescente o tvg-id correto a essas entradas da lista
As horas estão desfasadas Fuso horário errado na aplicação Defina o fuso horário correto nas definições
O guia deixou de atualizar URL expirado ou sem atualização automática Atualize o URL do EPG; ative a atualização diária
Dados antigos depois de mudanças Guia em cache Force uma atualização do EPG / limpe a cache do guia na aplicação

Quase todos os problemas de EPG se resumem àquela correspondência de tvg-id. Alinhe os identificadores e o resto costuma cair no sítio.

Em resumo

Um EPG é a programação interativa que transforma uma simples lista de canais em televisão a sério — agora e a seguir, uma grelha percorrível e os detalhes dos programas. Nos bastidores é um ficheiro XMLTV, ligado aos seus canais por um tvg-id partilhado. Cole o URL de EPG certo no seu leitor, faça coincidir os identificadores, defina o fuso horário correto e fica com um guia completo, que se atualiza sozinho.

A seguir, perceba o lado da lista de canais em o que é uma lista de reprodução M3U, ou comece pelos fundamentos com o que é o IPTV.

Ficou com dúvidas sobre algum termo desta página? Procure-o no glossário de streaming.

Perguntas frequentes

O que é um EPG?

Um EPG (Electronic Program Guide) é a grelha de programação que aparece no ecrã e mostra o que está a dar agora e o que vem a seguir em todos os canais. Apresenta títulos, horas de início e de fim, descrições e categorias numa grelha percorrível, o que permite consultar a programação, ver detalhes e, muitas vezes, definir lembretes ou gravações.

O que significa a sigla EPG?

EPG significa Electronic Program Guide, ou seja, guia de programação eletrónico. É o substituto digital e interativo das grelhas de televisão impressas que apareciam nos jornais e nas revistas. Alguns sistemas também lhe chamam IPG (Interactive Program Guide), mas os dois termos designam a mesma grelha de canais e horários no ecrã.

O que é o formato XMLTV?

O XMLTV é o formato de ficheiro padrão para os dados de EPG. É um ficheiro XML que enumera canais e respetivos programas, cada um com hora de início, hora de fim, título e descrição, associados a um identificador de canal. Os leitores de IPTV transferem um ficheiro XMLTV — muitas vezes comprimido em gzip, como .xml.gz — e ligam-no aos canais através do tvg-id da sua lista.

Como acrescento um EPG ao meu leitor de IPTV?

Nas definições do seu leitor de IPTV, procure a secção EPG ou guia e cole o URL de EPG (normalmente uma ligação XMLTV .xml ou .xml.gz) fornecido pela sua fonte. Guarde e deixe a aplicação transferir os dados. O leitor associa cada programa a um canal através do tvg-id da sua lista M3U e preenche depois o guia.

Porque é que o meu EPG não aparece ou está errado?

A causa habitual é uma discrepância no tvg-id: os identificadores da sua lista M3U não coincidem com os identificadores de canal do ficheiro de EPG, por isso a aplicação não consegue ligá-los. Outras causas são um URL de EPG errado ou expirado, o fuso horário mal definido, ou dados que ainda não foram atualizados. Alinhar os tvg-id resolve quase todos os casos.

Um EPG é o mesmo que a lista de canais?

Não. A lista de canais — normalmente uma lista M3U — diz ao leitor que canais existem e onde estão as respetivas emissões. O EPG são dados separados, que descrevem o que está agendado nesses canais ao longo do tempo. O leitor liga os dois através de um identificador de canal partilhado, para que cada canal mostre a sua programação.