Como Configurar a EPG do IPTV e Corrigir Desvios de Fuso Horário

Uma hora errada na EPG quase nunca é um guia avariado. É um carimbo temporal lido face à referência errada. A grelha de programação mostra um programa a começar duas horas antes ou depois do horário real de emissão. Os dados em si normalmente não estão corrompidos. Estão simplesmente a ser interpretados face ao relógio errado, algures entre a fonte e o seu ecrã.

Os guias genéricos de resolução de problemas costumam descrever um único "controlo de desvio de horário da EPG" universal, como se todas as apps tivessem o mesmo controlo. Não têm. Há também um aviso que é ignorado com a mesma frequência: se os dados de guia da sua fonte já estiverem corretos e aplicar uma correção manual por cima, pode transformar um guia funcional num guia errado. Este guia cobre como perceber onde está de facto o problema. Depois cobre o ecrã exato que o IPTV Expert lhe dá para o corrigir.

Principais conclusões

• Os ficheiros XMLTV transportam o seu próprio fuso horário por cada entrada de programa. Se nenhum for indicado, assume-se UTC — por isso um guia com "hora errada" é muitas vezes um problema de fuso horário do lado da fonte, não um erro da app.
• O ecrã de definições de EPG do IPTV Expert tem quatro controlos por fonte: Ativar, Atualizar agora, Frequência de atualização, e Time shift.
• O Time shift é uma correção apenas em horas inteiras, de -12h a +12h, aplicada quando a app lê o guia em cache. Não reescreve o ficheiro XMLTV transferido, e não consegue corrigir um desvio inferior a uma hora (por exemplo, de 30 minutos).

O que é, de facto, um desvio de horário na EPG

Uma EPG (guia eletrónico de programação) é construída a partir de um feed de dados separado, sobreposto à sua lista de canais. Na maioria das configurações IPTV, esse feed é XMLTV. É um ficheiro XML que lista programas, cada um com um atributo start e stop num formato específico.

A própria documentação de referência do formato XMLTV estabelece a regra claramente. As datas e horas "seguem o mesmo formato, vagamente baseado em ISO 8601", escrito como AAAAMMDDhhmmss. E "também pode acrescentar um fuso horário no final; se nenhum fuso horário explícito for indicado, assume-se UTC" (XMLTV DTD, xmltv.dtd). Por outras palavras, uma entrada de programa bem formada deve declarar o seu próprio desvio face ao UTC. Quando o faz, qualquer leitor compatível consegue convertê-lo corretamente para hora local. Quando não o faz, ou declara o errado, todos os guias a jusante herdam esse erro.

Eis como isso se traduz na prática, reduzido às duas linhas que importam:

<!-- Errado: sem fuso horário explícito acrescentado.
     Segundo a regra do DTD acima, isto é lido como UTC mesmo
     que o emissor quisesse dizer hora local numa região UTC+2. -->
<programme start="20260818200000" stop="20260818210000" channel="exemplo.canal">
  <title>Jornal da Noite</title>
</programme>

<!-- Correto: desvio UTC explícito acrescentado, segundo o
     próprio exemplo de formato do DTD ("19880523083000 +0300"). -->
<programme start="20260818200000 +0200" stop="20260818210000 +0200" channel="exemplo.canal">
  <title>Jornal da Noite</title>
</programme>

Ambas as entradas descrevem a mesma hora nominal, 20:00. Só a segunda diz sem ambiguidade a que 20:00 se refere. Suponha que a sua fonte publica entradas com a forma do primeiro exemplo, e a sua região de emissão real não é UTC. Todo o guia vai mostrar horas desviadas exatamente por essa diferença — normalmente um pequeno número de horas inteiras, correspondendo a regiões típicas de desvio UTC.

Diagnostique antes de corrigir

Resposta direta: verifique primeiro os próprios dados XMLTV da fonte, depois o relógio e o fuso horário do seu dispositivo, e só depois o próprio controlo de desvio da app. Corrigir a camada errada empilha um novo erro sobre o real, em vez de o remover.

1. Verifique se o desvio é consistente em todos os canais e todos os dias. Um problema de fuso horário do lado da fonte — desvio em falta ou errado no feed XMLTV, como mostrado acima — normalmente desvia todos os programas pela mesma quantidade fixa, sempre. Se for consistente, a correção pertence à fonte, ou ao controlo Time shift da app abaixo. Não pertence às definições do seu dispositivo.
2. Verifique a data, hora e fuso horário do seu dispositivo. Se o relógio ou o fuso horário estiverem errados ao nível do sistema operativo, tudo o que a app mostra como "agora" é medido a partir de um ponto de referência falso. Isso desvia o que é lido como "atualmente em exibição", mesmo que os dados XMLTV em si estejam corretos.
3. Só depois olhe para o próprio controlo de desvio de EPG da app. Se as duas primeiras verificações estiverem limpas e o guia continuar desviado por um número fixo de horas, uma definição de Time shift por fonte é a ferramenta certa. É coberta a seguir.

Saltar diretamente para o passo 3 é a forma mais comum de piorar as coisas. Aplicar um desvio manual sobre uma fonte que já transporta o desvio correto apenas soma as duas correções na direção errada.

Configure a fonte de EPG no IPTV Expert

Resposta direta: as definições de EPG vivem num único ecrã por fonte, com quatro controlos por ordem: Ativar, Atualizar agora, Frequência de atualização, e Time shift.

1. Abra as definições de EPG da sua fonte atual. Acede-se a partir do menu da app. Todos os controlos deste ecrã aplicam-se à fonte atualmente selecionada. Se usar mais do que uma fonte, cada uma tem as suas próprias definições de EPG de forma independente.
2. Ativar. Um interruptor que liga ou desliga a obtenção de EPG para esta fonte.
3. Atualizar agora. Aciona uma transferência imediata dos dados do guia. Esta linha também mostra a data da última atualização e quantos programas estão atualmente em cache, para poder confirmar que uma atualização realmente obteve dados em vez de falhar silenciosamente.
4. Frequência de atualização. Com que frequência a app verifica se os dados de guia em cache estão suficientemente antigos para serem transferidos de novo automaticamente (ver tabela abaixo).
5. Time shift. Mostra o desvio atual por fonte, por exemplo -2h ou +3h. Tocar nele abre o ecrã de correção coberto na secção seguinte.

Para fontes M3U e Xtream Codes, o mesmo ecrã mostra também um campo de URL personalizado. Vem pré-preenchido com um exemplo que mostra o URL que a app usaria automaticamente. O IPTV Expert resolve esse URL automático por uma ordem fixa. Primeiro, um URL personalizado que tenha introduzido você mesmo. Depois, para fontes Xtream Codes, um URL construído automaticamente a partir da sua conta, na forma {servidor}/xmltv.php?username={utilizador}&password={palavra-passe}. Depois um URL de EPG fornecido pela playlist, se a sua M3U indicar um. Se nenhum destes existir, não há EPG para essa fonte. Introduzir o seu próprio valor e guardar ativa a EPG para essa fonte e aciona uma atualização imediata. Limpar o campo reverte para o URL automático. As fontes Stalker Portal não mostram este campo de todo — usam antes uma via de transferência de EPG separada e dedicada.

Se uma atualização falhar, o IPTV Expert mostra uma mensagem: "Erro ao atualizar a EPG." Essa única mensagem cobre um URL avariado, um problema de rede e um ficheiro XMLTV mal formado, da mesma forma. Não diagnostica qual ocorreu. Se uma atualização falhar repetidamente, voltar a verificar o próprio URL — incluindo se ainda precisa das credenciais que o construíram — é o primeiro passo mais rápido. Se ainda não adicionou uma fonte Xtream Codes, M3U ou Stalker Portal, comece antes por aí: Como Configurar o Xtream Codes no IPTV Expert, Como Adicionar uma Playlist M3U ao IPTV Expert e Como Configurar um Stalker Portal no IPTV Expert cobrem esses fluxos. A resolução de URL de EPG descrita aqui depende de essa fonte já existir.

Corrija um desvio de horário com o Time shift

Resposta direta: o Time shift é uma correção por fonte, aplicada em passos de horas inteiras, de -12h a +12h, quando a app lê o guia em cache face ao relógio. Não reescreve o ficheiro XMLTV transferido.

1. No ecrã de definições de EPG, toque em Time shift.
2. Escolha um desvio na lista, apresentado de -12h a +12h em incrementos de 1 hora.
3. Confirme a sua escolha. A app devolve-o ao ecrã de definições de EPG com o novo valor apresentado.

Vale a pena saber duas coisas sobre como isto funciona antes de escolher um número. Primeiro, a correção é aplicada por fonte, não globalmente. Se usar mais do que uma fonte, cada uma pode ter o seu próprio valor de Time shift — útil se o feed de um fornecedor já incluir um desvio correto e o de outro não. Segundo, o desvio só muda o que a app trata como "agora" ao comparar programas em cache com o relógio. O ficheiro XMLTV subjacente no disco não é alterado.

Esse segundo ponto define um limite rígido do que este controlo consegue corrigir. Os passos disponíveis são apenas em horas inteiras. Uma fonte cujo guia esteja desviado por uma quantidade inferior a uma hora — 30 minutos é o exemplo mais comum — não pode ser totalmente corrigida apenas com o Time shift. Nesse caso, a correção tem de acontecer na fonte, perguntando ao seu fornecedor sobre o fuso horário declarado no seu feed, e não na app.

Se o seu guia parecer correto para uma fonte mas errado para outra, isso é esperado. Significa que os dados XMLTV subjacentes das duas fontes discordam sobre o seu próprio desvio declarado, e cada uma precisa do seu próprio valor de Time shift, em vez de uma definição partilhada.

Defina a frequência de atualização

Os dados do guia ficam desatualizados mesmo quando o desvio de horário está correto, já que os horários de emissão mudam. A frequência de atualização automática do IPTV Expert controla com que regularidade verifica se o guia em cache está suficientemente antigo para ser transferido de novo:

A app compara o tempo desde a sua última atualização bem-sucedida com esta definição, sempre que muda para essa fonte. Só aciona uma nova transferência depois de esse intervalo ter passado. Uma frequência mais curta mantém as mudanças de horário atualizadas mais depressa, ao custo de transferências mais frequentes.

O que isto não consegue corrigir

Vale a pena afirmar claramente algumas limitações, em vez de tentar contorná-las:

• Sem controlo de desvio inferior a uma hora. O Time shift move-se apenas em passos de horas inteiras. Um desvio de 30 minutos ou outra fração de hora precisa de uma correção do lado da fonte, não de uma definição na app.
• Sem seletor de nome de fuso horário. Não existe uma lista de fusos horários com nome, como uma cidade ou região, para escolher. É apenas um desvio numérico de horas relativo ao guia atual da sua fonte.
• Mensagens genéricas de falha de atualização. Uma atualização de EPG falhada mostra uma mensagem, independentemente da causa. Um URL avariado, uma quebra de rede e um ficheiro de fonte mal formado têm todos o mesmo aspeto do lado da app.
• A correspondência de canais depende da fonte. Os dados de guia em cache são associados aos seus canais pelo identificador de canal que o feed XMLTV e a sua playlist ou conta usam ambos. Se o feed XMLTV de uma fonte usar identificadores de canal diferentes dos da sua playlist, os dados de programação não vão corresponder ao canal certo. É um problema de alinhamento de dados da fonte, não algo que o Time shift resolva.

Que download deve usar?

As definições de EPG funcionam da mesma forma em todas as plataformas onde o IPTV Expert está disponível, por isso não há nenhum passo específico de plataforma a assinalar aqui. Se já tem a app instalada, as definições acima aplicam-se diretamente. Se a está a instalar pela primeira vez, o seletor completo de downloads do IPTV Expert cobre todos os dispositivos suportados. Depois de instalada, M3U vs Xtream Codes: Que Formato de Login IPTV Deve Usar? é uma leitura útil se ainda não decidiu qual formato de fonte adicionar.