Un EPG (Electronic Program Guide) è il palinsesto televisivo a schermo che mostra che cosa è in onda adesso e che cosa arriva dopo sui tuoi canali, con titoli, orari, descrizioni e categorie in una griglia scorrevole. È l’erede digitale dei palinsesti stampati e ti permette di sfogliare la programmazione, leggere i dettagli dei programmi e spesso impostare promemoria o registrazioni. Questa guida spiega come funziona un EPG, il formato XMLTV che c’è dietro e come configurarne uno.
A che cosa serve un EPG
Un EPG è il palinsesto interattivo sovrapposto ai tuoi canali. A colpo d’occhio mostra di solito:
- Ora in onda e a seguire — che cosa sta andando in onda e che cosa arriva dopo su ogni canale.
- Una griglia temporale — i canali su un lato, un asse dei tempi scorrevole in alto.
- I dettagli dei programmi — titolo, orario di inizio e fine, una sinossi e spesso il genere o la classificazione per età.
- Le azioni — impostare un promemoria, far ripartire da capo un programma in diretta o programmare una registrazione dove è supportato.
Senza un EPG, una lista di canali IPTV è solo un elenco di nomi. È l’EPG a farla sembrare televisione vera, con una guida su cui puoi organizzare la serata.
Come funziona un EPG
Un EPG è un insieme di dati separato dalla tua lista dei canali, e i due vengono uniti dal player.
- La lista dei canali — di solito una playlist M3U — definisce quali canali esistono e dove si trova ogni flusso. Ogni canale porta con sé un identificatore chiamato
tvg-id. - I dati EPG — un file XMLTV — elencano i programmi e i loro orari, ciascuno legato a un identificatore di canale.
- L’abbinamento — il player collega un canale al suo palinsesto quando il
tvg-iddella playlist è uguale all’identificatore del canale nel file EPG.
Tutto il trucco sta in quell’identificatore condiviso. Quando coincide, ogni canale mostra il proprio palinsesto; quando non coincide, la guida resta vuota — ed è di gran lunga il problema più comune degli EPG.
Il formato XMLTV
Quasi tutti gli EPG per IPTV usano XMLTV, un formato XML aperto per i palinsesti TV. Un file XMLTV contiene due tipi di voci: le definizioni dei canali e le voci dei programmi.
<channel id="bbcone.uk">
<display-name>BBC One</display-name>
</channel>
<programme start="20260723183000 +0000" stop="20260723190000 +0000" channel="bbcone.uk">
<title>Evening News</title>
<desc>The day's top stories and weather.</desc>
</programme>
Nella pratica contano due dettagli:
- L’identificatore
channeldeve coincidere con iltvg-iddella playlist. Nell’esempio sono entrambibbcone.uk. È questo collegamento a far comparire la guida. - Gli orari includono un fuso orario (
+0000qui sopra). Se il fuso orario del player è impostato male, i programmi appaiono spostati di alcune ore.
I file EPG vengono spesso serviti compressi in gzip come .xml.gz per risparmiare banda, dato che una settimana intera di palinsesti per centinaia di canali è pesante. I player li decomprimono in automatico.
Come configurare un EPG
Aggiungere un EPG è un lavoro breve e da fare una volta sola nella maggior parte dei player:
- Procurati l’URL dell’EPG. La tua fonte con licenza fornisce un link XMLTV (
.xmlo.xml.gz). - Apri le impostazioni EPG del player. In app come TiviMate o IPTV Smarters cerca «EPG» o «Guide».
- Incolla l’URL e salva.
- Lascia che scarichi i dati. Il primo aggiornamento può richiedere un minuto per le guide più grandi.
- Imposta l’intervallo di aggiornamento e il fuso orario. Un aggiornamento automatico quotidiano tiene la guida aggiornata; il fuso orario corretto mantiene i programmi allineati.
Per una procedura specifica per app, segui la nostra guida alla configurazione di TiviMate e vedi come si incastra il lato playlist in cos’è una playlist M3U.
Consiglio: usa una fonte EPG pensata per la tua lista di canali, così i suoi identificatori di canale coincidono già con i tvg-id della tua playlist. Mescolare una playlist e un EPG scollegati è il motivo principale per cui le guide restano vuote.
Riparare un EPG che non funziona
Se la guida è vuota, sbagliata o spostata negli orari, procedi in quest’ordine:
| Sintomo | Causa probabile | Soluzione |
|---|---|---|
| Guida completamente vuota | tvg-id ≠ identificatore del canale nell’EPG | Allinea gli identificatori oppure usa una fonte EPG corrispondente |
| Alcuni canali senza guida | A quei canali manca il tvg-id | Aggiungi il tvg-id corretto a quelle voci della playlist |
| Orari spostati di ore | Fuso orario sbagliato nell’app | Imposta il fuso orario corretto nelle impostazioni |
| La guida non si aggiorna più | URL scaduto o aggiornamento automatico assente | Aggiorna l’URL dell’EPG; attiva l’aggiornamento quotidiano |
| Dati vecchi dopo le modifiche | Guida in cache | Forza un aggiornamento dell’EPG / svuota la cache della guida nell’app |
Quasi tutti i problemi di EPG si riducono a quella corrispondenza di tvg-id. Allinea gli identificatori e il resto di solito va a posto da sé.
In sintesi
Un EPG è il palinsesto interattivo che trasforma una semplice lista di canali in televisione vera: ora in onda e a seguire, una griglia da sfogliare e i dettagli dei programmi. Dietro le quinte è un file XMLTV, unito ai tuoi canali da un tvg-id condiviso. Incolla nel player l’URL dell’EPG giusto, fai coincidere gli identificatori, imposta il fuso orario corretto e ottieni una guida completa che si aggiorna da sola.
Il passo successivo è capire il lato della lista dei canali con cos’è una playlist M3U, oppure partire dalle basi con cos’è l’IPTV.
Un termine di questa pagina non ti è chiaro? Cercalo nel glossario dello streaming.