Come configurare l'EPG IPTV e correggere gli sfasamenti orari

Un orario EPG sbagliato non è quasi mai una guida rotta. È un timestamp letto rispetto al riferimento sbagliato. La griglia dei programmi mostra uno show che inizia due ore prima o dopo rispetto a quando va davvero in onda. I dati in sé di solito non sono corrotti. Vengono semplicemente interpretati rispetto all'orologio sbagliato da qualche parte tra la sorgente e il tuo schermo.

Le guide generiche di risoluzione dei problemi tendono a descrivere un unico "cursore universale per lo sfasamento orario dell'EPG", come se ogni app avesse lo stesso controllo. Non è così. C'è anche un avvertimento che viene saltato altrettanto spesso: se i dati della guida della tua sorgente sono già corretti e applichi sopra una correzione manuale, puoi trasformare una guida funzionante in una sbagliata. Questa guida copre come capire dove si trova davvero il problema. Poi copre esattamente la schermata che IPTV Expert ti offre per risolverlo.

Punti chiave

• I file XMLTV riportano il proprio fuso orario per ogni voce di programma. Se non ne viene indicato uno, si presume l'UTC: quindi una guida con "orario sbagliato" è spesso un problema di fuso orario lato sorgente, non un bug dell'app.
• La schermata delle impostazioni EPG di IPTV Expert ha quattro controlli per sorgente: Attiva, Aggiorna ora, Frequenza di aggiornamento e Spostamento orario.
• Lo Spostamento orario è una correzione solo a ore intere, da -12h a +12h, applicata quando l'app legge la guida in cache. Non riscrive il file XMLTV scaricato, e non può correggere uno sfasamento sub-orario (ad esempio 30 minuti).

Cos'è davvero uno sfasamento orario dell'EPG

Un EPG (guida elettronica dei programmi) è costruito a partire da un feed di dati separato sovrapposto al tuo elenco di canali. Per la maggior parte delle configurazioni IPTV quel feed è XMLTV. È un file XML che elenca i programmi, ciascuno con un attributo start e stop marcato con un formato specifico.

La documentazione di riferimento del formato XMLTV afferma la regola chiaramente. Date e orari "seguono lo stesso formato, basato liberamente su ISO 8601," scritti come YYYYMMDDhhmmss. E "puoi anche aggiungere un fuso orario alla fine; se non viene indicato esplicitamente un fuso orario, si presume l'UTC" (XMLTV DTD, xmltv.dtd). In altre parole, una voce di programma ben formata dovrebbe dichiarare il proprio scarto rispetto all'UTC. Quando lo fa, qualsiasi lettore conforme può convertirlo correttamente in ora locale. Quando non lo fa, o dichiara quello sbagliato, ogni guida a valle eredita quell'errore.

Ecco come appare in pratica, ridotto alle due righe che contano:

<!-- Sbagliato: nessun fuso orario esplicito aggiunto.
     Secondo la regola del DTD sopra, viene letto come UTC anche se
     l'emittente intendeva l'ora locale in una regione UTC+2. -->
<programme start="20260818200000" stop="20260818210000" channel="example.channel">
  <title>Telegiornale della sera</title>
</programme>

<!-- Corretto: scarto UTC esplicito aggiunto, secondo il formato
     di esempio dello stesso DTD ("19880523083000 +0300"). -->
<programme start="20260818200000 +0200" stop="20260818210000 +0200" channel="example.channel">
  <title>Telegiornale della sera</title>
</programme>

Entrambe le voci descrivono lo stesso orario nominale, 20:00. Solo la seconda dice inequivocabilmente a chi legge quale 20:00 sia. Supponi che la tua sorgente pubblichi voci nella forma del primo esempio, e che la tua regione di trasmissione reale non sia UTC. L'intera guida mostrerà orari spostati esattamente di quella differenza, comunemente di un piccolo numero di ore intere, coerente con le tipiche regioni con scarto UTC.

Diagnostica prima di correggere

Risposta diretta: controlla prima i dati XMLTV della sorgente stessa, poi l'orologio e il fuso orario del dispositivo, e per ultimo il controllo di scarto dell'app. Correggere il livello sbagliato somma un nuovo errore sopra quello reale invece di rimuoverlo.

1. Controlla se lo sfasamento è coerente su ogni canale e ogni giorno. Un problema di fuso orario lato sorgente, con scarto mancante o sbagliato nel feed XMLTV come mostrato sopra, di solito sposta ogni programma della stessa quantità fissa, sempre. Se è coerente, la correzione va fatta alla sorgente, o nel controllo Spostamento orario dell'app qui sotto. Non va fatta nelle impostazioni del dispositivo.
2. Controlla data, ora e fuso orario del tuo dispositivo. Se l'orologio o il fuso orario sono sbagliati a livello di sistema operativo, tutto ciò che l'app mostra come "adesso" viene misurato da un punto di riferimento falso. Questo altera quale programma appare come "in onda ora," anche se i dati XMLTV in sé sono corretti.
3. Solo a quel punto guarda il controllo di scarto EPG dell'app stessa. Se i primi due controlli sono a posto e la guida è ancora sfasata di un numero fisso di ore, un'impostazione di Spostamento orario per sorgente è lo strumento giusto. È trattata nel prossimo passaggio.

Saltare direttamente al passaggio 3 è il modo più comune di peggiorare le cose. Applicare uno spostamento manuale sopra una sorgente che già porta lo scarto corretto somma semplicemente le due correzioni nella direzione sbagliata.

Configurare la sorgente EPG in IPTV Expert

Risposta diretta: le impostazioni EPG si trovano su un'unica schermata per sorgente, con quattro controlli in ordine: Attiva, Aggiorna ora, Frequenza di aggiornamento e Spostamento orario.

1. Apri le impostazioni EPG per la tua sorgente attuale. Si raggiunge dal menu dell'app. Ogni controllo su questa schermata si applica alla sorgente attualmente selezionata. Se usi più di una sorgente, ciascuna ha le proprie impostazioni EPG indipendentemente.
2. Attiva. Un interruttore che accende o spegne il recupero dell'EPG per questa sorgente.
3. Aggiorna ora. Avvia uno scaricamento immediato dei dati della guida. Questa riga mostra anche la data dell'ultimo aggiornamento e quanti programmi sono attualmente in cache, così puoi confermare che un aggiornamento abbia effettivamente recuperato dati invece di fallire silenziosamente.
4. Frequenza di aggiornamento. Con quale frequenza l'app controlla se i dati della guida in cache sono abbastanza vecchi da essere riscaricati automaticamente (vedi la tabella sotto).
5. Spostamento orario. Mostra lo scarto attuale per sorgente, ad esempio -2h o +3h. Toccandolo si apre la schermata di correzione trattata nella sezione successiva.

Per le sorgenti M3U e Xtream Codes, la stessa schermata mostra anche un campo URL personalizzato. È precompilato con un segnaposto che mostra l'URL che l'app userebbe automaticamente. IPTV Expert risolve quell'URL automatico in un ordine fisso. Prima, un URL personalizzato che hai inserito tu stesso. Poi, per le sorgenti Xtream Codes, un URL costruito automaticamente dal tuo account nella forma {server}/xmltv.php?username={username}&password={password}. Poi un URL EPG fornito dalla playlist, se la tua M3U ne specifica uno. Se nessuno di questi esiste, non c'è EPG per quella sorgente. Inserire un valore personalizzato e salvare attiva l'EPG per quella sorgente e avvia un aggiornamento immediato. Svuotare il campo ripristina l'URL automatico. Le sorgenti Stalker Portal non mostrano affatto questo campo: usano invece un percorso di scaricamento EPG separato e dedicato.

Se un aggiornamento fallisce, IPTV Expert mostra un messaggio: "Errore durante l'aggiornamento dell'EPG." Quell'unico messaggio copre un URL sbagliato, un problema di rete e un file XMLTV malformato allo stesso modo. Non diagnostica quale sia avvenuto. Se un aggiornamento fallisce ripetutamente, ricontrollare l'URL stesso, incluso se necessita ancora delle credenziali che l'hanno costruito, è il primo passo più rapido. Se non hai ancora aggiunto una sorgente Xtream Codes, M3U o Stalker Portal, inizia da lì: Come configurare Xtream Codes in IPTV Expert, Come aggiungere una playlist M3U a IPTV Expert e Come configurare uno Stalker Portal in IPTV Expert coprono quei flussi. La risoluzione dell'URL EPG descritta qui presuppone che quella sorgente esista già.

Correggere uno sfasamento orario con lo Spostamento orario

Risposta diretta: lo Spostamento orario è una correzione per sorgente applicata a passi di un'ora intera, da -12h a +12h, quando l'app legge la guida in cache rispetto all'orologio. Non riscrive il file XMLTV scaricato.

1. Dalla schermata delle impostazioni EPG, tocca Spostamento orario.
2. Scegli uno scarto dall'elenco, mostrato da -12h a +12h a incrementi di 1 ora.
3. Conferma la tua selezione. L'app ti riporta alla schermata delle impostazioni EPG con il nuovo valore mostrato.

Ci sono due cose utili da sapere su come funziona davvero prima di scegliere un numero. Primo, la correzione è applicata per sorgente, non globalmente. Se usi più di una sorgente, ciascuna può avere un proprio valore di Spostamento orario, utile se il feed di un provider include già uno scarto corretto e quello di un altro no. Secondo, lo spostamento cambia solo ciò che l'app tratta come "adesso" quando abbina i programmi in cache all'orologio. Il file XMLTV sottostante su disco resta intatto.

Questo secondo punto pone un limite netto a ciò che questo controllo può correggere. I passi disponibili sono solo ore intere. Una sorgente la cui guida è sfasata di una quantità sub-oraria, 30 minuti è l'esempio più comune, non può essere corretta completamente solo con lo Spostamento orario. In quel caso la correzione deve avvenire alla sorgente, chiedendo al tuo provider informazioni sul fuso orario dichiarato dal suo feed, non nell'app.

Se la tua guida sembra corretta per una sorgente ma sbagliata per un'altra, è normale. Significa che i dati XMLTV sottostanti delle due sorgenti non concordano sul proprio scarto dichiarato, e ciascuna ha bisogno del proprio valore di Spostamento orario invece di un'unica impostazione condivisa.

Impostare la frequenza di aggiornamento

I dati della guida diventano obsoleti anche quando lo scarto orario è corretto, poiché i palinsesti cambiano. La frequenza di aggiornamento automatico di IPTV Expert controlla con quale frequenza verifica se la guida in cache è abbastanza vecchia da essere riscaricata:

L'app confronta il tempo trascorso dal tuo ultimo aggiornamento riuscito con questa impostazione ogni volta che passi a quella sorgente. Avvia un nuovo download solo dopo che quell'intervallo è trascorso. Una frequenza più breve mantiene i cambi di palinsesto aggiornati prima, al costo di download più frequenti.

Cosa non può correggere

Alcuni limiti vale la pena dichiararli apertamente invece di aggirarli:

• Nessun controllo di scarto sub-orario. Lo Spostamento orario si muove solo a passi di un'ora intera. Uno sfasamento di 30 minuti o altro parziale richiede una correzione lato sorgente, non un'impostazione dell'app.
• Nessun selettore per nome di fuso orario. Non c'è un elenco di fusi orari con nome, come una città o una regione, da cui scegliere. È solo uno scarto numerico in ore relativo alla guida attuale della tua sorgente.
• Messaggistica generica sul fallimento dell'aggiornamento. Un aggiornamento EPG fallito mostra un messaggio indipendentemente dalla causa. Un URL sbagliato, una caduta di rete e un file sorgente malformato appaiono tutti uguali dal lato dell'app.
• L'abbinamento dei canali dipende dalla sorgente. I dati della guida in cache vengono abbinati ai tuoi canali tramite l'identificatore di canale che il feed XMLTV e la tua playlist o account usano entrambi. Se il feed XMLTV di una sorgente usa identificatori di canale diversi dalla tua playlist, i dati dei programmi non si allineeranno con il canale giusto. È un problema di allineamento dei dati della sorgente, non qualcosa che lo Spostamento orario risolve.

Quale download dovresti usare?

Le impostazioni EPG funzionano allo stesso modo su ogni piattaforma su cui gira IPTV Expert, quindi non c'è nessun passaggio specifico per piattaforma da segnalare qui. Se hai già l'app installata, le impostazioni sopra si applicano direttamente. Se la stai installando per la prima volta, il selettore completo dei download di IPTV Expert copre ogni dispositivo supportato. Una volta installata, M3U o Xtream Codes: quale formato di accesso IPTV usare? è una lettura utile se non hai ancora deciso quale formato di sorgente aggiungere.