Diagnostic EPG

Guide TV vide ou incorrect : diagnostiquer M3U et XMLTV

Une méthode ordonnée pour comprendre pourquoi les programmes manquent, sont décalés ou apparaissent sur les mauvaises chaînes.

Rédigé et vérifié par l’équipe technique DringTV · Mis à jour le 1er août 2026 · 8 min de lecture

Réponse courte

Un EPG correct dépend de trois maillons : une source XMLTV accessible, un identifiant de chaîne identique entre la playlist et le fichier XMLTV, puis une gestion correcte du temps. Vérifiez ces trois niveaux dans cet ordre au lieu de rafraîchir l’application au hasard.

À retenir

  • Une chaîne peut fonctionner alors que son EPG est totalement indépendant et indisponible.
  • Le champ tvg-id de la playlist doit correspondre à l’identifiant channel du XMLTV.
  • Un décalage uniforme de toutes les émissions indique généralement un problème de fuseau ou d’offset.
  • Ne publiez jamais une URL XMLTV privée dans un forum ou une capture.
01

Les trois maillons du guide des programmes

La playlist décrit les chaînes. Le fichier XMLTV décrit des chaînes et leurs programmes. Le lecteur doit relier les deux grâce à un identifiant stable, puis convertir les heures du fichier vers le fuseau de l’appareil.

Le nom affiché ne suffit pas toujours. « France 2 HD » dans la playlist et « France 2 » dans le guide peuvent fonctionner si leur identifiant technique est identique ; deux noms identiques peuvent échouer si leurs identifiants diffèrent.

02

Diagnostic en cinq minutes

  1. Confirmez que la chaîne se lit : sinon, le problème n’est pas d’abord l’EPG.
  2. Vérifiez que la playlist déclare une URL de guide via url-tvg, ou que votre source fournit séparément une URL XMLTV autorisée.
  3. Ouvrez uniquement le domaine de l’URL dans un navigateur pour vérifier qu’il répond, sans partager l’adresse complète ni ses paramètres privés.
  4. Rafraîchissez la playlist et le guide depuis le lecteur, puis laissez la synchronisation se terminer.
  5. Comparez un tvg-id de la playlist à l’attribut id de la chaîne correspondante dans XMLTV.
03

Interpréter le symptôme

SymptômeCause probableVérification utile
Aucune chaîne n’a de programmeURL XMLTV absente, inaccessible ou fichier videAdresse déclarée, statut réseau, taille et dates du fichier
Quelques chaînes seulement sont videstvg-id absent ou différentCorrespondance exacte des identifiants
Toutes les émissions sont décaléesFuseau ou offset incorrect dans la sourceHeure XMLTV, fuseau de l’appareil et changement saisonnier
Programme associé à la mauvaise chaîneIdentifiants dupliqués ou mapping erronéUnicité des channel id et tvg-id
Le guide devient vide après quelques joursXMLTV non renouvelé ou cache expiréDate du dernier programme et fréquence de mise à jour
04

Ce que le lecteur peut — et ne peut pas — corriger

Un lecteur peut télécharger, mettre en cache, indexer et afficher proprement les données reçues. Il peut parfois rapprocher des noms, mais ce type de déduction reste imparfait et peut associer deux chaînes différentes.

Il ne peut pas inventer les programmes absents ni réparer durablement des identifiants incohérents à la source. La correction la plus fiable consiste à faire ajuster la playlist ou le fichier XMLTV par leur administrateur légitime.

05

Informations utiles pour un rapport de bug

  • Type de source : M3U, Xtream Codes ou Stalker/Ministra.
  • Nombre approximatif de chaînes affectées, sans nommer de contenu privé.
  • Décalage observé et fuseau de l’appareil.
  • Version de l’application et modèle de l’appareil.
  • Heure du dernier rafraîchissement réussi.
  • Jamais d’URL, mot de passe, token, MAC ou capture contenant des identifiants.

Questions fréquentes

Pourquoi les chaînes fonctionnent-elles sans guide TV ?

Les adresses de lecture et les données de programmes sont deux ressources distinctes. L’une peut rester disponible lorsque l’autre est absente ou expirée.

Changer le fuseau du téléviseur suffit-il ?

Seulement si l’appareil utilise un fuseau incorrect. Si les heures sont déjà mal encodées dans XMLTV, la source doit être corrigée.

Références techniques