EPG et XMLTV expliqués : comment fonctionnent les guides de programmes IPTV
Visualisation d’une grille EPG
Image hero montrant une grille EPG dans Undaplayer avec plusieurs programmes répartis sur des créneaux horaires.
Taille : 1200×675
Alt : « Grille EPG dans Undaplayer montrant chaînes et créneaux horaires »
Si vous avez déjà ouvert un lecteur IPTV et vu les noms des chaînes sans aucun guide des programmes — aucun titre, aucun horaire, aucun synopsis — vous êtes tombé sur un problème d’EPG. Le guide électronique des programmes est la grille qui indique ce qui passe actuellement sur une chaîne et ce qui arrive ensuite, et le faire fonctionner de manière fiable est le casse-tête de configuration le plus courant en IPTV.
Ceci est l’approfondissement sur l’EPG. Pour la vue d’ensemble de la place de l’EPG dans un lecteur IPTV, consultez notre Guide du lecteur IPTV — cet article suppose que vous en avez déjà lu les bases.
Qu’est-ce qu’un EPG ?
EPG signifie Electronic Program Guide (guide électronique des programmes). C’est l’équivalent numérique d’une page de programme télé dans un journal — une grille montrant quels programmes passent sur quelles chaînes, quand ils commencent et se terminent, et idéalement de quoi ils parlent. Sur un boîtier câble ou satellite traditionnel, l’EPG est intégré. En IPTV, il doit être récupéré séparément, et c’est là que ça se complique.
Pourquoi l’EPG est séparé de la playlist. Votre playlist M3U liste les chaînes et les URL de flux. L’EPG est un fichier complètement différent — généralement bien plus volumineux — listant les programmes et leurs horaires. Le lecteur télécharge les deux et les fait correspondre via l’attribut tvg-id (voir plus bas).
Le format XMLTV
Presque tous les EPG IPTV utilisent le format XMLTV — un standard XML ouvert avec deux types d’éléments : les déclarations <channel> et les entrées <programme>.
FORMAT XMLTV
<tv>
<channel id="news.uk">
<display-name>News UK</display-name>
<icon src="https://example.com/news.png" />
</channel>
<programme start="20260526200000 +0000"
stop="20260526210000 +0000"
channel="news.uk">
<title>Evening News</title>
<desc>Résumé quotidien de l'actualité avec couverture régionale.</desc>
<category>News</category>
</programme>
</tv>
Le channel id du fichier XMLTV doit correspondre exactement au tvg-id de votre playlist M3U. S’ils ne correspondent pas, le lecteur n’a aucun moyen de relier « News UK dans votre playlist » aux « données de programme de News UK dans le XMLTV ». C’est la cause n°1 des EPG vides.
Comment fonctionne la correspondance tvg-id
Chaque chaîne de votre M3U doit avoir un attribut tvg-id correspondant à un identifiant de chaîne dans le fichier XMLTV :
M3U + XMLTV
Dans votre M3U : #EXTINF:-1 tvg-id="news.uk" tvg-logo="...",News UK https://stream.example.com/news/ Dans votre XMLTV : <channel id="news.uk"> <display-name>News UK</display-name> </channel> → Le lecteur fait correspondre "news.uk" des deux côtés et affiche l'EPG.
Si les identifiants ne correspondent pas exactement — sensible à la casse, sans espace superflu — pas d’EPG. Les erreurs les plus courantes :
- La playlist utilise
tvg-id="NewsUK"mais le XMLTV utiliseid="news.uk" - La playlist n’a aucun attribut
tvg-id - Différentes sources XMLTV utilisent des conventions d’identifiants différentes (
BBC1.ukvsbbc.one.uk) - Le fichier XMLTV est dans un fuseau horaire différent et les horaires semblent faux
Visualisation de la correspondance tvg-id
Diagramme vectoriel montrant deux encadrés côte à côte : playlist M3U (avec tvg-id= »news.uk ») et fichier XMLTV (avec channel id= »news.uk »), reliés par une flèche verte intitulée « CORRESPONDANCE ».
Taille : 900×400
Alt : « Schéma montrant la correspondance tvg-id entre playlist M3U et fichier XMLTV »
Où trouver des sources EPG
Certains fournisseurs IPTV livrent l’URL de leur EPG avec votre abonnement — vérifiez l’e-mail de bienvenue ou le tableau de bord. Pour les chaînes publiques gratuites, quelques sources bien connues couvrent la plupart des besoins :
| Source | Couverture | Fiabilité |
|---|---|---|
| iptv-org/epg | Diffusions publiques mondiales | Élevée · open-source |
| epg.pw | 200+ pays, organisé par langue | Élevée · maintenu par la communauté |
| Fourni par le fournisseur | Chaînes de votre abonnement | Variable |
| schedulesdirect.org | Guide premium Amérique du Nord | Élevée · service payant |
Combiner plusieurs sources EPG
Les lecteurs à EPG unique vous forcent à choisir : un EPG français avec une excellente couverture française mais rien pour le Royaume-Uni, ou un EPG mondial avec une couverture correcte partout mais sans votre chaîne locale préférée. Undaplayer résout ce problème avec le multi-EPG : combinez jusqu’à cinq sources et décidez laquelle prévaut par chaîne.
Comment fonctionne la priorité. Quand deux sources EPG ont toutes deux des données pour la même chaîne, Undaplayer utilise la source de priorité la plus élevée. Vous pouvez réordonner les sources dans Réglages → EPG → Sources par glisser-déposer.
Pourquoi votre EPG ne s’affiche pas
Par ordre de fréquence, voici pourquoi l’EPG ne s’affiche pas :
- Non-correspondance des tvg-id. La cause la plus fréquente. Vérifiez que les valeurs
tvg-idde votre M3U correspondent exactement aux valeurschannel iddu XMLTV. - Source EPG inaccessible. L’URL XMLTV est morte ou temporairement hors service. Essayez d’ouvrir l’URL dans un navigateur — si elle ne renvoie pas de XML, la source est cassée.
- Mauvais fuseau horaire. Les horaires XMLTV incluent un décalage de fuseau horaire comme
+0000. Si votre lecteur n’applique pas ce décalage, les programmes s’affichent aux mauvaises heures. - Cache obsolète. Le lecteur a encore l’EPG d’hier. Forcez l’actualisation dans les réglages, ou attendez la prochaine récupération programmée (généralement toutes les 12 à 24 heures).
- Limite de taille XMLTV. Certains lecteurs plafonnent l’analyse à environ 50 Mo. Les fichiers XMLTV volumineux (200 Mo et plus) sont tronqués ou rejetés.
Comment ajouter une source EPG dans Undaplayer
Voici la procédure exacte en 4 étapes. La même logique s’applique à la plupart des lecteurs IPTV Android, avec des emplacements de menu légèrement différents.
Écran Réglages → Sources EPG
Capture d’écran annotée de la boîte de dialogue « Ajouter une source EPG » dans Undaplayer. Mettre en évidence le champ URL, le champ nom, et le bouton Enregistrer.
Taille : 1200×800
Alt : « Boîte de dialogue Ajouter une source EPG d’Undaplayer avec champs URL et nom »
-
Trouvez une URL EPG correspondant à votre playlist
Identifiez une source XMLTV couvrant les chaînes de votre playlist. Sources courantes :
iptv-org/epg,epg.pw, ou les flux fournis par votre fournisseur. Copiez l’URL directe (elle doit se terminer par.xml,.xml.gz, ou sans extension). -
Ajoutez l’URL EPG dans les réglages du lecteur
Dans Undaplayer, allez dans Réglages → Sources EPG → Ajouter une source. Collez l’URL XMLTV, donnez-lui un nom (ex. « iptv-org global »), et enregistrez. Le lecteur commencera le téléchargement immédiatement.
-
Vérifiez la correspondance des tvg-id
Assurez-vous que chaque chaîne de votre M3U possède un attribut
tvg-idcorrespondant à unidde chaîne dans le fichier XMLTV. Si ça ne correspond pas, l’EPG ne s’affichera pas. Undaplayer affiche un point vert à côté des chaînes dont les données EPG correspondent. -
Actualisez et vérifiez
Forcez l’actualisation de l’EPG (appui long sur le menu EPG) et vérifiez que les programmes s’affichent correctement. Comptez jusqu’à 24h pour que la couverture complète du guide se charge — les fichiers XMLTV peuvent peser plusieurs centaines de mégaoctets non compressés.
Si votre EPG ne s’affiche toujours pas après 24h, consultez le diagnostic EPG dans Undaplayer (Réglages → EPG → Diagnostics). Il liste exactement quelles chaînes ont trouvé une correspondance et lesquelles non, avec les valeurs tvg-id non appariées affichées pour que vous puissiez les corriger.
Pour le côté M3U de l’équation — comment les playlists définissent les chaînes, les attributs et les catégories de groupe — consultez notre approfondissement complémentaire Référence M3U et Xtream Codes. Pour le parcours d’installation complet sur n’importe quel appareil, direction le Guide d’installation.