Come Configurare l’EPG XMLTV su IPTV

Cos’è l’EPG e cos’è il formato XMLTV

L’EPG (Electronic Program Guide) è la guida programmi che vedi nell’app IPTV: la griglia con «cosa va in onda adesso» e «cosa viene dopo» su ogni canale. Le app IPTV non la generano da sole: la scaricano da un file esterno, quasi sempre in formato XMLTV. Il nome viene dal progetto XMLTV, una suite di software libero (licenza GPL) nata per raccogliere e organizzare i palinsesti TV, che definisce un formato XML per i listini documentato in un DTD ufficiale.

La struttura del file è semplice. L’elemento radice <tv> contiene una lista di <channel id="…">, ognuno con almeno un <display-name>, e una lista di <programme>. Ogni programma ha gli attributi start, stop e channel: quest’ultimo deve corrispondere all’id di un canale. Gli orari sono scritti nel formato YYYYMMDDhhmmss seguito dal fuso orario, per esempio 20260830203000 +0200; se il fuso manca, per specifica va assunto l’UTC. Da qui nascono quasi tutti i problemi di «orari sbagliati di un’ora».

Il file può pesare decine di megabyte, per questo molti provider lo distribuiscono compresso (.xml.gz o .xml.xz): il client PVR di Kodi, per esempio, dichiara il supporto sia a Gzip sia a XZ. Se vuoi capire come il file EPG si incastra con la playlist e con i due tipi di accesso, leggi anche il confronto Xtream Codes contro lista M3U.

Da dove arriva l’URL EPG

L’URL EPG lo fornisce il provider IPTV, non l’app. Con Apollo Group TV lo ricevi su WhatsApp insieme alle credenziali e all’URL della playlist: se non lo trovi nel messaggio di attivazione, richiedilo all’assistenza. Non esiste un URL «universale» da copiare da internet: la guida deve essere generata per la tua stessa lista di canali, altrimenti gli id non combaciano.

In molte playlist M3U l’URL è già dichiarato nell’intestazione, nell’attributo x-tvg-url della riga #EXTM3U. Kodi lo legge solo se nelle impostazioni dell’add-on non hai indicato un URL EPG tuo; se la tua app lo rileva in automatico, la guida compare dopo il primo avvio senza altri passaggi. Se non compare, incolla l’URL a mano nel campo EPG.

💡 Copia l’URL EPG per intero, senza spazi prima o dopo: un carattere mancante alla fine è il motivo più comune per cui il download fallisce in silenzio.

Configurare l’EPG in TiviMate

TiviMate, secondo la scheda ufficiale sul Play Store, è pensato per Android TV e telecomando, supporta playlist M3U, Xtream Codes e Stalker Portal, gestisce più playlist e mostra la guida TV in una griglia. L’EPG è legato alla singola playlist, quindi si configura nelle impostazioni di quella playlist.

1. Apri le impostazioni di TiviMate e vai alla sezione delle playlist.
2. Seleziona la playlist Apollo Group TV e apri la voce dedicata alle fonti EPG.
3. Aggiungi una nuova fonte e incolla l’URL EPG ricevuto su WhatsApp, poi conferma.
4. Avvia l’aggiornamento della guida e attendi qualche minuto: il primo download del file completo è il più lento.
5. Torna alla guida TV e controlla che i canali mostrino i programmi in corso.

Nelle stesse impostazioni EPG trovi in genere lo scarto orario e l’aggiornamento programmato, di cui parliamo più sotto. Per una panoramica delle altre funzioni leggi la recensione completa di TiviMate; se lo usi su Fire TV, segui prima la guida IPTV per Fire TV Stick per installare l’app e caricare la playlist.

Configurare l’EPG in IPTV Smarters Pro

Le app della famiglia Smarters (sviluppate da WHMCS Smarters) integrano l’EPG e accettano playlist M3U; la scheda ufficiale di Smarters Player Lite sull’App Store lo conferma. Il punto in cui inserire l’URL dipende da come accedi:

• Accesso con URL M3U: nella schermata in cui carichi la playlist trovi un campo separato per l’URL EPG. Compilalo subito, insieme al link della lista, e salva: la guida viene scaricata al primo accesso.
• Accesso con Xtream Codes: la guida viene richiesta al server del provider dopo il login; se resta vuota, cerca nel menu dell’app la voce che installa o aggiorna l’EPG e incolla lì l’URL ricevuto su WhatsApp.
• Dopo il salvataggio: apri la sezione TV in diretta e verifica la colonna dei programmi.

Trovi pro, contro e differenze fra le versioni nella recensione di IPTV Smarters Pro.

Configurare l’EPG su Kodi con PVR IPTV Simple Client

Su Kodi la procedura è la più documentata: le voci qui sotto vengono dal README ufficiale dell’add-on e dal wiki di Kodi. Se non hai ancora installato il client PVR, parti dalla guida IPTV per Kodi e torna qui per la parte EPG.

1. Vai in Settings → Add-ons → My add-ons → PVR Clients, seleziona PVR IPTV Simple Client e scegli Configure.
2. Apri la scheda EPG e imposta Location su Remote path.
3. Nel campo XMLTV URL incolla l’URL EPG di Apollo Group TV.
4. Attiva Cache XMLTV at local storage se vuoi che il file resti sul dispositivo fra un avvio e l’altro; nota che la cache viene disattivata se usi l’aggiornamento automatico.
5. Lascia EPG time shift a 0 finché non hai verificato gli orari (vedi sotto). L’opzione Ignore Case for EPG Channel IDs aiuta se i tvg-id della playlist e gli id del file differiscono solo per maiuscole e minuscole.
6. Conferma con OK. Kodi carica i dati EPG solo quando servono: apri la guida TV per forzare il primo download.

Se cambi URL e la vecchia guida non sparisce, svuota la cache da Settings → PVR & Live TV → Guide → Clear cache; per un ricaricamento completo di canali e guida scegli invece Settings → PVR & Live TV → General → Clear cache.

Fuso orario italiano (CET) e scarto orario

Un file XMLTV corretto porta già il fuso in ogni orario (+0100 con l’ora solare CET, +0200 con l’ora legale CEST), quindi l’app lo converte da sola nell’ora del dispositivo e lo scarto orario va lasciato a 0. Regolalo solo se la guida risulta sfasata in modo costante: di solito significa che il file è espresso senza fuso (quindi in UTC) o con un fuso diverso da quello italiano.

• Kodi: EPG time shift accetta valori da −12 a +14 ore; con Apply time shift to all channels il valore sovrascrive gli eventuali scarti per canale. In alternativa la playlist può contenere tvg-shift (in ore) nella riga #EXTM3U per tutti i canali o nella singola riga #EXTINF per uno solo.
• TiviMate e IPTV Smarters: la voce di scarto orario sta nelle impostazioni EPG dell’app; se la guida è indietro di un’ora prova +1, se il problema compare solo dopo il cambio dell’ora legale a marzo o a ottobre rivedi il valore.
• Controllo rapido: confronta l’inizio di un telegiornale con l’orario reale. Scarto esatto di 1 o 2 ore: problema di fuso; scarto irregolare: file EPG vecchio da aggiornare.

Intervallo di aggiornamento della guida

La guida copre pochi giorni, quindi va riscaricata regolarmente: un aggiornamento al giorno, di notte, è sufficiente. In Kodi la frequenza si imposta nella scheda della playlist con Auto refresh mode: Once per day con l’ora indicata in Refresh hour (24h), oppure Repeated refresh con un intervallo in minuti fino a un massimo di 120. Ricorda che con l’aggiornamento automatico attivo la cache locale del file viene disattivata.

In TiviMate e IPTV Smarters cerca l’aggiornamento programmato nelle impostazioni EPG e, quando qualcosa non torna, lancia l’aggiornamento manuale prima di cambiare altro. Se dopo l’aggiornamento manuale la guida è ancora vuota, il problema è l’URL o l’abbinamento dei canali, non la frequenza.

Abbinare i canali: tvg-id e id XMLTV

Perché un canale mostri i programmi, l’app deve capire quale <channel> del file XMLTV corrisponde a quella riga della playlist. Il collegamento è l’attributo tvg-id della riga #EXTINF: deve essere identico all’attributo id del canale nel file EPG. Il README di PVR IPTV Simple Client descrive tre passaggi in ordine:

1. l’id del canale XMLTV viene confrontato con il tvg-id della playlist; se coincide, l’abbinamento è fatto;
2. altrimenti il display-name viene confrontato con il tvg-name, anche sostituendo gli spazi con underscore;
3. come ultima risorsa il display-name viene confrontato con il nome del canale scritto dopo la virgola.

In pratica: se un solo canale è senza guida, apri la playlist con un editor di testo, cerca quella riga e leggi il suo tvg-id; poi cerca lo stesso valore nel file XMLTV. Se manca o è scritto in modo diverso (per esempio Rai1.it contro rai1.it), è l’abbinamento a fallire, non il download. Su Kodi l’opzione Ignore Case risolve le differenze di maiuscole; per le altre discrepanze segnala il canale all’assistenza Apollo Group TV su WhatsApp, che può correggere l’id lato server. Per sapere quali canali sono inclusi nel tuo piano chiedi la lista canali aggiornata su WhatsApp.

Perché l’EPG può restare vuoto

Le cause, in ordine di frequenza, sono quasi sempre queste: l’URL EPG incompleto o incollato nel campo sbagliato; il primo download non ancora terminato (il file è grande e Kodi lo carica solo quando apri la guida); i tvg-id della playlist che non corrispondono agli id del file; una cache vecchia che va svuotata dopo aver cambiato URL; un file compresso in un formato che l’app non legge. Se la guida funzionava e ha smesso, o mostra orari sbagliati, segui la guida alla risoluzione dell’EPG che non funziona, che copre aggiornamento forzato, cache e reinstallazione. Per tutto il resto, dalla scelta dell’app ai piani, parti dalla guida completa all’IPTV.

Fonti

• xmltv.dtd — DTD ufficiale del formato XMLTV (progetto XMLTV su GitHub) (letta il 30 agosto 2026)
• README del progetto XMLTV — XMLTV/xmltv su GitHub (letta il 30 agosto 2026)
• README di PVR IPTV Simple Client — kodi-pvr/pvr.iptvsimple su GitHub (letta il 30 agosto 2026)
• Add-on: PVR IPTV Simple Client — Kodi Wiki (letta il 30 agosto 2026)
• TiviMate IPTV Player — scheda ufficiale su Google Play (letta il 30 agosto 2026)
• Smarters Player Lite (WHMCS Smarters) — scheda ufficiale sull’App Store (letta il 30 agosto 2026)