IPTV con EPG – Come Configurare la Guida TV 2026

\n\n

Hai IPTV funzionante, i canali scorrono, l'immagine è nitida — ma accendi la guida dei programmi e vedi il vuoto. Nessun nome dei programmi, nessun orario, niente. Classico. La configurazione di IPTV con EPG è uno di quei passaggi che tutti saltano al primo setup, e poi si chiedono perché il lettore sembra una lista di canali degli anni '90.

\n\n

EPG, ovvero Electronic Program Guide, è uno strato di dati separato sovrapposto alla tua playlist M3U. Non fa parte del flusso video. È un file XML separato che il lettore scarica, analizza e associa ai canali. Ed è proprio in questa fase — l'associazione — che la maggior parte delle persone si blocca. Questa guida ti porterà attraverso l'intera configurazione di IPTV con EPG passo dopo passo, dalle basi ai trucchi avanzati con cron e fusione delle fonti.

\n\n

Cos'è l'EPG e perché è essenziale in IPTV

\n\n

Come funziona l'Electronic Program Guide

\n\n

L'EPG è fondamentalmente un database con il palinsesto della televisione. Contiene il nome del programma, la descrizione, l'orario di inizio e di fine, la categoria, e a volte anche la copertina. Il tuo lettore IPTV scarica questi dati dall'URL fornito e li sovrappone alla lista dei canali.

\n\n

L'intero meccanismo si basa su un'unica connessione chiave: l'identificatore del canale nel file EPG deve corrispondere all'identificatore nella tua playlist M3U. Se la playlist dicetvg-id="TVP1.pl", allora il file EPG deve avere la voce<channel id="TVP1.pl">. Quando questi due coincidono — hai il programma TV. Quando non coincidono — hai una griglia vuota.

\n\n

Formato XMLTV — standard EPG

\n\n

XMLTV è un formato di file aperto che è diventato de facto lo standard per i dati EPG. Il file ha estensione.xml o compresso.xml.gz e contiene due sezioni: definizioni dei canali (<channel>) e programmi (<programme>). Un tipico file XMLTV per 500 canali con dati per 7 giorni pesa 30-80 MB non compresso.

\n\n

La struttura è semplice. Ogni canale ha unid unico e un nome visualizzato. Ogni programma hainizio,fine,canale (riferito all'id del canale) etitolo. Gli attributi temporali contengono l'offset del fuso orario, ad esempio20260317200000 +0100. Ed è proprio questo offset che ti darà problemi — ma di questo parleremo tra poco.

\n\n

Differenza tra EPG integrato ed esterno

\n\n

Ci sono due modi per fornire l'EPG. Primo: il tuo fornitore IPTV integra l'URL dell'EPG direttamente nell'intestazione del file M3U, nell'attributourl-tvg. Il lettore scarica automaticamente i dati e non devi configurare nulla. Secondo: aggiungi manualmente una fonte EPG esterna nelle impostazioni del lettore.

\n\n

L'EPG integrato è comodo, ma hai zero controllo. Se il fornitore cambia l'URL o il suo EPG non copre tutti i canali — rimani a mani vuote. Una fonte esterna ti dà il pieno controllo: scegli il fornitore dei dati, imposti l'intervallo di aggiornamento, puoi persino combinare più fonti. In pratica, è meglio avere entrambi.

\n\n

Come aggiungere l'EPG al lettore IPTV — passo dopo passo

\n\n

Configurazione dell'EPG in TiviMate

\n\n

TiviMate è, secondo me, il miglior lettore IPTV per Android, e la configurazione dell'EPG qui è indolore. Apri l'app, vai suImpostazioni → EPG → Aggiungi fonte. Incolla l'URL del file XMLTV. Formato accettato:http:// lubhttps:// link do.xml lub.xml.gz.

\n\n

Dopo aver aggiunto la fonte, TiviMate inizia a scaricare. Per un file di 50 MB su una connessione di 100 Mbps ci vogliono una dozzina di secondi. InImpostazioni → EPG → Intervallo di aggiornamento imposta 12 o 24 ore — non farlo ogni ora, perché il fornitore EPG potrebbe bloccarti l'IP. TiviMate consente di aggiungere più fonti EPG contemporaneamente, il che è oro se hai canali da diversi paesi.

\n\n

Dettaglio importante: dopo aver aggiunto l'EPG devi aspettare che i dati si carichino, poi entra inImpostazioni → EPG → Assegna fonte EPG e assicurati che i canali abbiano programmi assegnati correttamente. TiviMate fa un'assegnazione automatica in base al nome del canale, ma non sempre ci riesce.

\n\n

EPG in Perfect Player

\n\n

Perfect Player è un classico su Android TV. Vai suImpostazioni (icona dell'ingranaggio) → Generale → URL EPG. Incolla il link al file XMLTV e conferma. Il programma scaricherà i dati e cercherà di mappare automaticamente i canali.

\n\n

Un problema con Perfect Player: non gestisce bene i file EPG di grandi dimensioni. Con file superiori a 30 MB su dispositivi con 1-2 GB di RAM, l'app può bloccarsi o impiegare diversi minuti per caricare i dati. Soluzione: usa un file compresso.xml.gz invece del semplice XML. Perfect Player supporta gzip. Se questo non aiuta — hai bisogno di una fonte EPG più piccola con un numero minore di canali.

\n\n

EPG in Kodi (PVR IPTV Simple Client)

\n\n

Kodi richiede l'addon PVR IPTV Simple Client. Lo installi dal repository di Kodi (Componenti aggiuntivi → Installa da repository → Client PVR → PVR IPTV Simple Client). Dopo l'installazione vai suConfigura → Impostazioni EPG.

\n\n

Hai due opzioni:URL XMLTV (link al file remoto) oppurePercorso locale (file sul disco). Per l'URL remoto incolli il link e impostiIntervallo di aggiornamento EPG su 720 minuti (12h). Per il file locale fornisci il percorso, ad esempio/storage/epg.xml.gz su LibreELEC. Dopo aver salvato riavvia Kodi — l'EPG si caricherà all'avvio del PVR.

\n\n

In Kodi 21 (Omega) e versioni successive puoi anche impostareTimeshift EPG direttamente nelle impostazioni del Simple Client — utile quando gli orari dei programmi sono spostati di un'ora o due.

\n\n

EPG in VLC e GSE Smart IPTV

\n\n

VLC di per sé non supporta l'EPG da XMLTV. Puoi aprire una playlist M3U e guardare i canali, ma non vedrai la guida ai programmi. Se la tua playlist M3U ha un EPG incorporato nel flusso (formato EIT nel transport stream), VLC mostrerà le informazioni attuali sul programma — ma questo dipende dal fornitore.

\n\n

GSE Smart IPTV su iOS/Android:Impostazioni → EPG/Programma → Aggiungi sorgente EPG → EPG remoto → URL. Incolli il link XMLTV. Imposti l'aggiornamento inAggiornamento automatico EPG. GSE ha un limite — supporta una sorgente EPG alla volta, quindi se hai bisogno di dati da più fonti, devi prima unirli in un unico file.

\n\n

EPG su Smart TV (Samsung, LG)

\n\n

Su Samsung Tizen utilizzi più frequentemente Duplex IPTV o IPTV Smarters Pro. In Duplex:Impostazioni → URL EPG — incolli il link. In Smarters: l'EPG si carica automaticamente dall'API Xtream Codes, quindi se il fornitore ha Xtream — non devi fare nulla.

\n\n

Su LG webOS le opzioni sono Smart IPTV (siptv.eu) o IPTV Smarters. In Smart IPTV imposti l'EPG tramite il pannello web su siptv.eu/mylist — lì incolli l'URL per XMLTV. Limitazione: Smart IPTV scarica l'EPG una volta all'avvio e non si aggiorna automaticamente. Devi riavviare l'app per scaricare nuovi dati.

\n\n

Fonti EPG — da dove scaricare i dati del programma TV

\n\n

EPG dal fornitore IPTV (integrato nella playlist M3U)

\n\n

Apri la tua playlist M3U in un editor di testo e controlla la prima riga. Cerchi l'attributourl-tvg:

\n\n

#EXTM3U url-tvg="http://example.com/epg.xml.gz" refresh="3600"

\n\n

Se questo attributo è presente — il tuo fornitore fornisce EPG. Copia questo URL e aprilo nel browser. Dovrebbe scaricarsi un file XML o XML.GZ. Se restituisce un errore 403 o 404 — l'URL è probabilmente scaduto e devi chiedere al fornitore un link aggiornato. Molti lettori utilizzano automaticamente questo URL, ma è utile aggiungerlo manualmente come backup.

\n\n

Fonti XMLTV pubbliche gratuite

\n\n

Il repositoryiptv-org/epgsu GitHub è la più grande fonte EPG guidata dalla comunità al mondo. Supporta canali da oltre 60 paesi, compresa la Polonia. I dati vengono generati automaticamente dai siti ufficiali delle TV e aggiornati quotidianamente. L'URL per il file EPG per un paese specifico lo trovi nella loro documentazione — di solito appare comehttps://iptv-org.github.io/epg/guides/pl/....

\n\n

La qualità delle fonti gratuite è variabile. Alcuni canali hanno dati completi per 7 giorni in avanti, altri solo per 2-3 giorni. I canali premium (ad es. Canal+, HBO) spesso non sono coperti, poiché i loro siti richiedono il login. Ma per i canali aperti — TVP, Polsat, TVN e simili — la copertura è discreta.

\n\n

Generazione del proprio EPG con WebGrab+Plus

\n\n

WebGrab+Plus è uno strumento gratuito che estrae programmi TV direttamente dai siti web dei broadcaster. Si installa su Windows, Linux o in Docker. Configuri il fileWebGrab++.config.xml con l'elenco dei canali e delle fonti. Lo avvii — e hai un nuovo file XMLTV.

\n\n

Per i canali polacchi, WebGrab+Plus supporta fonti come telemagazyn.pl e programtv.onet.pl. La configurazione è un po' laboriosa — devi selezionare manualmente i file site-ini (file con le definizioni di scraping) per ogni canale. Ma il risultato vale la pena: hai EPG esattamente per i canali che guardi, senza inutili ingombri. Il tempo di generazione per 50 canali è di circa 10-15 minuti.

\n\n

EPG per i canali polacchi — opzioni disponibili

\n\n

I canali televisivi polacchi hanno diverse fonti EPG dedicate. La community su GitHub mantiene repository specifici per il mercato polacco — cerca la frase "epg poland xmltv". La copertura di solito include TVP 1/2/3, TVP Info, TVP Sport, Polsat e canali tematici, TVN e la famiglia, TV Puls, TV4/TV6, Eska TV, Nowa TV.

\n\n

I canali codificati (Canal+, Polsat Sport Premium, HBO) sono più difficili — i dati di programmazione richiedono il parsing di API chiuse. Alcuni script gestiti dalla community lo fanno, ma i link cambiano. Se la tua configurazione IPTV con EPG deve coprire canali premium, la soluzione migliore è combinare diverse fonti — una pubblica per i canali FTA, l'altra dal fornitore IPTV per i canali premium.

\n\n

Mappatura dei canali — la chiave per un EPG funzionante

\n\n

Cosa sono tvg-id e tvg-name nel file M3U

\n\n

Ogni linea di canale nel file M3U appare più o meno così:

\n\n

#EXTINF:-1 tvg-id="TVP1.pl" tvg-name="TVP 1" tvg-logo="http://logo.url/tvp1.png" group-title="Polskie",TVP 1\nhttp://stream.url/tvp1

\n\n

L'attributotvg-id è la chiave per la mappatura EPG. Il lettore prende questo valore, cerca nel file XMLTV l'entry<channel id="TVP1.pl"> e se la trova — assegna i programmi a quel canale. L'attributotvg-name è un fallback — alcuni lettori cercano di abbinare per nome quando tvg-id non corrisponde.

\n\n

E qui c'è la trappola. Non esiste uno standard unico di denominazione. Una fonte EPG usaTVP1.pl, altriTVP1, ancora altritvp-1-polonia. La tua playlist può averetvg-id="TVP.1". Nessuno di essi si adatta. Ecco perché l'EPG non funziona.

\n\n

Come assegnare manualmente l'EPG a un canale

\n\n

Scarica il file XMLTV e aprilo in un editor di testo (VSCode, Notepad++ — non in Word). Cerca la sezione<channel> all'inizio del file. Troverai un elenco come questo:

\n\n

<channel id="TVP1.pl">\n<display-name>TVP 1</display-name>\n</channel>\n<channel id="Polsat.pl">\n<display-name>Polsat</display-name>\n</channel>

\n\n

Ora apri la tua playlist M3U e correggi gli attributitvg-id affinché corrispondano a questi identificatori. Se in XMLTV c'èid="TVP1.pl", allora in M3U devi averetvg-id="TVP1.pl". Esattamente. La maiuscola conta.

\n\n

Strumenti per la mappatura automatica EPG

\n\n

Modificare manualmente 500 canali è un incubo. Fortunatamente ci sono strumenti.m3u4u.com è un editor web per playlist M3U che consente di importare una playlist, aggiungere una fonte EPG e abbinare automaticamente i canali per nome. Ha un database di tvg-id noti e lo fa in modo sensato per i canali popolari.

\n\n

Xtream Editor (xtream-editor.com) fa lo stesso, ma per l'API Xtream Codes — importi i dati di accesso e modifichi la mappatura nel browser. TiviMate su Android ha una funzione di assegnazione manuale integrata: tieni premuto il canale →Fonte EPG → Seleziona canale EPG → scegli dalla lista dei canali EPG disponibili. Noioso ma efficace.

\n\n

Modifica del file M3U — aggiunta di attributi EPG

\n\n

Se la tua playlist non ha attributi tvg-id, devi aggiungerli manualmente. Apri il file M3U e per ogni riga#EXTINF aggiungi gli attributi appropriati. Prima di modificare, fai una copia di backup del file.

\n\n

Aggiungi anche l'intestazione con l'URL EPG in cima al file:

\n\n

#EXTM3U url-tvg="http://tuo-url-epg.com/epg.xml.gz"

\n\n

Se hai qualche centinaio di canali, usa uno script. Un semplice Python o anche sed in bash è sufficiente per fare una sostituzione di massa. Ad esempio.sed -i 's/tvg-id=""/tvg-id="TVP1.pl"/' playlist.m3u per un canale. Per molti — prepara un file CSV con la mappatura (vecchia_nome → tvg-id) e scrivi uno script.

\n\n

Risoluzione dei problemi con l'EPG in IPTV

\n\n

L'EPG non si carica — le cause più comuni

\n\n

Primo punto: controlla se l'URL dell'EPG funziona. Apri il terminale e lancia:

\n\n

curl -I "http://tuo-url-epg.com/epg.xml.gz"

\n\n

CercaHTTP/1.1 200 OK eContent-Type contenentexml oapplication/gzip. Se ricevi 403 — il server blocca il tuo IP (per richieste troppo frequenti?). Se 404 — l'URL non è aggiornato. Se timeout — il server EPG è giù.

\n\n

Secondo punto: dimensione del file. Controlla l'intestazioneContent-Length nella risposta curl. Se il file pesa più di 100 MB, e hai una connessione lenta o un dispositivo con 1 GB di RAM — il lettore potrebbe bloccarsi durante il parsing. Soluzione: trova una fonte EPG più piccola oppure filtra il file per lasciare solo i canali necessari.

\n\n

L'EPG mostra programmi sbagliati sui canali

\n\n

Questo è un problema di mappatura. Il canale "TVP 1 HD" nella tua playlist ha ricevuto l'EPG da "TVP 1 International" perché gli tvg-id non corrispondono. Apri il file XMLTV, trova l'ID corretto per il canale, correggi nel file M3U o nelle impostazioni di mappatura nel lettore.

\n\n

Un altro caso: i canali HD e SD hanno lo stesso programma ma tvg-id diversi. Ad esempio.TVP1HD.pl vsTVP1.pl. Nel file XMLTV può esserci una voce solo per uno di essi. Soluzione: assegna entrambi i canali (HD e SD) allo stesso tvg-id nella playlist. L'EPG sarà identico, ma almeno ci sarà.

\n\n

L'EPG smette di aggiornarsi

\n\n

Più frequentemente: il fornitore ha cambiato l'URL dell'EPG senza preavviso. Controlla il vecchio URL con curl. Se non funziona — devi ottenere un nuovo URL. Una buona pratica è impostare un semplice monitoraggio. Su Linux puoi aggiungere al cron:

\n\n

0 6 * * * curl -sf "http://tuo-url-epg.com/epg.xml.gz" -o /dev/null || echo "EPG URL rotto" | mail -s "Allerta EPG" [email protected]

\n\n

Secondo: cache del lettore. TiviMate e Kodi mantengono una copia locale dell'EPG. Se i dati non si aggiornano nonostante l'URL funzionante — svuota la cache dell'EPG. In TiviMate:Impostazioni → EPG → Svuota cache EPG. In Kodi: elimina il fileepg.db dalla cartella dell'addon PVR.

\n\n

Sfasamento temporale nell'EPG — come correggere il fuso orario

\n\n

Vedi programmi spostati di un'ora o due? Classico problema di fuso orario. La Polonia è nella zona CET (UTC+1) in inverno e CEST (UTC+2) in estate. Se la fonte dell'EPG fornisce orari in UTC senza offset, e il tuo lettore non compensa — i programmi saranno spostati.

\n\n

Soluzione: nel lettore cerca l'opzioneSfasamento orario EPG oOffset orario EPG. Imposta +1 in inverno, +2 in estate (per la Polonia). In TiviMate:Impostazioni → EPG → Sfasamento orario EPG. In Kodi PVR Simple Client:Configura → Impostazioni EPG → Sfasamento orario EPG. Cambiare l'ora legale/invernale significa che devi correggerlo manualmente due volte all'anno — a meno che la fonte dell'EPG non utilizzi correttamente l'offset nei timestamp.

\n\n

Verifica: apri il file XMLTV e controlla l'attributostart in qualsiasi programma. Dovrebbe apparire come20260317200000 +0100. Se non c'è offset (ad esempio,20260317200000) — la fonte fornisce l'ora in UTC e il lettore deve aggiungere l'offset da solo.

\n\n

L'EPG funziona solo su alcuni canali

\n\n

Ciò significa che la mappatura funziona per alcuni canali, ma per altri no. Motivi: 1) la fonte EPG non copre tutti i tuoi canali, 2) tvg-id non corrisponde ai canali mancanti, 3) hai canali da diversi paesi e una sola fonte EPG non è sufficiente.

\n\n

Diagnostica: esporta l'elenco dei canali senza EPG (TiviMate lo mostra visivamente — i canali senza programma hanno una casella vuota). Confronta il loro tvg-id con il contenuto del file XMLTV. Se il canale non è affatto presente in XMLTV — hai bisogno di una fonte EPG aggiuntiva. Se è presente ma il tvg-id è diverso — correggi la mappatura. La configurazione IPTV con EPG da più fonti contemporaneamente risolve la maggior parte di questi casi.

\n\n

Configurazione avanzata dell'EPG

\n\n

Unire più fonti EPG

\n\n

Hai canali polacchi, tedeschi e inglesi? Una sola fonte EPG non coprirà tutti. Hai bisogno di un merge. Ci sono due approcci: il lettore lo fa da solo (TiviMate consente di aggiungere più fonti e le unisce automaticamente) oppure unisci i file XMLTV prima di caricarli.

\n\n

Per unire XMLTV su Linux utilizzi lo strumentotv_merge del pacchettoxmltv-utils:

\n\n

tv_merge -i epg_polska.xml -m epg_deutschland.xml -o merged_epg.xml

\n\n

Alternativa: script Python con la librerialxml, che unisce le sezioni<channel> e<programme> da molti file. Fai attenzione ai duplicati dei canali durante il merge: se due fonti hanno lo stesso channel id, i programmi si sovrapporranno.

\n\n

EPG in Xtream Codes API vs XMLTV

\n\n

Se il tuo fornitore IPTV fornisce le credenziali di accesso Xtream Codes (server, nome utente, password), l'EPG arriva automaticamente tramite API. Il lettore interroga l'endpoint/xmltv.php?username=X&password;=Y e riceve un file XMLTV pronto con la mappatura abbinata alla playlist. Zero configurazione.

\n\n

Differenza: nell'API Xtream Codes la mappatura è già fatta lato server. La tua playlist e l'EPG sono sincronizzati, poiché provengono dallo stesso sistema. Con XMLTV manuale devi abbinare tu stesso il tvg-id. Per questo motivo, IPTV con EPG tramite Xtream Codes è più semplice — ma anche più dipendente dal fornitore. Se il suo server EPG va giù, non hai un piano B. Con XMLTV manuale hai il pieno controllo e puoi cambiare la fonte in un minuto.

\n\n

Automazione dell'aggiornamento EPG tramite cron

\n\n

Su Linux (Raspberry Pi, VPS, NAS) puoi impostare il download automatico dell'EPG tramite cron. Aggiungi al crontab (crontab -e):

\n\n

0 4 * * * wget -q -O /home/user/epg/epg.xml.gz "http://url-per-l-epg/epg.xml.gz" 2>/dev/null

\n\n

Questo scarica un nuovo file EPG ogni giorno alle 4:00 del mattino. Aggiungi un timeout per non rimanere bloccato su un URL morto:

\n\n

0 4 * * * wget -q --timeout=120 -O /tmp/epg_new.xml.gz "URL"&& mv /tmp/epg_new.xml.gz /home/user/epg/epg.xml.gz

\n\n

Trik z/tmp emv è fondamentale: se il download fallisce, il vecchio file EPG rimane intatto. Senza questo potresti sovrascrivere un buon file vuoto o danneggiato. Il lettore (ad esempio Kodi con un percorso locale per l'EPG) caricherà automaticamente il nuovo file al prossimo aggiornamento.

\n\n

Compressione e ottimizzazione dei file XMLTV

\n\n

File XMLTV di grandi dimensioni (oltre 100 MB) sono un problema su dispositivi con poca RAM. Un Android TV Box con 1 GB di RAM può andare in crash durante il parsing di un tale file. Soluzione: compressione gzip e filtraggio.

\n\n

Compressione:

\n\n

gzip -9 epg.xml

\n\n

Un file di 80 MB dopo la compressione scende a 8-12 MB. La maggior parte dei lettori supporta il formato.xml.gz nativamente.

\n\n

Filtraggio — rimuovi i canali che non guardi. Script daxmltv-utils:

\n\n

tv_grep --channel-id "TVP1.pl" --channel-id "Polsat.pl" --channel-id "TVN.pl" full_epg.xml > filtered_epg.xml

\n\n

Da 500 canali ne lasci 50 — il file da 80 MB scende a 8 MB. Il parsing dura secondi invece di minuti. E il tuo economico Android box smette di bloccarsi.

\n\n