Guida

Come trovare e aggiungere la guida TV (EPG) alla tua IPTV

L’EPG, la guida elettronica dei programmi, è quello che mette “ora in onda” e “a seguire” accanto a ogni canale. È un file XMLTV a un indirizzo tutto suo. Ecco com’è fatto quell’indirizzo, dove trovarlo, come aggiungerlo in Aina e cosa controllare quando la guida non mostra niente.

Aggiornato il · Il team di Aina IPTV

  • Le credenziali Xtream Codes ne hanno già uno, sullo stesso server, con lo stesso nome utente e la stessa password: http://server:porta/xmltv.php?username=…&password=…. È il link get.php con xmltv.php al suo posto. Aina lo usa da sola, quindi non devi scrivere niente.
  • Una lista M3U spesso indica la sua guida, nella prima riga: #EXTM3U x-tvg-url="https://…/guide.xml.gz" (oppure url-tvg). Alcune ne indicano più di una, separate da virgole, una per paese; Aina le carica tutte senza che tu lo chieda.
  • Altrimenti il tuo fornitore ti manda un link EPG: un file XMLTV che finisce in .xml, oppure in .xml.gz quando è compresso. Funzionano tutti e due.
  • Un portale MAC porta con sé la sua guida, che Aina legge come farebbe un decoder (set-top box). A un portale che non ne pubblica una puoi dare un link EPG in Impostazioni, poi Fonti della guida TV.

Cosa c’è in un file XMLTV

XMLTV è il formato che usano quasi tutte le guide IPTV: un semplice file di testo, spesso compresso con gzip, con l’elenco dei canali e poi i loro programmi. Queste sono le parti che contano:

Le parti di una guida XMLTV che un player legge.
ParteCosa contiene
<channel id="…">Un canale e l’identificativo sotto cui sono archiviati i suoi programmi, per esempio miocanale.it. L’elenco dei canali della guida è l’insieme di questi.
<display-name>Il nome del canale, a volte in più di una lingua.
<programme start="…" stop="…" channel="…">Un programma, il suo inizio e la sua fine con il fuso orario, e l’identificativo del canale a cui appartiene.
<title>, <desc>, <category>Come si chiama il programma, di cosa parla e di che genere è.

Una settimana di guida per un abbonamento grande può arrivare a centinaia di megabyte, ed è per questo che i fornitori la comprimono. Aina salva il file nella memoria del dispositivo mentre lo scarica e lo legge un pezzo alla volta, così una guida di quelle dimensioni non esaurisce la memoria di un telefono o di una chiavetta TV.

Se il tuo fornitore non ha una guida

  • Prima chiedila. Una guida fatta per il tuo abbonamento è quella che combacia meglio con i suoi canali, e la maggior parte dei fornitori ne ha una anche quando non lo dice.
  • Guarda nella lista. Aprila con un editor di testo e controlla se la prima riga contiene x-tvg-url.
  • Creala da te. iptv-org/epg è un progetto aperto su GitHub che costruisce un file XMLTV dai palinsesti pubblicati dai siti TV, per i canali che scegli tu. È uno strumento da far girare su un computer, non un link pronto, e il file che produce deve stare a un indirizzo che i tuoi dispositivi possono raggiungere.

Aprilo nel browser di un computer. Un link .xml che funziona mostra un testo che inizia con <?xml o <tv; un link .xml.gz scarica un file. Una pagina di accesso, un errore o una pagina vuota vogliono dire che il link è sbagliato o scaduto: chiedine uno nuovo al tuo fornitore. Un link xmltv.php di Xtream Codes che torna vuoto di solito vuol dire che il fornitore non pubblica una guida per quell’abbonamento.

  1. 1

    Inizia ad aggiungere la lista

    In Aina scegli Lista M3U nella schermata Aggiungi il tuo abbonamento, oppure vai in Impostazioni, poi Abbonamenti, poi Aggiungi un abbonamento.

  2. 2

    Incolla il link della lista

    Nel campo URL della lista, come al solito.

  3. 3

    Incolla il link EPG

    Nel campo URL della guida (facoltativo): il link .xml o .xml.gz che ti ha dato il fornitore. Lascialo vuoto se la lista indica già la sua guida.

  4. 4

    Collegati

    Tocca Collegati. Prima arrivano i canali, poi la guida. Una guida grande può richiedere un minuto.

Aggiungere un’altra guida in seguito

Impostazioni, poi Fonti della guida TV, vale per ogni abbonamento, anche Xtream Codes e portali MAC. Aggiungi una guida dal suo indirizzo XMLTV per completare i canali che la guida del fornitore lascia vuoti, dai a ogni guida il suo orario e disattiva quelle che non ti servono. Aggiorna ora la guida applica subito una modifica.

Come la guida trova i tuoi canali

Una lista M3U dà a ogni canale l’identificativo che deve avere nella guida, tvg-id="miocanale.it", e la guida archivia i programmi sotto <channel id="miocanale.it">. Aina abbina le due cose. Se un canale non ha l’identificativo, o la guida ne usa un altro, Aina prova con il nome del canale: così anche una guida presa da un’altra fonte può riempire buona parte del tuo abbonamento.

Guida TV vuota o sbagliata: le cause

  • La guida non copre quei canali. Una guida è pubblicata per un certo gruppo di canali: chiedi al tuo fornitore quella fatta per il tuo abbonamento.
  • Identificativi e nomi non coincidono. I canali che la guida chiama in un altro modo restano vuoti. La guida del tuo fornitore è quella che combacia meglio.
  • La guida è finita. Una guida copre pochi giorni in avanti. Se il fornitore smette di aggiornarla, il palinsesto si ferma dove si ferma il file.
  • Si sta ancora caricando. Aina riempie il palinsesto quando è arrivato tutto il file, e per una guida grande può volerci un minuto o due.
  • Gli orari sono sfasati. Una guida indica il fuso orario di ogni programma, e Aina mostra gli orari nel tuo: che tu sia a Milano o a Lugano, un canale di un altro paese compare alla tua ora. Se tutti i programmi sono spostati delle stesse ore, la guida del fornitore ha il fuso sbagliato: in Impostazioni, poi Fonti della guida TV, spostala avanti o indietro di un’ora o di mezz’ora finché torna.

Cosa ottieni quando è caricata

Ora in onda e a seguire sotto ogni canale; la guida TV con quello che c’è adesso e stasera, con la ricerca per programma; una settimana di palinsesto per ogni canale; e i programmi già andati in onda (Catch-up) dove il tuo fornitore tiene un archivio.

Domande e risposte

Con le credenziali Xtream Codes è l’indirizzo xmltv.php del tuo server con il tuo nome utente e la tua password, e Aina lo usa da sola. Con una lista M3U cerca x-tvg-url nella prima riga, oppure chiedi al tuo fornitore il link .xml o .xml.gz della guida.

Il formato di file che quasi tutti i fornitori IPTV usano per la guida: un elenco di canali, ognuno con un identificativo, e di programmi con il loro canale, orari di inizio e fine, titoli e descrizioni.

Solo perché è compressa, e quindi molto più leggera da scaricare. Aina le legge entrambe.

Sì, in Aina funziona qualsiasi link XMLTV. Una guida presa da un’altra fonte riempie solo i canali con identificativi o nomi che combaciano, quindi conviene partire dalla guida del tuo fornitore e usarne una gratuita accanto a quella, in Fonti della guida TV, per riempire i vuoti.

No. La guida arriva da sola dal pannello del tuo fornitore. Puoi comunque aggiungere guide tue in Impostazioni, poi Fonti della guida TV, per i canali che non copre.