EPG sta per Electronic Program Guide, ossia guida elettronica ai programmi: l'elenco di cosa va in onda su ciascun canale, ora e dopo. È la striscia che vedi in basso sui decoder via cavo ("19:30 I Simpson / 20:00 I Griffin"), ed è quella cosa che fa sembrare una lista canali una televisione e non un muro di stream senza etichetta.

Nell'IPTV, l'EPG non fa parte della lista canali. È un file separato. Questo singolo dettaglio spiega più o meno il 90% della confusione che incontrano i nuovi utenti.

Cosa c'è in un file EPG

I dati EPG vengono distribuiti come XMLTV — un formato XML usato praticamente da ogni player IPTV. Una piccola fetta è così:

<channel id="bbc1.uk">
  <display-name>BBC One HD</display-name>
</channel>

<programme start="20260512183000 +0000" stop="20260512190000 +0000" channel="bbc1.uk">
  <title>BBC News at Six</title>
  <desc>The day's national and international news.</desc>
</programme>

Due tipi di voci: canali (solo un ID e un nome) e programmi (un ID, un'ora di inizio/fine, un titolo, una descrizione, a volte una categoria e un numero di episodio). Un vero file EPG ne contiene decine di migliaia — una o due settimane di palinsesto per ogni canale del provider.

Come l'EPG si lega alla lista canali

Ogni <programme> ha un attributo channel="bbc1.uk". Ogni riga #EXTINF nell'M3U ha tvg-id="bbc1.uk". Il player li abbina per uguaglianza di stringa. Se gli ID coincidono, vedi il palinsesto. Se non coincidono, il canale si vede bene ma compare "nessuna informazione".

È il singolo bug più comune nelle configurazioni IPTV. L'M3U dice tvg-id="bbc.one.hd"; l'EPG dice <channel id="bbc1.uk">; il player non può sapere che si riferiscono allo stesso canale.

Schermata principale di un telefono che mostra righe di canali, ciascuna annotata con il programma in corso.

Quando gli ID coincidono, ogni riga di canale mostra cosa va in onda adesso.

Da dove arriva davvero l'EPG

La maggior parte dei provider IPTV fornisce due cose: un URL M3U per i canali e un secondo URL per l'XMLTV. Per i provider Xtream Codes l'XMLTV si trova quasi sempre a:

http://<server>/xmltv.php?username=<u>&password=<p>

Per i provider non-Xtream può essere ovunque — te lo manderanno per email o ti diranno di scaricare un file statico. In entrambi i casi il formato è lo stesso.

Alcuni player IPTV includono anche fonti EPG di comunità — file XMLTV gratuiti e pubblici mantenuti da volontari per migliaia di canali. Il progetto EPG di iptv-org è il più noto. Esistono perché gli EPG forniti dai provider sono notoriamente inaffidabili, e una guida di comunità ben mantenuta è spesso più accurata di quella per cui stai pagando.

Perché il tuo EPG potrebbe essere vuoto

Grossomodo in ordine di frequenza:

  1. Non hai aggiunto una fonte EPG. Tipico. Importare l'M3U non scarica automaticamente la guida; devi aggiungere l'URL XMLTV a parte.
  2. Il tvg-id e il channel id non coincidono. I canali si vedono bene, la guida è caricata, ma il player non riesce a capire quale programma appartenga a quale canale. Apri il file EPG nel browser e controlla quali ID usa davvero.
  3. Il fuso orario è sfalsato di ore. I programmi sono elencati correttamente ma compaiono all'orario sbagliato, quindi la voce "in onda ora" non sembra mai attuale. L'attributo start dell'XMLTV contiene l'informazione sul fuso orario; alcuni provider la rimuovono o la corrompono. Vedi la nostra guida per sistemare i fusi orari dell'EPG.
  4. Il file XMLTV è troppo grande per essere analizzato. Alcuni provider Xtream distribuiscono file XMLTV da 200 MB con mesi di palinsesto. Alcuni player vanno in timeout. Il validator EPG su questo sito ti dice se il file viene analizzato senza problemi.
  5. L'URL XMLTV restituisce HTML. Stessa modalità di errore dell'equivalente M3U — il provider richiede un cookie di sessione o ha applicato un rate-limit al tuo IP. Prova con una rete diversa.

Trovi una diagnosi passo passo più estesa nella guida alla risoluzione dell'EPG su Android TV.

Cosa ti dà un buon EPG

Tre benefici concreti che giustificano il setup:

  • Overlay ora/dopo. Premere su sul telecomando mentre un canale è in riproduzione ti mostra cosa va in onda adesso e cosa subito dopo. È la funzione più usata di qualsiasi interfaccia TV.
  • Ricerca nel palinsesto. "A che ora c'è la partita?" diventa una risposta da un secondo invece di dieci minuti di zapping.
  • Promemoria e visione programmata. Molti player (Klipa compreso) ti permettono di impostare promemoria sulle voci dell'EPG.

Se guardi solo una manciata di canali di cui conosci già il palinsesto, l'EPG è un di più piacevole. Se sfogli la lista di un provider con 200 canali senza idea di cosa ci sia su ciascuno, l'EPG è ciò che rende l'IPTV usabile.

Cosa non è un EPG

Non è un palinsesto di registrazione (anche se alcuni player PVR lo usano come tale). Non fa parte della lista canali. Non è firmato né autenticato — chiunque può fornire dati EPG per qualunque canale, ed è per questo che esistono progetti EPG di comunità.

È solo un elenco di "questo canale manderà questo programma a questo orario". La parte difficile è far combaciare gli ID.