La guida ai programmi XMLTV: cos’è, come si abbina e come importarla
5 min di lettura
Una guida ai programmi (EPG, dalla sigla inglese) ti dice cosa va in onda ora su ogni canale e cosa viene dopo. Per le liste M3U, il modo più comune di distribuirla è XMLTV, un formato aperto in XML che esiste da molti anni e che capiscono quasi tutti i player. Qui vedrai com’è fatto, come si collega ai tuoi canali e cosa fare quando non compare o mostra l’orario sbagliato.
Com’è fatto un file XMLTV
Ha due parti: l’elenco dei canali e l’elenco dei programmi. Un esempio ridotto:
<?xml version="1.0" encoding="UTF-8"?><tv> <channel id="CanalUno.es"> <display-name>Canal Uno</display-name> <icon src="https://example.com/logos/canal-uno.png"/> </channel> <programme start="20261106210000 +0100" stop="20261106220000 +0100" channel="CanalUno.es"> <title>Informativo de la noche</title> <desc>Resumen de la actualidad del día.</desc> <category>Noticias</category> </programme></tv>
channel idè l’identificatore del canale. Non ha un formato fisso, anche se è comune qualcosa comeNombreDelCanal.es.display-nameè il suo nome leggibile; ce ne possono essere diversi.programmeindica il canale a cui appartiene e gli orari di inizio e fine, nel formatoAAAAMMDDhhmmssseguito dalla differenza rispetto all’ora universale:+0100è l’ora della Spagna peninsulare (la stessa dell’Italia) in inverno, e+0200quella estiva.- Dentro ci sono il titolo e, se presenti, il sottotitolo, la descrizione, la categoria e un’immagine.
Le guide complete possono pesare centinaia di mega, per questo di solito vengono pubblicate compresse, in .xml.gz o .zip.
Come si abbina la guida ai tuoi canali
La guida e la lista sono file diversi, spesso di fonti diverse. Per sapere quale palinsesto va con ogni canale, il player cerca le corrispondenze. Whatplay lo fa in questo ordine:
- Tramite il
tvg-iddel canale nella M3U (o l’epgIdin W3U), confrontato con ilchannel iddella guida. - Per nome, se non c’è un identificatore o non corrisponde: il nome del canale nella tua lista confrontato con il
display-namedella guida.
Non serve che coincidano lettera per lettera. Whatplay confronta senza distinguere maiuscole e minuscole, senza accenti e senza spazi né simboli; toglie dalla fine le indicazioni di qualità (HD, FHD, UHD, 4K) e, negli identificatori, il suffisso del paese, come .es. Così «Canal Uno HD» nella tua lista trova «Canal Uno» nella guida. Ma «C1» e «Canal Uno» non si somigliano per niente: per questo c’è il tvg-id.
Un canale ben preparato per la guida si presenta così nella M3U:
#EXTINF:-1 tvg-id="CanalUno.es" tvg-logo="https://example.com/logos/canal-uno.png",Canal Unohttps://example.com/emision/canal-uno.m3u8
Come importarla in Whatplay
- Se la tua lista la indica già (nella M3U, con
url-tvgox-tvg-urlnella riga#EXTM3U; in W3U, conepg), la Guida te lo segnala con l’avviso «La lista «…» include la sua guida ai programmi» e un pulsante per importarla. - Altrimenti, vai nella Guida e tocca «Importa guida». Incolla l’indirizzo di una guida XMLTV (.xml, .xml.gz o .zip) o tocca «Da file» per sceglierne una dal dispositivo.
La guida si scarica in background e si vede man mano che arriva. In «Guide importate» vedrai quanti canali e programmi contiene, e da lì puoi rimuoverla. La Guida ha due viste: «Ora», con quello che va in onda in questo momento su ogni canale, e «Griglia», con l’intera giornata e un selettore dei giorni. Nel player, sotto il nome del canale, compaiono «Ora» e «Dopo». Whatplay aggiorna le guide di tanto in tanto e, se non sono cambiate, non le scarica di nuovo. Il centro assistenza lo riassume in Come aggiungo la guida ai programmi?
Problemi tipici
«Nessun canale delle tue liste compare nelle guide importate»
La guida è stata importata, ma nessun identificatore né nome corrisponde. Apri la guida in un editor di testo, cerca come si chiama il tuo canale nei suoi channel id e metti quel valore nel tvg-id della tua lista. Controlla anche che la guida sia dello stesso paese o della stessa regione dei tuoi canali.
I programmi compaiono con un’ora di differenza
Di solito è la guida a dichiarare male il suo fuso orario: orari locali indicati come +0000, o una differenza che non cambia con l’ora legale. Whatplay rispetta quello che dice ogni programma e lo converte nella tua ora, quindi, se la guida è sbagliata, è nella guida che va corretta.
«Non è una guida XMLTV o non ha programmi per questi giorni»
O l’indirizzo non porta a un XMLTV (per esempio, apre una pagina web), o la guida è scaduta e contiene solo programmi passati. Le guide vengono rigenerate spesso: una copia vecchia smette presto di servire.
Hai incollato la guida in «Aggiungi lista»
Whatplay se ne accorge, ti dice che è una guida ai programmi e non una lista, e ti indica dove importarla con lo stesso indirizzo.
Ci mette molto a caricarsi
Le guide grandi richiedono tempo per essere scaricate e lette. Usa la versione compressa, se esiste, e, se la fonte lo permette, una guida con i soli canali che usi.
La guida è sulla tua rete di casa
Da Android 17, per scaricare una guida da un computer o da un NAS della tua rete, Whatplay ha bisogno dell’autorizzazione «Dispositivi nelle vicinanze». L’app te la chiede con un avviso.
Creare la tua guida
Se trasmetti qualcosa di tuo con un orario fisso, come la radio di un’associazione o il canale di una scuola, puoi scrivere un XMLTV a mano: bastano un channel e i suoi programme, con il fuso orario corretto e il file in UTF-8. Per collegarlo al tuo canale, usa lo stesso identificatore nel tvg-id della tua lista M3U o nell’epgId della tua W3U; trovi spiegati entrambi i formati in M3U, M3U8 e W3U.