EPG IPTV: Come Configurare la Guida Programmi per l'Italia

EPG sta per Electronic Programme Guide, guida elettronica ai programmi. È quella griglia orizzontale che nella TV tradizionale (decoder DVB-T2, Sky, DAZN) mostra cosa sta andando in onda ora e cosa segue nelle ore successive, canale per canale. Con IPTV la stessa funzione esiste, ma non arriva automaticamente insieme ai flussi video: va collegata a parte.

La differenza pratica è enorme. Senza EPG, un'app IPTV è un elenco di nomi di canale che devi aprire uno a uno per capire cosa trasmettono in quel momento — utile se sai già cosa cercare, inutile se vuoi scoprire cosa guardare stasera o se un match è già iniziato. Con EPG funzionante, hai lo stesso colpo d'occhio di un decoder satellitare: orari, titoli, a volte anche sinossi degli episodi.

Per chi segue calcio in particolare, l'EPG è quello che ti dice se una partita è già iniziata, a che ora finisce e cosa c'è subito dopo sullo stesso canale — informazione che nessuna lista di canali statica può darti. È la differenza tra 'vedo 500 canali' e 'so cosa c'è su ognuno di essi', esattamente il salto di qualità che separa un'installazione IPTV abbozzata da una configurata come si deve.

Un'installazione IPTV completa si basa su due file distinti, spesso confusi tra loro. Il file M3U (o M3U8) è la playlist: un elenco di canali con il relativo URL di streaming, il nome e in genere un'icona. È quello che dice all'app quali canali esistono e dove trovarli. Se hai già seguito una guida di base per configurare IPTV su VLC o su un player mobile, hai già lavorato con un file M3U.

Il file XMLTV, invece, è un documento in formato XML che contiene esclusivamente la programmazione: orari di inizio e fine di ogni trasmissione, titoli, categorie, per ciascun canale. Non contiene alcun flusso video — è puro testo con i dati del palinsesto, aggiornato periodicamente dal provider o da servizi terzi che aggregano i palinsesti.

Il collegamento tra i due avviene tramite un identificativo comune: il tvg-id assegnato a ogni canale nel file M3U deve corrispondere esattamente al channel id usato nello stesso canale nel file XMLTV. Se questi due identificativi non combaciano — capita spesso con provider che rinominano i canali o con playlist create da fonti diverse rispetto all'EPG — l'app scarica comunque il file XMLTV ma non riesce ad abbinare i dati al canale giusto, e la guida resta vuota anche se tecnicamente tutto è 'collegato'.

Capire questa distinzione è il primo passo per diagnosticare qualsiasi problema di EPG: se i canali funzionano ma la guida no, il problema non è mai nel file M3U, è sempre nell'XMLTV o nell'abbinamento tra i due.

L'URL del file XMLTV normalmente non è lo stesso dell'URL della playlist M3U: sono due link distinti che il provider fornisce insieme, spesso nella stessa email o pagina di attivazione dell'abbonamento. Cerca voci come 'EPG URL', 'XMLTV', 'Guida programmi' o un link che termina con estensione .xml o .xml.gz nella documentazione ricevuta.

Se non trovi nulla, il modo più diretto è chiedere esplicitamente al supporto del provider: 'Qual è l'URL XMLTV/EPG da inserire nell'app, separato dalla playlist M3U?'. È una domanda specifica che filtra le risposte generiche — un provider che gestisce seriamente l'EPG ha sempre questo link pronto da girarti, distinto dalla playlist dei canali.

Alcuni provider integrano l'EPG direttamente nel file M3U stesso, tramite un parametro url-tvg o x-tvg-url nella prima riga del file. In quel caso l'app dovrebbe rilevarlo automaticamente senza bisogno di inserire un secondo link — ma vale sempre la pena controllare le impostazioni EPG dell'app per verificare che il rilevamento sia avvenuto.

Diffida di 'EPG universali' scaricati da fonti generiche non legate al tuo provider: spesso usano tvg-id diversi da quelli della tua playlist, quindi anche se il file si scarica correttamente la corrispondenza con i tuoi canali sarà parziale o assente.

TiviMate, disponibile su Android TV e Fire TV, è probabilmente l'app con la gestione EPG più curata tra quelle diffuse in Italia, e vale la pena partire da qui se il tuo dispositivo la supporta. Dopo aver aggiunto la playlist M3U, vai su Impostazioni > Playlist, seleziona la playlist attiva e cerca la voce EPG.

Da lì puoi aggiungere manualmente l'URL XMLTV fornito dal provider tramite 'Aggiungi fonte EPG'. TiviMate supporta anche più fonti EPG contemporaneamente per la stessa playlist: utile se alcuni canali sono coperti da un XMLTV e altri da un secondo, situazione comune con playlist che aggregano canali di origini diverse.

Dopo aver inserito l'URL, forza un aggiornamento manuale dalla stessa schermata invece di aspettare il refresh automatico (che in TiviMate avviene di norma ogni 12-24 ore secondo l'impostazione scelta). Se la griglia programmi appare popolata per alcuni canali e vuota per altri, il problema è quasi certamente un tvg-id non corrispondente per i canali mancanti, non un errore di configurazione generale.

IPTV Smarters Pro copre un pubblico più ampio di dispositivi — smartphone, tablet, TV box generici — e per questo motivo, se stai valutando quale app scegliere in base al dispositivo che usi, resta l'alternativa più cross-platform a TiviMate. La configurazione EPG però segue una logica diversa: se hai fatto login tramite Xtream Codes API (username, password, URL del server, non il file M3U diretto), l'app scarica automaticamente l'EPG associato all'account, senza bisogno di inserire un URL XMLTV a parte.

Se invece hai caricato una playlist M3U 'pura' (link diretto al file .m3u), devi aggiungere l'URL XMLTV manualmente da Impostazioni > EPG dentro l'app, incollando il link fornito dal provider nello stesso punto dove hai inserito la playlist.

Un dettaglio che genera molte segnalazioni di 'EPG non funziona' su Smarters Pro: l'app mantiene una cache locale della guida programmi che non si aggiorna in automatico ogni volta che apri l'app. Se hai appena cambiato provider o URL XMLTV, vai su Impostazioni e forza manualmente il refresh dell'EPG, altrimenti vedrai ancora dati vecchi o vuoti anche con la configurazione corretta.

Se guardi IPTV su PC con VLC seguendo un'installazione classica M3U, la brutta notizia è che VLC di per sé non ha un supporto EPG nativo utilizzabile in modo pratico: la funzione tecnicamente esiste in alcune build ma richiede configurazioni manuali del file XSPF/XML poco stabili e raramente aggiornate correttamente in tempo reale.

L'approccio più affidabile su PC è usare un player di terze parti pensato per IPTV con supporto EPG integrato (ad esempio client basati su Xtream Codes, o web player forniti direttamente dal provider), lasciando VLC come opzione di riserva per la sola riproduzione video senza guida programmi.

In alternativa, se il tuo provider offre un pannello web o un'app desktop dedicata, quella è quasi sempre la strada con meno attriti per avere l'EPG su computer: l'integrazione è pensata dal provider stesso, mentre VLC resta un player generico che non è mai stato progettato per gestire palinsesti IPTV.

EPG completamente vuoto su tutti i canali: verifica prima di tutto che l'URL XMLTV inserito sia corretto e raggiungibile — copialo e incollalo nel browser del telefono o del PC, se il file XML si scarica o si apre come testo, l'URL è valido e il problema è nell'app; se dà errore, l'URL è sbagliato o scaduto e va richiesto di nuovo al provider.

EPG parziale, alcuni canali sì e altri no: come già visto, è quasi sempre un mismatch tra il tvg-id nel file M3U e il channel id nel file XMLTV. Alcune app (TiviMate su tutte) permettono di correggere manualmente l'abbinamento canale per canale dalle impostazioni avanzate della playlist, forzando la corrispondenza giusta senza dover riscrivere l'intero file.

Guida lenta a caricare o che si blocca: i file XMLTV di provider con molti canali possono pesare diversi megabyte e richiedere tempo per essere scaricati e processati, soprattutto su connessioni dati mobili o dispositivi con poca RAM come alcuni TV box entry-level. Se il caricamento è costantemente lento, prova a ridurre l'intervallo di refresh automatico nell'app o verifica la connessione di rete seguendo gli stessi controlli usati per il buffering generico durante le partite di Serie A.

Programmazione con orari sbagliati o sfasati: capita quando il file XMLTV non specifica correttamente il fuso orario o quando l'app applica una conversione errata. Controlla nelle impostazioni dell'app se esiste un'opzione per forzare manualmente il fuso orario (Europe/Rome) invece di lasciarlo su rilevamento automatico.

La maggior parte delle app IPTV scarica l'EPG in tempo reale ogni volta che apri la guida programmi, il che significa che senza connessione attiva la griglia resta vuota anche se i canali erano stati visti poco prima. Alcune app, TiviMate inclusa, permettono invece di scaricare e mettere in cache l'intero file XMLTV per un periodo definito, così la guida resta consultabile anche con connessione instabile o assente per qualche minuto.

Questa opzione va cercata nelle impostazioni EPG dell'app sotto voci come 'Cache EPG' o 'Intervallo di aggiornamento'. Va tenuta a mente soprattutto per chi guarda IPTV in mobilità o su reti che cadono spesso: un EPG scaricato in anticipo evita di trovarsi con la guida vuota proprio nel momento in cui serve controllare a che ora inizia una partita.