Tutte le guide

Risoluzione dei problemi EPG

Guida TV vuota o sbagliata: come risolvere i problemi M3U e XMLTV

Un metodo rigoroso per diagnosticare programmi mancanti, orari sfalsati e programmi associati al canale sbagliato.

Scritto e verificato dal team tecnico di DringTV · Aggiornato il 1° agosto 2026 · 8 min di lettura

Risposta breve

Un EPG corretto richiede tre anelli nella catena: una sorgente XMLTV raggiungibile, lo stesso identificativo di canale nella playlist e nel file XMLTV, e una corretta gestione degli orari. Verifica questi livelli in quest'ordine invece di aggiornare l'app più volte.

Punti chiave

  • La riproduzione e i dati dei programmi sono risorse indipendenti.
  • Il tvg-id della playlist deve corrispondere al channel id dell'XMLTV.
  • Uno sfasamento orario uniforme indica di solito un problema di fuso orario o di offset.
  • Non pubblicare mai un URL XMLTV privato in un forum o in uno screenshot.
01

I tre anelli della catena della guida TV

La playlist descrive le voci multimediali. L'XMLTV descrive i canali e i loro programmi. Il player deve abbinare i due lati tramite un identificativo stabile, poi convertire gli orari dei programmi nel fuso orario del dispositivo.

I nomi visualizzati non bastano. Due nomi diversi possono corrispondere grazie allo stesso ID tecnico, mentre nomi identici possono non essere abbinati se i loro ID sono diversi.

02

Una diagnosi in cinque minuti

  1. Verifica che la voce venga riprodotta; altrimenti il problema principale non è l'EPG.
  2. Controlla che la playlist dichiari una guida tramite url-tvg, oppure che il titolare della sorgente fornisca separatamente un URL XMLTV autorizzato.
  3. Verifica in un browser solo il dominio dell'URL, senza esporre l'indirizzo privato completo né i parametri.
  4. Aggiorna la playlist e la guida, poi lascia che la sincronizzazione termini.
  5. Confronta il tvg-id di una voce della playlist con il channel id corrispondente nell'XMLTV.
03

Interpretare il sintomo

SintomoCausa probabileControllo utile
Nessun programma su nessun canaleXMLTV mancante, irraggiungibile o vuotoIndirizzo dichiarato, stato della rete, dimensione del file e date
Solo alcune voci sono vuotetvg-id mancante o non corrispondenteCorrispondenza esatta dell'identificatore
Tutti i programmi sono sfasatiProblema di fuso orario o di offset della sorgenteOrari XMLTV, fuso del dispositivo e ora legale
Programma sulla voce sbagliataMappatura duplicata o errataValori channel id e tvg-id univoci
La guida si svuota dopo pochi giorniXMLTV non più aggiornato o cache scadutaData dell'ultimo programma e frequenza di aggiornamento
04

Cosa un player può e non può correggere

Un player può scaricare, mettere in cache, indicizzare e visualizzare i dati che riceve. Può dedurre alcune corrispondenze dai nomi, ma una deduzione può associare per errore due canali diversi.

Non può inventare programmi mancanti né correggere in modo definitivo ID incoerenti nella sorgente. La soluzione affidabile è che l'amministratore legittimo della sorgente corregga la playlist o il file XMLTV.

05

Le informazioni utili per una segnalazione di bug

  • Tipo di sorgente: M3U, Xtream Codes o Stalker/Ministra.
  • Numero approssimativo di voci interessate, senza esporre i contenuti privati.
  • Sfasamento orario osservato e fuso orario del dispositivo.
  • Versione dell'app e modello del dispositivo.
  • Ora dell'ultimo aggiornamento riuscito.
  • Non includere mai URL, password, token, indirizzo MAC o screenshot contenenti credenziali.

Domande frequenti

Perché la riproduzione funziona senza una guida TV?

Gli indirizzi di riproduzione e i dati dei programmi sono risorse separate. Una può restare disponibile mentre l'altra manca o è scaduta.

Cambiare il fuso orario della TV risolve sempre uno sfasamento?

Solo se il fuso del dispositivo è sbagliato. Se gli orari XMLTV sono codificati in modo errato, vanno corretti i dati della sorgente.

Riferimenti tecnici

Metti in pratica questi principi in un'interfaccia pensata per la TV

Prezzi · Home