IPTV su Apple TV: Impostazione EPG& Guida alla Configurazione

Se hai già i tuoi canali in riproduzione ma la guida dei programmi è vuota, errata o mostra orari sbagliati di alcune ore, hai colpito la frustrazione post-configurazione più comune con IPTV su Apple TV: configurazione EPG. La buona notizia è che è quasi sempre risolvibile una volta che capisci cosa sta realmente succedendo sotto il cofano.

Questa guida spiega come funziona il sistema di guida, come impostarlo correttamente e come risolvere il problema specifico che stai vedendo — che si tratti di una guida vuota, di elenchi non corrispondenti o di una guida che scompare dopo un giorno.

Cos'è l'EPG e come si collega alla tua playlist IPTV

La più grande incomprensione che vedo è che le persone trattano l'elenco dei canali e la guida dei programmi come una cosa sola. Non lo sono. Sono due file completamente separati, e la tua app player Apple TV deve unirli da sola.

Playlist M3U vs. Guida XMLTV: Due File Separati

La tua playlist M3U (o M3U8) è solo un elenco di flussi di canali — un URL per canale, con alcuni metadati allegati. Non contiene alcun dato di programmazione. Gli elenchi dei programmi provengono da un file XMLTV separato, che di solito è un.xml o gzippato.xml.gz file ospitato al proprio URL. Il player scarica entrambi, poi capisce come collegarli.

Quel passaggio di connessione è dove origina la maggior parte dei problemi EPG.

Come il tvg-id Mappa i Canali ai Dati della Guida

All'interno di ogni voce di canale nel tuo M3U, il#EXTINF riga porta attributi cometvg-id,tvg-name,tvg-logo, egroup-title. Quello che conta per la corrispondenza della guida ètvg-id. Il player prende quel valore e cerca una corrispondenza<channel id="..."> voce nel file XMLTV. Se gli ID corrispondono esattamente — inclusi maiuscole e minuscole — allega il programma a quel canale. Se non corrispondono, non ottieni nulla.

Questa è la vera causa principale della maggior parte delle guide vuote o non corrispondenti. La stringa deve essere una corrispondenza esatta.CNN ecnn sono diversi.CNN.us eCNN sono diversi. Nessun abbinamento fuzzy, nessun fallback.

Alcune playlist usanotvg-name invece ditvg-id, e alcuni lettori ricorrono all'abbinamento basato sul nome quando non è presente alcun ID. Ma l'abbinamento per nome è meno affidabile e dipende interamente da come il lettore specifico lo gestisce. Dovunque sia possibile, vuoi valori corretti ditvg-id .

Da dove proviene l'URL EPG

Il tuo fornitore IPTV di solito ti fornisce un URL XMLTV insieme al tuo link M3U — entrambi fanno parte delle tue credenziali di abbonamento. A volte l'M3U stesso contiene unurl-tvg ox-tvg-url tag nella parte superiore del file che punta alla guida. Quando quel tag è presente, alcuni lettori lo rilevano automaticamente. Altri lo ignorano completamente e richiedono di inserire manualmente l'URL. Vale la pena controllare entrambi.

Passo dopo passo: Aggiungere e configurare l'EPG in un lettore IPTV Apple TV

I nomi esatti dei menu variano a seconda dell'app, ma i lettori IPTV tvOS seguono essenzialmente lo stesso schema per IPTV su Apple TV: configurazione EPG. Ecco come appare il flusso nella maggior parte di essi.

Inserire l'URL XMLTV nelle impostazioni del lettore

Apri la tua app lettore e naviga su Impostazioni o sulla schermata di configurazione della playlist.Cerca un campo etichettato con qualcosa come "EPG URL", "Guide URL" o "XMLTV". Incolla il tuo link XMLTV lì — di solito è un lungo URL che termina con.xml o.xml.gz. Salva le impostazioni. Il lettore dovrebbe immediatamente mettere in coda un download del file della guida.Una cosa da tenere d'occhio: se il tuo URL XMLTV è servito tramite HTTP semplice invece di HTTPS, alcune versioni di tvOS bloccheranno completamente la richiesta. Lo stesso vale per

tvg-logo URL delle immagini — se i loghi dei canali non appaiono, spesso è per questo. Assicurati che entrambi gli URL utilizzino HTTPS.Forzare un aggiornamento della guida e impostare l'intervallo di aggiornamento automatico

Dopo aver salvato, la maggior parte delle app ha un pulsante "Aggiorna EPG" o "Aggiorna Guida" da qualche parte nelle impostazioni. Usalo. Non aspettare l'aggiornamento automatico — conferma che la guida si carichi correttamente in questo momento.

Per l'intervallo di aggiornamento automatico, la maggior parte dei lettori ti consente di impostarlo ogni 6, 12 o 24 ore. Attieniti a 12 o 24 ore. Aggiornare più frequentemente può portare il tuo IP a essere limitato o temporaneamente bloccato dall'host XMLTV, il che significa che la tua guida non si aggiorna silenziosamente senza mostrare alcun errore.

Verificare che i canali siano abbinati alle voci della guida

Dopo che l'aggiornamento è completato, vai su un canale di cui ti aspetti di avere dati della guida e controlla l'EPG. Se è vuoto, il problema è quasi certamente un

tvg-id mismatch. Apri il tuo file M3U in un editor di testo su un altro dispositivo e trova iltvg-id per quel canale. Poi controlla il file XMLTV per unchannel id="..."< con quel valore esatto. Se c'è qualche discrepanza, gli ID devono essere corretti alla fonte — sia nell'M3U che nell'XMLTV.>Impostare il fuso orario e l'offset di tempo corretti

I timestamp XMLTV sembrano

XMLTV timestamps look like 20260623180000 +0000 — questo è un orario UTC con un offset esplicito incorporato. Il lettore lo converte nel tuo orario locale. Se la conversione è errata, ogni elenco si sposta della stessa quantità, tipicamente un numero intero di ore.

Per prima cosa, controllaImpostazioni> Generale> Data& Ora sull'Apple TV stessa e assicurati che "Imposta automaticamente" sia attivato. Se il fuso orario del dispositivo è errato, ogni app mostrerà orari spostati. In secondo luogo, alcuni lettori IPTV hanno una propria impostazione di offset temporale separata nella configurazione EPG — controlla un campo "+0" o "offset UTC" e impostalo per corrispondere alla tua reale differenza di fuso orario rispetto all'UTC. Le transizioni dell'ora legale sposteranno le cose di un'ora due volte all'anno se l'app o il dispositivo non gestiscono automaticamente l'ora legale, quindi vale la pena ricontrollare a marzo e novembre.

Correzione dei problemi EPG più comuni su Apple TV

Sintomo prima, poi causa, poi soluzione. Questo è il formato più utile per la risoluzione dei problemi.

La guida è completamente vuota

Tre cause più probabili: l'URL XMLTV è errato o scaduto, il file è compresso in gzip e il lettore non riesce a decomprimerlo, oppure nessuno deitvg-id valori nel tuo M3U corrisponde a nulla nell'XMLTV. Controlla prima l'URL — incollalo direttamente in un browser su un altro dispositivo e conferma che restituisca dati. Se ottieni un.xml.gz file che il tuo lettore non supporta, devi trovare una versione non compressa della stessa guida o passare a un lettore che gestisce gzip nativamente.

I programmi sono sfasati di diverse ore

Quasi sempre è un problema di fuso orario. Verifica il fuso orario di sistema dell'Apple TV sotto Impostazioni> Generale> Data& Ora, poi controlla l'impostazione di offset temporale del lettore. Se la guida mostra costantemente tutto spostato esattamente di 5 ore, ad esempio, c'è un disallineamento UTC-5 da qualche parte. Correggi prima il fuso orario del dispositivo, poi l'offset del lettore se è un'impostazione separata.

Canale giusto, dati del programma sbagliati

Questo è interessante. Se un canale mostra un programma ma è ovviamente quello sbagliato — un canale sportivo che mostra un programma di notizie, ad esempio — probabilmente hai unatvg-id collisione. Due canali diversi nel tuo M3U condividono lo stessotvg-id, e il lettore ha abbinato uno ai dati della guida destinati all'altro. La correzione richiede di modificare l'M3U per assegnare ID unici e corretti. Non puoi farlo dall'Apple TV.

Alcuni canali hanno una guida, altri no

I canali privi di dati della guida o non hanno untvg-id nell'M3U, hanno un ID che non corrisponde a nulla nell'XMLTV, oppure quei canali specifici semplicemente non sono inclusi nella fonte XMLTV fornita dal tuo provider. Controlla l'M3U per i canali mancanti e confronta itvg-id valori con l'elenco dei canali del file XMLTV. I canali regionali o meno popolari sono spesso omessi completamente dalle fonti della guida.

La guida si carica e poi scompare dopo un giorno

La maggior parte dei file XMLTV porta solo 2–7 giorni di dati futuri. Se il file fornisce solo 24–48 ore e l'auto-aggiornamento non funziona, esaurirai i dati della guida. Controlla che l'auto-aggiornamento sia abilitato nelle impostazioni del lettore e conferma che l'URL XMLTV stia ancora restituendo dati freschi. Alcuni lettori cancellano anche la cache della guida quando l'app è completamente chiusa; se ciò accade, un aggiornamento manuale al prossimo avvio è la soluzione.

Qualità dei dati EPG, finestra di copertura e archiviazione su Apple TV

Comprendere i limiti tecnici del formato della guida aiuta a stabilire aspettative realistiche — e spiega alcuni comportamenti che altrimenti sembrerebbero un bug.

Quanti giorni di dati della guida i file XMLTV portano tipicamente

I file XMLTV standard coprono da 2 a 7 giorni di programmazione futura. Alcuni provider offrono guide di 14 giorni per determinate regioni. Oltre la finestra di copertura, la guida semplicemente non mostra nulla — non un errore, solo vuoto. Questo è un comportamento previsto, non una misconfigurazione.

Dimensione del file, compressione Gzip e limiti di memoria su Apple TV HD più vecchie

Un file XMLTV multi-regione che copre centinaia di canali può facilmente raggiungere i 50–100 MB non compressi. L'Apple TV HD (il modello più vecchio con chip A8) ha 1 GB di RAM condiviso tra tutto, il che significa che file guida molto grandi possono causare caricamenti lenti, crash o fallimenti silenziosi. L'Apple TV 4K gestisce questo molto meglio.

Se sei su un'Apple TV HD, preferisci le guide compresse in gzip (.xml.gz) — sono tipicamente 5–10 volte più piccole durante il trasferimento. Se il tuo fornitore offre una guida specifica per regione piuttosto che una globale, usala invece del file multi-regione completo. È il modo più semplice per ridurre sia il tempo di download che la pressione sulla memoria.

Flag di Recupero / Archivio e Come Appaiono nella Guida

Al alcune playlist M3U includono attributi comecatchup="default",catchup-source, otimeshift nelle voci del canale. Quando un lettore supporta questi, mostrano un pulsante "riavvolgi" o "ricomincia" nell'interfaccia della guida per i programmi passati. Non tutti i lettori tvOS implementano il recupero, e richiede sia il supporto lato server che i corretti flag M3U — avere solo l'attributo non lo fa funzionare se lo stream non lo supporta.

Loghi, Descrizioni e Metadati di Categoria

I loghi dei canali provengono dall'tvg-logo URL nell'M3U. Le descrizioni dei programmi e le categorie provengono dal file XMLTV stesso, tipicamente all'interno di<desc> e<category> tag per programma. Se i loghi non si caricano, conferma che gli URL siano HTTPS. Se le descrizioni mancano nella guida, è il fornitore XMLTV che non le include — il lettore può mostrare solo ciò che è nel file.

Cosa Non Funziona (e Perché)

Alcune cose confondono le persone costantemente quando gestiscono IPTV su Apple TV: la configurazione EPG che sembra corretta ma non si comporta come previsto.

Aspettarsi che la Guida Ripari uno Stream di Canale Rotto

L'EPG è metadati. Ti dice cosa dovrebbe esserci su un canale — non ha alcun effetto su se lo stream effettivamente viene riprodotto. Un canale che bufferizza, si interrompe o restituisce uno schermo nero ha un problema a livello di stream. Correggere la guida non aiuterà. Questi sono sistemi completamente separati.

Usare una Guida da una Fonte di Canale Differente

Un file XMLTV generico da un aggregatore EPG di terze parti non corrisponderà alla tua playlist a meno che itvg-id valori nel tuo M3U non siano stati specificamente impostati per allinearsi con gli ID canale di quell'aggregatore. La maggior parte delle volte non lo erano, quindi ottieni una guida vuota anche se entrambi i file sono tecnicamente validi. La fonte XMLTV deve corrispondere agli ID canale nel tuo specifico M3U. Non c'è modo di aggirare questo lato Apple TV.

Modificare Manualmente la Guida sull'Apple TV Stessa

tvOS non ti offre alcun modo per modificare manualmente le voci della guida, rimappare gli ID canale o sovrascrivere le singole voci. Tutto deve essere corretto a monte — nel file M3U o nella fonte XMLTV. Se un canale ha i dati della guida errati, quella correzione deve avvenire prima che i file raggiungano l'Apple TV. Nessuna app di lettore su tvOS offre funzionalità di modifica della guida; non è una limitazione di un'app specifica, è semplicemente come funziona la piattaforma.