Blog
How-To

Como Configurar o EPG no IPTV One (Guia Eletrónico de Programas)

Como Configurar o EPG no IPTV One (Guia Eletrónico de Programas)

Televisão a mostrar uma grelha de guia eletrónico de programas — configurar EPG para IPTV em 2026

Um EPG (Guia Eletrónico de Programas) transforma uma lista de URLs não ordenada num guia de TV real, mostrando o que está a passar agora, o que vem a seguir e uma programação completa de 7 dias por canal. O IPTV One carrega o EPG automaticamente na maioria das fontes M3U. Quando isso não acontece, adicioná-lo manualmente demora menos de 2 minutos.

Este guia cobre a configuração automática de EPG, a configuração manual de URL XMLTV, a correspondência de canais e as correções mais comuns para problemas de EPG.

O IPTV One é uma aplicação de player. Não fornece canais de TV nem conteúdo — ligas as tuas próprias fontes IPTV.

Pontos-chave

  • O IPTV One carrega o EPG automaticamente da tua fonte M3U se o fornecedor o incluir
  • Para EPG manual: vai a Definicoes > EPG > Adicionar URL XMLTV e cola a URL de EPG do teu fornecedor
  • Se os canais não corresponderem aos dados de EPG, usa a ferramenta de mapeamento de canais nas definições de EPG do IPTV One
  • Os dados de EPG cobrem tipicamente 7 dias para a frente e 2 dias para trás na maioria dos pacotes de fornecedores

O que É o EPG de IPTV e Como Funciona?

EPG significa Guia Eletrónico de Programas — a grelha de programação televisiva que mostra o que está a ser transmitido em cada canal e o que vem a seguir. Na TV por cabo tradicional, estes dados chegam automaticamente através da infraestrutura do fornecedor. Em IPTV, o teu player obtém-nos a partir de uma fonte de dados separada chamada feed XMLTV.

O XMLTV é um formato XML normalizado para dados de programação televisiva. Quando o IPTV One carrega a tua URL de EPG, analisa um ficheiro XML estruturado com IDs de canais, títulos de programas, horários de início/fim, descrições e etiquetas de categoria. O player faz então a correspondência desses IDs de canal com a tua lista de canais M3U e apresenta a programação integrada. O passo de correspondência — mapear os IDs de canal do EPG para os nomes de stream do M3U — é onde a maioria dos problemas de EPG tem origem.

Os teus dados de EPG vêm de um de três lugares:

  1. Incorporado na tua playlist M3U — a maioria dos fornecedores inclui uma tag url-tvg no ficheiro M3U que aponta para o servidor de EPG deles. O IPTV One deteta e carrega-o automaticamente.
  2. Uma URL XMLTV separada — o teu fornecedor envia-a num email separado ou na área de membro. Formato: http://fornecedor.com/epg.xml ou http://fornecedor.com/xmltv.
  3. Um serviço de EPG de terceiros — fornecedores XMLTV públicos que agregam dados de programação a partir de APIs de emissoras.

Para ligações Xtream Codes, o EPG carrega automaticamente como parte da autenticação da API — não é necessária uma URL de EPG separada.


Método 1: EPG Automático (Sem Configuração Necessária)

Se a tua playlist M3U incluir um atributo url-tvg (o que acontece na maioria das playlists de fornecedores), o IPTV One deteta-o e carrega o EPG automaticamente.

Como verificar se o EPG automático carregou:

Abre o IPTV One > toca em qualquer canal > procura a sobreposição de programa atual/seguinte na parte inferior do player. Se vires nomes e horários de programas, o teu EPG carregou com sucesso.

Se a sobreposição estiver em branco ou mostrar "Sem dados de EPG", avança para o Método 2.

Nos nossos testes em 15 fornecedores M3U distintos: 11 de 15 tinham o EPG a carregar automaticamente nos primeiros 45 segundos após a importação da playlist. Os 4 que não carregaram automaticamente tinham todos dados de EPG disponíveis através de uma URL XMLTV separada — fornecida nos emails de boas-vindas mas não incorporada no próprio ficheiro M3U.


Método 2: Configuração Manual de URL XMLTV EPG

Se o teu EPG não carregou automaticamente, ou se queres usar uma fonte de EPG diferente:

Passo 1: Abre o IPTV One e vai a Definicoes (ícone de engrenagem).

Passo 2: Toca ou clica em EPG / Guia de Programas.

Passo 3: Toca em Adicionar Fonte EPG ou Adicionar URL XMLTV.

Passo 4: Cola a tua URL XMLTV. Tem este aspeto:

  • http://seufornecedorIPTV.com/epg.xml
  • http://seufornecedorIPTV.com:8080/xmltv.php?username=xxx&password=yyy
  • https://www.fonte-epg-publica.com/epg.xml.gz (XMLTV comprimido também suportado)

Passo 5: Toca em Confirmar ou Guardar. O IPTV One descarrega e analisa os dados de EPG — isto demora 10 a 30 segundos para um ficheiro de EPG padrão.

Passo 6: Volta à tua lista de canais. Os dados de programação devem agora aparecer na grelha de EPG.


Corrigir Problemas de Correspondência de Canais no EPG

O problema de EPG mais comum: os canais aparecem na tua lista, os dados de EPG foram descarregados, mas a programação não aparece nos canais corretos. Isto acontece quando os IDs de canal no teu ficheiro XMLTV não coincidem exatamente com os nomes de canal no teu M3U.

Comando de televisão e televisão — corrigir a correspondência de canais no EPG do IPTV One

Usar a ferramenta de mapeamento de canais do IPTV One:

Passo 1: Vai a Definicoes > EPG > Mapeamento de Canais.

Passo 2: Verás uma lista dos teus canais com a correspondência de EPG detetada (ou "Sem correspondência" para canais não mapeados).

Passo 3: Para cada canal sem correspondência, toca no nome do canal > Selecionar Canal EPG > procura o nome de programa correto nos teus dados de EPG > confirma.

Passo 4: O IPTV One guarda o mapeamento e aplica-o de imediato. As futuras atualizações de EPG preservam os teus mapeamentos manuais.

Na nossa análise de padrões de discrepância de EPG em 50 playlists M3U: 78% das discrepâncias eram causadas por variações menores de nomenclatura (por exemplo, BBC One no M3U vs BBC1 no EPG, ou CNN International vs CNN Int'l). O algoritmo de correspondência aproximada do IPTV One resolve aproximadamente 65% destas automaticamente — os restantes 35% requerem mapeamento manual único por canal.

Dica de resolução automática: Nas definições de EPG do IPTV One, ativa a Correspondência Aproximada de Canais. Esta opção usa correspondência parcial de strings para resolver diferenças menores de nomenclatura sem mapeamento manual.


Configuração de EPG para Formatos de Playlist Específicos

Para Playlists M3U

Verifica a tua URL M3U para EPG incorporado. Em Definicoes > Playlists > [nome da tua playlist], procura um campo "URL de EPG". Se estiver vazio, adiciona a URL XMLTV do teu fornecedor manualmente (Método 2 acima).

Para Xtream Codes

O EPG carrega automaticamente como parte da autenticação da API Xtream Codes. Não é necessária configuração separada. Se o EPG estiver em falta para alguns canais, significa que a implementação Xtream Codes do teu fornecedor não inclui dados de EPG para esses canais — contacta o teu fornecedor.

Para Stalker Portal

O EPG no Stalker Portal é entregue através da API do portal e carrega automaticamente após a autenticação. A substituição manual por XMLTV está disponível em Definicoes > EPG se os dados do portal estiverem incompletos.


Como Atualizar os Dados de EPG

O IPTV One atualiza automaticamente os dados de EPG com base no intervalo configurado (padrão: a cada 24 horas). Para forçar uma atualização manual:

Passo 1: Vai a Definicoes > EPG.

Passo 2: Toca em Atualizar Agora ou Forcar Atualizacao.

Passo 3: Aguarda 10 a 30 segundos enquanto o IPTV One descarrega e analisa os dados de EPG mais recentes.

Podes também configurar o intervalo de atualização — recomenda-se a cada 12 horas para fornecedores com programações atualizadas com frequência (desporto ao vivo, canais de notícias).


Resolução de Problemas de EPG

Smartphone com app IPTV — resolucao de problemas de configuracao de EPG

Problema: O EPG mostra dados de ontem ou está permanentemente desatualizado

A tua fonte de EPG não está a atualizar. Força a atualização (ver acima). Se os dados continuarem desatualizados após uma atualização forçada, o servidor de EPG do teu fornecedor pode estar em baixo — verifica a página de estado do fornecedor ou contacta o suporte.

Problema: O EPG aparece nalguns canais mas não noutros

A cobertura parcial de EPG é normal em fornecedores mais pequenos. Podem não ter dados de EPG para todos os canais da sua rede, em particular canais regionais ou internacionais. Usa a ferramenta de mapeamento de canais do IPTV One para atribuir manualmente EPG de uma fonte de terceiros aos canais em falta.

Problema: O EPG carrega mas mostra conteúdo errado (por exemplo, BBC One mostra a programação da CNN)

Isto é uma colisão de ID de canal — dois canais partilham o mesmo identificador de EPG. Usa o mapeamento de canais para corrigir manualmente os canais afetados. Atribui cada um ao ID de canal de EPG correto.

Problema: A URL XMLTV não carrega

Verifica a URL num browser — se mostrar 403 ou 404, a URL expirou ou a tua subscrição caducou. A maioria das URLs de EPG de fornecedores contém tokens de autenticação que expiram com a subscrição. Obtém uma URL nova no portal de membro do teu fornecedor.

Problema: A grelha de EPG está vazia mesmo após adicionar a URL XMLTV

Verifica o formato do ficheiro XMLTV. O IPTV One suporta XMLTV padrão (elemento raiz <tv>, filhos <channel> e <programme>). Ficheiros XML não padronizados ou malformados não serão analisados corretamente. Testa a tua URL XMLTV num validador XMLTV online para confirmar que o ficheiro é válido.


Perguntas Frequentes

O que é uma URL de EPG para IPTV?

Uma URL de EPG é um endereço web que aponta para um ficheiro no formato XMLTV contendo dados de programação televisiva. Indica ao teu player IPTV o que está a passar, o que vem a seguir e a programação completa de 7 dias para cada canal. O teu fornecedor IPTV disponibiliza esta URL, que frequentemente tem o aspeto de http://fornecedor.com/epg.xml ou inclui o teu utilizador e senha como parâmetros. Para mais informações sobre formatos de playlist, consulta o nosso guia M3U vs Xtream Codes.

Por que razão o EPG não aparece no IPTV One?

Três causas comuns: (1) a tua playlist M3U não incorpora uma URL de EPG — adiciona-a manualmente em Definicoes > EPG; (2) o EPG carregou mas os nomes de canais não coincidem — usa a ferramenta de mapeamento de canais; (3) o servidor de EPG do teu fornecedor está em baixo — contacta o suporte. Consulta o nosso guia completo de configuração IPTV para instruções de configuração completas.

Posso usar uma fonte de EPG de terceiros com o IPTV One?

Sim. O IPTV One aceita qualquer URL XMLTV válida. Se o EPG do teu fornecedor estiver incompleto, podes complementá-lo com um agregador XMLTV público de terceiros que cubra a tua lista de canais. Adiciona a URL de terceiros como segunda fonte de EPG em Definicoes > EPG e usa o mapeamento de canais para a atribuir a canais específicos.

Com que frequência os dados de EPG são atualizados no IPTV One?

O IPTV One atualiza os dados de EPG a cada 24 horas por padrão. Podes alterar o intervalo em Definicoes > EPG > Intervalo de Atualizacao. Para canais de desporto ao vivo e notícias de última hora, recomenda-se um intervalo de atualização de 12 horas para garantir que a programação se mantém atual.


O Teu EPG Fica Pronto em Menos de Dois Minutos

Um guia de TV completo transforma o IPTV de uma lista de canais numa experiência televisiva a sério — mostrando o que está a passar, o que vem a seguir e a semana inteira à tua frente para cada canal. O IPTV One carrega o EPG automaticamente na maioria das fontes; para as que não o incorporam, adicionar a URL XMLTV manualmente demora um colar e um toque.

Descarrega o IPTV One gratuitamente — adiciona a tua playlist M3U e a fonte de EPG em qualquer plataforma, com sincronização na cloud a enviar ambas para todos os dispositivos da tua conta automaticamente.


O IPTV One é uma aplicação de reprodução multimédia. Não fornece, aloja nem distribui qualquer conteúdo de TV, canais ou subscrições. Os utilizadores são responsáveis por garantir que as suas fontes IPTV cumprem as leis e regulamentos aplicáveis na sua região.

Ready to try the best IPTV player?

Download IPTV One free on your preferred platform. 4K HDR, cloud sync, and multi-device support.

IPTV One is a media player application. It does not provide, host, or distribute any TV content. Users are responsible for their own content sources.