Varpa
EN IT

$ guide · 6 min di lettura

Come aggiungere la guida TV (EPG) alla tua playlist IPTV

Se i canali mostrano solo il nome e nessun programma, la guida TV manca oppure non corrisponde ai canali. Ecco come la guida entra nella playlist e come sistemarla.

Aggiornata: 21 novembre 2026

Cosa sono EPG e XMLTV

EPG (Electronic Programme Guide) è la guida TV: titoli, orari e descrizioni di ciò che trasmette ogni canale. Nell'IPTV arriva quasi sempre come file XMLTV, un documento XML (spesso compresso in .xml.gz) che elenca canali e programmi dei giorni successivi.

Playlist e guida sono due file separati. Il lettore deve scaricarli entrambi e abbinare ogni canale ai suoi programmi.

Come la playlist indica la guida

La prima riga di una playlist M3U può contenere l'indirizzo della guida:

#EXTM3U url-tvg="https://example.com/guide.xml.gz"

Alcuni fornitori scrivono x-tvg-url invece di url-tvg; Varpa legge entrambi. Con l'accesso al server la guida arriva dal server stesso, quindi non c'è niente da impostare.

Come viene abbinato ogni canale

Ogni riga del canale ha un id, e lo stesso id deve esistere nel file XMLTV:

#EXTINF:-1 tvg-id="news24.example" tvg-logo="…" group-title="News",News 24
https://example.com/live/news24.m3u8
<channel id="news24.example">…</channel>
<programme channel="news24.example" start="20261121200000 +0000" stop="…">…

Se tvg-id e channel id sono identici, la guida compare. Se differiscono anche di un solo carattere, quel canale resta senza programmi.

Cosa ottieni in Varpa

  • Su ogni canale: il programma in onda, una barra con il tempo rimanente e cosa viene dopo.
  • Una guida a griglia per giorno e categoria: tocca il programma in onda per avviare il canale.
  • Le informazioni sul programma dentro il player, senza fermare il video.
  • La guida copre da 6 ore prima a 48 ore dopo, e viene ricaricata a ogni importazione della playlist e una volta al giorno.

Se per un canale non ci sono dati nella guida, Varpa lascia lo spazio vuoto invece di mostrare un testo di riempimento.

Guida vuota o sbagliata: i controlli

  1. C'è l'indirizzo della guida? Apri il link della playlist nel browser e guarda la prima riga. Niente url-tvg? Chiedi al fornitore il link EPG.
  2. Il link della guida funziona? Incollalo nel browser: dovrebbe scaricare un file. Una pagina di errore significa che la guida è offline.
  3. Gli id corrispondono? I canali di un fornitore con la guida di un altro raramente coincidono. Usa la guida fornita dal tuo fornitore.
  4. Gli orari sono sfasati? Gli orari XMLTV includono il fuso (+0000). Una guida con il fuso sbagliato sarà avanti o indietro di una o due ore su tutti i canali: va corretta da chi la pubblica.
  5. Ricarica: dopo che il fornitore ha sistemato qualcosa, aggiorna la playlist per scaricare di nuovo la guida.

Controllo rapido: nel file della guida cerca il tvg-id di un canale che non mostra niente. Se non lo trovi, hai trovato il problema.

Domande

Perché la guida TV è vuota?

Di solito la playlist non contiene l'indirizzo della guida, il file della guida non è raggiungibile oppure il tvg-id dei canali non corrisponde agli id del file XMLTV.

Ogni quanto si aggiorna la guida?

In Varpa la guida viene ricaricata a ogni importazione della playlist e una volta al giorno, e copre da 6 ore prima a 48 ore dopo.

Posso usare la guida di un altro fornitore?

Solo se gli id dei canali corrispondono ai tvg-id della tua playlist. Mescolare sorgenti è la causa più comune di programmi sbagliati.