EPG · XMLTV

Che cos’è l’EPG?

L’EPG, la guida elettronica dei programmi, è l’elenco di cosa va in onda su ogni canale e quando. Per l’IPTV arriva quasi sempre come file XMLTV: un unico documento con un proprio indirizzo, che un player scarica e dispone come una guida.

Lumen·TV è un player IPTV per Android TV, Google TV, Fire TV e telefoni e tablet Android. Richiede Android 8.0 o successivo. Riproduce la playlist M3U o Xtream Codes che ha già e non include canali. 21 giorni gratis, poi 0,99 € al mese per un dispositivo, oppure 19,99 € una tantum per 2 dispositivi, o 29,99 € una tantum per 5. La prova non richiede carta e finisce da sola.

Aggiornato il 28 ottobre 2026

Che cosa contiene un file XMLTV.

Due tipi di voce. Un <channel> per ogni canale coperto dalla guida, con un id e un nome; e un <programme> per ogni programma, che indica il suo canale con quell’id, con un inizio, una fine, un titolo e spesso una descrizione.

<tv>
  <channel id="news24.example">
    <display-name>News 24</display-name>
  </channel>
  <programme channel="news24.example" start="20261021190000 +0200" stop="20261021200000 +0200">
    <title>Evening bulletin</title>
    <desc>Headlines, weather, sport.</desc>
  </programme>
</tv>

Un canale e uno dei suoi programmi. Ogni orario porta il proprio scostamento da UTC, qui due ore avanti.

Le dimensioni: Una settimana di programmi per una playlist grande arriva a molti megabyte, quindi le guide sono spesso pubblicate compresse, come .xml.gz.
Fin dove arriva: Fin dove la riempie chi la pubblica: qualche giorno, una settimana, a volte di più.

Come una guida trova i suoi canali: tvg-id.

La guida e la playlist sono file separati, spesso da fonti diverse, e una sola cosa li collega: il tvg-id sulla riga di un canale nella playlist M3U deve essere esattamente l’id di un canale della guida. tvg-id="news24.example" trova i programmi di channel="news24.example"; tvg-id="News24" non ne trova nessuno.

Quindi, quando una guida si carica ma non mostra nulla per i suoi canali, di solito il motivo è che i due file chiamano i canali in modo diverso, e solo chi li pubblica può metterli d’accordo. Un server Xtream Codes pubblica insieme l’elenco dei canali e la guida, ed è per questo che di solito coincidono.

Da dove arriva l’indirizzo della guida.

Con un login Xtream Codes: Il server pubblica la guida su xmltv.php, aperta con lo stesso nome utente e la stessa password, quindi un player può trovarla da solo. Si veda che cos’è Xtream Codes.
Con una playlist M3U: La guida è un secondo indirizzo, che i fornitori di solito pubblicano accanto al link della playlist. Alcuni lo scrivono sulla prima riga della playlist, come url-tvg; che un player lo legga da lì dipende dal player.
Da un’altra fonte: Va bene qualsiasi indirizzo XMLTV, purché i suoi id corrispondano a quelli della playlist.

Che cosa fa Lumen·TV con una guida.

Una guida per playlist, disegnata come un palinsesto da sfogliare mezz’ora o un giorno alla volta, e come adesso e a seguire sopra l’immagine.
Tanti giorni quanti ne pubblica il suo fornitore, fino a sette.
Un login Xtream Codes, o un link get.php, trova la sua guida da solo. Una semplice M3U ha bisogno che l’indirizzo della guida sia indicato a parte: Lumen·TV non legge quello scritto dentro la playlist. Aggiungere una guida, passo dopo passo.
Abbina i programmi ai canali solo tramite tvg-id, e legge una guida pubblicata compressa (.xml.gz) come una non compressa.
Dice perché una guida è vuota: nessun indirizzo, un indirizzo che non contiene programmi, canali senza tvg-id, id che non corrispondono a nulla, o una guida che il fornitore ha smesso di aggiornare.
Più guide unite in una, uno sfasamento orario della guida e i promemoria non fanno parte dell’app.