Neste artigo
Este artigo faz parte do guia O que é IPTV? Guia completo para iniciantes em Portugal.
O EPG (Electronic Program Guide, ou guia eletrónico de programação) é a grelha que mostra o que está a dar agora, o que vem a seguir e a programação dos próximos dias em cada canal. No IPTV, o guia vem quase sempre num ficheiro no formato XMLTV, separado da lista de canais. A aplicação liga cada canal da lista à sua entrada no guia através de um identificador (o tvg-id). Quando esse identificador não coincide, ou quando o fuso horário está errado, aparecem os problemas clássicos: canais sem programação ou horários desfasados uma hora.
Se está a começar, o guia O que é IPTV explica os conceitos de base.
Como funciona o EPG no IPTV
- O fornecedor disponibiliza um ficheiro XMLTV (por um URL) com a programação dos canais.
- A lista de canais (M3U) inclui, em cada canal, um identificador tvg-id.
- A aplicação descarrega o XMLTV e associa cada canal à programação com o mesmo identificador.
- A grelha é mostrada com as horas convertidas para o fuso horário configurado.
Com acesso Xtream Codes, este processo costuma ser automático: a aplicação obtém o guia diretamente do servidor. Com M3U, muitas vezes é preciso indicar o URL do EPG à parte. Os formatos estão explicados em Xtream Codes API e URL da lista M3U.
Como é um ficheiro XMLTV (simplificado)
<tv>
<channel id="CanalExemplo.pt"><display-name>Canal Exemplo</display-name></channel>
<programme start="20261017200000 +0100" stop="20261017210000 +0100" channel="CanalExemplo.pt">
<title>Telejornal</title>
</programme>
</tv>Repare em dois pormenores que explicam a maioria dos problemas: o channel id tem de coincidir com o tvg-id da lista, e as horas trazem o desvio de fuso (+0100 na hora de verão de Lisboa, +0000 no inverno).
Como adicionar uma fonte EPG
Com Xtream Codes
Normalmente não precisa de fazer nada: o guia é carregado com o login. Se não aparecer, procure nas definições da aplicação a opção de atualizar o EPG.
Com M3U
- Peça ao fornecedor o URL do EPG (XMLTV), por vezes terminado em xmltv.php, .xml ou .xml.gz.
- Nas definições da aplicação, procure EPG, Guia ou Fontes de EPG e cole o URL.
- Escolha a frequência de atualização (diária é suficiente).
- Force uma atualização e aguarde: guias grandes podem demorar alguns minutos.
Onde fica a opção em leitores comuns
| Leitor | Onde |
|---|---|
| TiviMate | Definições › EPG |
| Kodi (PVR IPTV Simple Client) | Configuração do addon › separador EPG |
| Smart IPTV / SS IPTV | No site da aplicação ou nas definições, consoante a aplicação |
| VLC | Não tem grelha de EPG |
Guias por aplicação: TiviMate, Kodi, IPTV no Android.
Fuso horário: o erro mais comum
Se toda a grelha está uma hora adiantada ou atrasada:
- Confirme o fuso horário do equipamento (Europa/Lisboa; Atlântico/Açores nos Açores).
- Confirme se a aplicação tem uma opção de desvio do EPG (em horas) e se não está a aplicar uma correção a mais.
- Lembre-se da mudança de hora: guias mal gerados podem ficar desfasados só durante metade do ano.
Canais sem guia
Quando só alguns canais aparecem sem programação, a causa é quase sempre o identificador:
- o tvg-id do canal na lista não existe no XMLTV;
- ou o fornecedor não tem guia para esse canal.
Muitas aplicações permitem associar manualmente um canal a uma entrada do guia (no TiviMate, por exemplo, com uma pressão longa no canal). Se edita a lista, veja Como editar uma lista M3U.
Desempenho: quantos dias de guia?
Guias de muitos dias para centenas de canais ocupam memória e tornam as aplicações lentas em boxes modestas. Três a cinco dias chegam para a maioria das pessoas; reduza se a aplicação ficar lenta.
Perguntas frequentes
O que significa EPG?
EPG significa Electronic Program Guide, o guia eletrónico de programação: a grelha com o que está a dar e o que vem a seguir em cada canal.
O que é o formato XMLTV?
É o formato de ficheiro mais usado para guias de programação em IPTV. Lista os canais e os programas, com horas de início e fim e o fuso horário.
Porque é que o guia aparece com uma hora de diferença?
Normalmente por causa do fuso horário do equipamento ou de um desvio de EPG mal configurado na aplicação. Defina Europa/Lisboa e reveja o desvio.
Porque é que alguns canais não têm programação?
O identificador do canal na lista (tvg-id) não corresponde a nenhuma entrada do guia, ou o fornecedor não tem guia para esse canal.
Em resumo
O EPG é a grelha de programação do IPTV, normalmente fornecida em XMLTV e associada aos canais pelo tvg-id. Com Xtream Codes carrega quase sempre sozinho; com M3U, adicione o URL do guia nas definições da aplicação. Se a grelha estiver desfasada, verifique o fuso horário; se faltar programação em alguns canais, verifique os identificadores. Para resolução de problemas passo a passo, veja EPG não aparece no IPTV.
O guia continua vazio ou desfasado depois de configurar? Temos um guia de resolução passo a passo.
EPG não aparece?
