Come aggiungere una guida ai programmi EPG alla tua app
Pubblicato il 3 min di lettura

Una guida elettronica ai programmi, o EPG, trasforma un semplice elenco di canali in qualcosa da sfogliare come una rivista TV. Mostra cosa va in onda ora, cosa segue e spesso una breve descrizione. Impostarla bene richiede un po’ di pazienza, perché questi dati viaggiano normalmente separati dal video.
Come funzionano i dati della guida
La maggior parte delle app legge l’EPG in un formato chiamato XMLTV. Una fonte XMLTV è un file, spesso compresso con gzip, che elenca canali e programmi con orari di inizio e fine. L’app lo scarica periodicamente e salva il palinsesto sul dispositivo.
Il punto cruciale è il collegamento tra le due liste. Ogni canale della playlist può avere un identificativo, di solito in un campo chiamato tvg-id. Anche la guida usa identificativi. Quando coincidono, i programmi compaiono accanto al canale giusto. Quando non coincidono, il canale resta vuoto, anche se la guida si è caricata correttamente.
Cosa serve prima
- Una lista di canali che si carichi e funzioni già. In caso contrario, consulta la guida per il tuo dispositivo.
- Una fonte per la guida. Il tuo servizio può fornire un indirizzo XMLTV o inviare i dati automaticamente tramite l’accesso al server.
- Data, ora e fuso orario corretti sul dispositivo.
Aggiungere una fonte passo dopo passo
I menu variano, ma la sequenza è quasi sempre la stessa:
- Apri le impostazioni dell’app e cerca una sezione chiamata EPG, Guida TV o Fonti.
- Aggiungi una fonte e inserisci l’indirizzo XMLTV esattamente come ti è stato fornito.
- Collega la fonte alla playlist se l’app lo chiede.
- Avvia un aggiornamento e attendi. Un file grande può richiedere diversi minuti su una chiavetta.
- Apri la vista della guida e controlla alcuni canali noti.
Se accedi con indirizzo del server, nome utente e password, guarda la guida prima di aggiungere qualcosa. Molte app scaricano i programmi automaticamente con questo tipo di accesso.
Se la guida è vuota o sbagliata
Mancano i programmi su alcuni canali
Di solito gli identificativi non coincidono. Alcune app permettono di assegnare a mano il canale della guida, cosa che vale la pena fare per i preferiti. Una playlist e una guida possono essere ottime e usare comunque nomi diversi.
È tutto spostato di una o due ore
Controlla prima il fuso orario del dispositivo. Una guida pubblicata in UTC va convertita correttamente nell’ora locale, e il passaggio all’ora legale e a quella solare mette subito in luce un’impostazione sbagliata. Molte app offrono anche una correzione manuale dell’orario.
La guida non si aggiorna più
Le fonti cambiano o scadono. Apri le impostazioni della guida, guarda quando è avvenuto l’ultimo aggiornamento e avviane uno a mano. Se non riesce, verifica che l’indirizzo funzioni ancora e chiedi a chi te l’ha fornito.
L’app rallenta dopo il caricamento
I file molto grandi pesano sui dispositivi poco potenti. Se puoi, usa una fonte limitata ai paesi che guardi e riduci il numero di giorni conservati.
Poca manutenzione
Imposta l’aggiornamento della guida una volta al giorno anziché a ogni avvio: l’app partirà più in fretta. Se la playlist cambia, ricontrolla le associazioni, perché le nuove voci possono avere nuovi identificativi.
La guida è raramente l’unico fastidio di una nuova installazione. Se anche i canali scattano, leggi perché i flussi vanno in buffering e consulta la nostra pagina di risoluzione dei problemi per altri sintomi.
Fonti
Le pagine ufficiali su cui si basano i fatti di questo articolo. Store e siti web cambiano, per questo ogni fonte indica la data della nostra verifica.
- Kodi – PVR IPTV Simple Client add-on (GitHub) · verificato il 17 novembre 2026
Continua a leggere

Concetti base
Playlist M3U o accesso Xtream: quale scegliere?
I link M3U e gli accessi Xtream caricano entrambi i canali in un’app di riproduzione, ma in modo diverso. Scopri come funzionano e quando usarli.
4 min di lettura

Configurazione
Kodi con PVR IPTV Simple Client: aggiungere playlist M3U e guida XMLTV
Configurare PVR IPTV Simple Client in Kodi: dove inserire la playlist M3U e la guida XMLTV, le impostazioni utili, i loghi, lo spostamento orario e le domande.
3 min di lettura

Configurazione
Lettori IPTV per Android: quale app scegliere su smartphone e tablet?
Quale lettore IPTV per Android scegliere? Cosa confermano le fonti ufficiali su VLC, Kodi, TiviMate e IPTV Smarters, e i criteri per scegliere bene.
3 min di lettura
