EPG Non si carica? Una guida completa per riparare la tua guida TV IPTV nel 2026

Hai configurato il tuo lettore IPTV. I canali si caricano. Puoi passare da uno all'altro. Tutto sembra ottimo — fino a quando non apri la guida TV e trovi nient'altro che un'infinità di celle vuote. O peggio: celle con gli spettacoli sbagliati, che elencano programmi terminati cinque anni fa.

I problemi di EPG sono il secondo reclamo più segnalato in IPTV dopo il buffering, e la cosa frustrante è che i sintomi sembrano identici indipendentemente dalla causa. Questa guida illustra i cinque veri problemi dietro le guide TV rotte, nell'ordine in cui vale la pena controllarli.

Che cosa è veramente un EPG

EPG significa Electronic Program Guide (Guida Elettronica ai Programmi). Sono i metadati che dicono al tuo lettore IPTV cosa va in onda su ogni canale, cosa verrà dopo e quali sono le descrizioni dei programmi. Non c'è niente di magico — il tuo lettore scarica un file o interroga un'API, analizza i titoli e gli orari dei programmi, e li visualizza in una griglia accanto ai tuoi canali.

Il formato standard è XMLTV: un singolo file XML che elenca ogni canale, ogni programma, ogni ora di inizio, ogni durata, e opzionalmente poster e descrizioni. Un file XMLTV tipico per un grande provider può essere 50–500 MB non compresso e contenere centinaia di migliaia di voci di programmi.

La ragione per cui EPG si rompe così spesso è che questo file deve:

1. Scaricarsi correttamente dal tuo provider.
2. Decomprimersi correttamente (la maggior parte sono gzipped).
3. Essere analizzato senza errori.
4. Corrispondere agli ID dei canali nella tua playlist — è qui che accadono la maggior parte dei fallimenti.
5. Essere visualizzato nella griglia del tuo lettore senza timeout.

Un fallimento in uno di questi cinque passaggi ti dà una guida TV vuota. Andiamo a esaminarli.

Un bug che ho distribuito e poi cacciato personalmente (così puoi individuarlo nel tuo lettore): una versione precedente di Tuneline manteneva il EPG analizzato in memoria e non lo invalidava quando l'utente passava da una fonte Xtream all'altra. Sintomo: la guida sembrava piena, ma i titoli dei programmi erano per i canali del precedente provider. Se reinstalli o forzi l'aggiornamento e appare la guida giusta, questo è questo tipo di bug — ed è sorprendentemente comune nei lettori che memorizzano nella cache in modo aggressivo senza limitare la cache per fonte.

---

Causa 1: Il tuo URL EPG è obsoleto o mancante

Questa è la causa più comune e la più semplice da risolvere. Se stai utilizzando una playlist M3U, il tuo EPG proviene da un URL XMLTV separato che devi inserire manualmente nel tuo lettore. Molti utenti:

• Non hanno mai inserito un URL EPG (il M3U ha canali ma nessuna fonte di guida).
• Hanno inserito un URL EPG mesi fa che da allora è andato offline.
• Hanno inserito l'URL sbagliato — una guida per l'elenco dei canali di un provider diverso.

Come risolvere

Trova la pagina di documentazione del tuo provider. Quasi ogni provider IPTV a pagamento pubblica sia un URL M3U che un URL XMLTV. Di solito hanno questo aspetto:

http://your-provider.example/xmltv.php?username=USER&password=PASS

O:

http://your-provider.example/epg.xml.gz

Incolla questo nelle impostazioni EPG del tuo lettore, forza un aggiornamento e guarda la guida popolarsi. In Tuneline, questo è Impostazioni → EPG → URL XMLTV, con un pulsante di aggiornamento proprio accanto, e la guida di solito si popola entro pochi secondi da un aggiornamento.

Se sei su Xtream Codes, di solito non hai bisogno di impostare un URL EPG — il EPG arriva attraverso la stessa API dei canali. Se la tua guida è vuota su Xtream, passa alla Causa 3.

---

Causa 2: Il EPG si è scaricato ma gli ID dei canali non corrispondono

Questo è il fallimento di EPG più frustrante perché sembra che il EPG abbia funzionato — il tuo lettore dice che si è caricato correttamente — ma la griglia è ancora vuota.

Cosa è successo: il tuo file XMLTV contiene migliaia di canali, ognuno identificato da un tvg-id come news.us o sport.de. La tua playlist M3U ha i suoi propri valori tvg-id. Se gli ID non corrispondono, il lettore non può collegare un programma al suo canale. Finisci con un EPG completamente caricato che è inutile perché niente si collega.

Come individuarlo

Guarda la voce di un canale nel tuo file M3U. La riga avrà questo aspetto:

#EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-logo="...",CNN

Ora guarda il tuo file XMLTV (la maggior parte dei provider te lo fa scaricare direttamente). Cerca l'ID del canale. C'è una voce <channel id="cnn.us"> corrispondente? Se no — o se gli ID sono leggermente diversi (ad es., CNN.us vs cnn.us) — questo è il tuo problema.

Come risolvere

Alcune opzioni, a seconda del tuo lettore:

• La miglior soluzione: Usa un lettore che fa fuzzy matching — cioè, ricade sull'abbinamento dei canali per nome normalizzato quando il tvg-id è mancante o ha maiuscole errate. Il matcher di Tuneline converte in minuscoli entrambi i lati, rimuove i suffissi comuni come "HD"/"FHD"/"4K" e i codici di regione finali, e collassa gli spazi bianchi prima di confrontare. Non è perfetto (due canali genuinamente denominati con lo stesso nome si scontreranno), ma salva il 70–80% delle playlist dove gli ID del provider sono semplicemente disordinati.
• Risoluzione manuale: Modifica il tuo file M3U e cambia i valori tvg-id per corrispondere al file XMLTV. Questo è tedioso ma funziona.
• Soluzione del provider: Invia un'email al tuo provider IPTV e di' loro che gli ID M3U e gli ID XMLTV non corrispondono. Sorprendentemente spesso rigenerano il file — ricevono questo reclamo costantemente.

---

Causa 3: Il server EPG del tuo provider è lento o fa rate-limiting

I file XMLTV grandi richiedono tempo reale per essere scaricati. Se il server EPG del tuo provider è sovraccarico (molto comune durante le ore di punta), il tuo lettore potrebbe andare in timeout prima che lo scaricamento finisca. Alcuni provider limitano anche i tassi dei download di EPG — se hai aggiornato il EPG cinque volte nell'ultima ora, la prossima richiesta potrebbe essere silenziosamente scartata.

Sintomi

• EPG si carica a volte ma non sempre.
• Il primo aggiornamento dopo l'installazione funziona, quindi gli aggiornamenti successivi tornano vuoti.
• EPG funziona alle 3 del mattino ma fallisce alle 8 di sera.

Come risolvere

• Aumenta il timeout di EPG nel tuo lettore. La maggior parte dei lettori hanno come impostazione predefinita 30 secondi. Aumentalo a 120.
• Aggiorna il EPG meno spesso. Una volta ogni 12 o 24 ore è sufficiente per i dati dei programmi in diretta.
• Usa la versione gzipped. Se il tuo provider espone sia epg.xml che epg.xml.gz, usa sempre l'URL gzipped — è tipicamente 5–10× più piccolo.
• Se il provider fa rate-limiting, aspetta un'ora. Poi aggiorna e non aggiornare di nuovo per un giorno.

---

Causa 4: Il tuo file XMLTV è corrotto

Le esportazioni di XMLTV di alcuni provider includono voci malformate — formati di data non validi, caratteri UTF-8 rotti, tag non chiusi. Un parser XML rigoroso rifiuterà di caricare l'intero file a causa di una singola voce rotta, lasciandoti con un EPG vuoto.

Come individuarlo

Se i log del tuo lettore (ogni lettore serio ne ha) mostrano errori come "Errore di parsing XML alla riga 47291" o "fine dell'input non prevista," hai riscontrato un file corrotto.

Come risolvere

Generalmente hai tre opzioni:

• Usa un lettore più indulgente. Alcuni lettori (Tuneline incluso) sono configurati per saltare le voci malformate e caricare il resto. I lettori rigorosi rinunciano all'intero file.
• Usa una fonte EPG diversa. Molti aggregatori pubblici gratuiti di EPG ripubblicano i dati del provider con una formattazione più pulita. Fai attenzione ai termini della licenza.
• Segnala il file danneggiato al tuo provider. Di solito possono ripararlo entro un giorno.

---

Causa 5: Il tuo lettore è semplicemente scarso nel rendere grandi EPG

Alcuni lettori sostengono di supportare EPG ma si bloccano quando la griglia ha più di pochi cento canali. I dati sono lì, il parsing è riuscito, ma l'interfaccia utente o si congela o mostra celle vuote perché rendere contemporaneamente migliaia di voci di programmi è troppo lento.

Sintomi

• Lo scorrimento di EPG è lento.
• Le celle appaiono e scompaiono mentre scorri.
• I primi 50 canali mostrano programmi ma tutto al di sotto di questo è vuoto.

Come risolvere

Questa è una limitazione del lettore. Le soluzioni sono:

• Usa un lettore con rendering EPG virtualizzato. I lettori moderni rendono solo le celle che puoi effettivamente vedere, quindi una guida con 5.000 canali scorre veloce quanto una guida con 50 canali. La griglia EPG di Tuneline è virtualizzata ed è stata testata su playlist con 10.000+ canali — le guide di grandi dimensioni non dovrebbero essere il motivo per cui guardare la TV ti sembra lento.
• Filtra il tuo elenco di canali. Se guardi regolarmente solo 30 canali, nascondi tutto il resto. EPG si renderizza molto più velocemente su un elenco più piccolo.
• Cambia lettore. Questa è spesso la risposta giusta se hai lottato con EPG per mesi.

---

Una Sequenza Diagnostica Che Fa Risparmiare Tempo

Quando qualcuno ci chiede "perché il mio EPG non si carica," li guidiamo attraverso questo in ordine:

1. È configurato un URL EPG? (Se su M3U.) La maggior parte degli utenti ha saltato questo passaggio.
2. L'URL funziona ancora? Aprilo in un browser — dovresti vedere XML o ottenere un download.
3. Gli ID canale nel M3U corrispondono agli ID in XMLTV? Scegli un canale e verifica manualmente.
4. Il server EPG del tuo provider è reattivo in questo momento? Prova a ricaricare in un momento diverso della giornata.
5. Il file XMLTV si analizza correttamente? Controlla i log del lettore per errori di analisi.
6. Il tuo lettore riesce a gestire la dimensione di questa guida? Prova un sottoinsieme più piccolo.

Se affronti sistematicamente questi passaggi, troverai la causa ogni volta.

---

Che Aspetto Ha Davvero un "Buon EPG"

Ecco lo standard a cui devi mantenere il tuo lettore IPTV:

• Caricamento iniziale in < 60 secondi per una guida da 200 MB su Wi-Fi.
• Aggiornamento in background che non interrompe la riproduzione.
• Corrispondenza fuzzy degli ID così le playlist leggermente non allineate si collegano comunque.
• Barra Ora/Prossimo che mostra cosa va in onda adesso e cosa viene dopo senza aprire la griglia completa.
• Ricerca in EPG — trova "a che ora è la partita?" senza scorrere.
• Promemoria — avvisami quando un programma specifico sta per iniziare.
• Integrazione Catch-up — fare clic su un programma trasmesso 3 ore fa riproduce il catch-up, se il provider lo supporta.

Se il tuo lettore attuale non fa la maggior parte di questi, non è normale. È un segno che il tuo lettore è indietro rispetto allo stato dell'arte.

---

Domande Frequenti

Perché il mio EPG mostra vecchi programmi di anni fa?

Il tuo file XMLTV è obsoleto. Il tuo lettore ha scaricato una guida una volta e non l'ha aggiornata da allora. Effettua un aggiornamento manuale, quindi verifica che sia abilitato l'aggiornamento automatico giornaliero.

Perché EPG funziona per alcuni canali ma non per altri?

Quasi sempre un problema di corrispondenza tvg-id (Causa 2). I canali con EPG hanno ID che corrispondono al file XMLTV; quelli senza, no.

C'è una fonte pubblica gratuita di EPG che posso usare?

Sì — progetti come iptv-org/epg mantengono esportazioni XMLTV curate dalla comunità per molti paesi. La qualità varia. Sono migliori come supplemento alla EPG del tuo provider, non come sostituto.

Tuneline ha un supporto EPG migliore rispetto ai lettori IPTV più vecchi?

Abbiamo costruito il supporto EPG specificamente perché ogni altro lettore che abbiamo provato falliva in una delle cinque cause sopra. Tuneline fa corrispondenza fuzzy degli ID, rendering virtualizzato della griglia, aggiornamento in background, ricerca, promemoria e integrazione catch-up dove supportato. Nessuno di questi è magia — è solo quello che una guida TV dovrebbe fare nel 2026.

Con quale frequenza devo aggiornare il mio EPG?

Una volta al giorno è più che sufficiente per i dati dei programmi in diretta. La maggior parte dei provider aggiorna il loro XMLTV una o due volte al giorno. Aggiornare ogni 15 minuti non ti darà dati più recenti — sovraccaricarà solo il tuo provider e rischi di essere bloccato.

---

La Versione Breve

I problemi con EPG sembrano misteriosi ma sono quasi sempre causati da uno di cinque problemi risolvibili: URL mancante, ID canale non corrispondenti, provider lento, file corrotto o rendering debole del lettore. Affrontali in ordine e fisserai la guida in meno di un'ora.

Se sei stanco di combattere gli stessi EPG difetti ogni poche settimane, prova Tuneline — la corrispondenza fuzzy degli ID, il rendering virtualizzato e l'aggiornamento in background sono standard. La tua guida dovrebbe semplicemente funzionare.