In breve
L'EPG (Electronic Program Guide) è il palinsesto che il player mostra accanto ai canali. Nell'IPTV arriva da un file separato in formato XMLTV, indipendente dalla playlist.
Il collegamento fra i due avviene tramite un identificatore: l'attributo tvg-id nella playlist deve coincidere esattamente con l'attributo id del canale nel file XMLTV. Se non coincide, quel canale resta senza palinsesto anche se entrambi i file sono corretti presi singolarmente.
Con un portale Xtream Codes il problema in genere non si pone: canali ed EPG arrivano dalla stessa API, già associati.
Come sono collegati playlist ed EPG
Sono due file distinti che si incontrano su una chiave.
Nella playlist, ogni canale porta un identificatore:
#EXTINF:-1 tvg-id="canale.uno.it" tvg-name="Canale Uno",Canale Uno
https://esempio.tld/live/canale-uno/index.m3u8Nel file XMLTV, lo stesso identificatore compare come attributo del canale, e i programmi vi fanno riferimento:
<channel id="canale.uno.it">
<display-name>Canale Uno</display-name>
</channel>
<programme start="20260904203000 +0100" stop="20260904223000 +0100" channel="canale.uno.it">
<title>Nome del programma</title>
</programme>Il player carica entrambi e li unisce confrontando tvg-id con channel id. Il confronto è esatto: maiuscole, punti e spazi contano. Canale.Uno.it e canale.uno.it sono due canali diversi.
I quattro problemi ricorrenti
La guida è completamente vuota
La sorgente EPG non è configurata, oppure l'indirizzo non risponde. Verifica prima di tutto che il player abbia effettivamente un indirizzo EPG impostato: molti client non lo segnalano, mostrano semplicemente una guida vuota. Se l'indirizzo c'è, aprilo in un browser: deve restituire XML, non una pagina di errore.
La guida c'è solo per alcuni canali
È il caso più comune ed è quasi sempre un disallineamento di tvg-id. I canali che funzionano hanno identificatori corrispondenti, gli altri no. Alcuni client permettono di associare manualmente un canale a una voce dell'EPG: è la soluzione pratica quando i canali senza palinsesto sono pochi.
Gli orari sono sfasati
Il formato XMLTV include il fuso orario nella data (+0100). Uno sfasamento di una o due ore indica che la sorgente lo omette o lo dichiara in modo errato, e il player lo interpreta come ora locale. Molti client hanno un'opzione di correzione manuale dell'offset.
La guida mostra programmi sbagliati
Due canali condividono lo stesso tvg-id, oppure la sorgente EPG appartiene a un altro paese e i nomi si sovrappongono. Si riconosce perché il palinsesto è coerente ma riferito a un'altra emittente.
Quanti giorni caricare
Quasi tutti i client permettono di scegliere quanti giorni di palinsesto tenere in memoria. È un'impostazione che incide sulle prestazioni più di quanto sembri: un file XMLTV con settimane di programmazione per centinaia di canali può pesare decine di megabyte, e va analizzato a ogni avvio.
Su dispositivi con poca memoria — chiavette, TV box economici — ridurre la finestra a due o tre giorni è spesso ciò che trasforma un'app che si chiude da sola in un'app utilizzabile. Il tema è collegato ai limiti hardware descritti nelle pagine su Fire TV Stick e box e decoder.
Playlist e portale: due comportamenti diversi
| Aspetto | Playlist M3U + XMLTV | Portale Xtream Codes |
|---|---|---|
| Numero di sorgenti | Due, da configurare separatamente | Una sola |
| Corrispondenza canali/EPG | A carico dell'utente | Gestita dal server |
| Aggiornamento | Il player riscarica l'XMLTV a intervalli | L'API risponde su richiesta |
| Quando qualcosa non torna | Verifichi tu i tvg-id | Il problema è lato server |
Se hai la possibilità di scegliere e il tuo player supporta Xtream Codes, la seconda strada elimina l'intera categoria di problemi descritta in questa pagina. Il supporto dichiarato dalle singole app è nella tabella comparativa.
Domande frequenti
Qual è la migliore sorgente EPG per l'Italia?
Se il servizio a cui sei abbonato ne fornisce una, è quella: è allineata alla sua playlist per costruzione. Le sorgenti generiche richiedono quasi sempre un lavoro di riallineamento dei tvg-id.
L'EPG occupa banda?
Solo al momento dello scaricamento, che avviene una volta al giorno o secondo l'intervallo impostato. Durante la riproduzione non consuma nulla.
Posso modificare un file XMLTV a mano?
Sì, è testo. Per correggere pochi identificatori è praticabile; per una lista intera è un lavoro che va automatizzato.
Perché la guida sparisce dopo qualche giorno?
Perché la sorgente non è stata aggiornata o il player non riesce più a scaricarla. Verifica che l'indirizzo risponda ancora.
EPG e catch-up sono la stessa cosa?
No. L'EPG descrive cosa va in onda; il catch-up è la possibilità di tornare indietro su un programma già trasmesso, e richiede che sia il server a conservarlo.