L’EPG IPTV est le guide des programmes affiché dans votre application. Il provient d’un fichier XMLTV : votre fournisseur le fournit souvent automatiquement avec la connexion Xtream ou via une URL EPG. Sinon, vous pouvez ajouter une source gratuite comme XML TV Fr (https://xmltvfr.fr/xmltv/xmltv_tnt.xml.gz pour la TNT). Collez l’URL dans les réglages EPG de l’application, lancez la mise à jour, puis vérifiez le décalage horaire et la correspondance des identifiants de chaînes.
EPG et XMLTV : c’est quoi ?
EPG signifie Electronic Program Guide, le guide électronique des programmes : la grille qui affiche ce qui passe maintenant et ensuite sur chaque chaîne. En IPTV, ces données sont presque toujours livrées dans un fichier au format XMLTV, qui contient deux types d’entrées :
<channel id="...">: la liste des chaînes couvertes, avec leur identifiant ;<programme>: chaque émission, avec heure de début, de fin, titre et description.
La playlist (M3U) et le guide (XMLTV) sont deux fichiers distincts. L’application les relie grâce à l’attribut tvg-id de chaque chaîne dans la M3U, qui doit correspondre au channel id du XMLTV. L’EPG n’est pas indispensable pour regarder une chaîne : sans lui, la lecture fonctionne, mais la grille reste vide.
D’où vient l’EPG : d’abord votre fournisseur
Dans la plupart des cas, vous n’avez rien à chercher :
- Connexion Xtream Codes (serveur, identifiant, mot de passe) : les applications compatibles récupèrent l’EPG du fournisseur automatiquement.
- Playlist M3U : l’URL du guide est parfois intégrée dans l’en-tête de la playlist, via l’attribut
x-tvg-url(par exemple#EXTM3U x-tvg-url="..."), ou communiquée séparément par le fournisseur.
Ajouter une source externe n’a d’intérêt que si votre fournisseur n’en donne pas, ou si son guide est incomplet pour certaines chaînes.
Sources EPG gratuites pour les chaînes françaises
XML TV Fr (xmltvfr.fr)
Le site XML TV Fr publie gratuitement des fichiers XMLTV mis à jour quotidiennement, avec environ cinq jours de programmes. Trois guides sont proposés, chacun en plusieurs formats (.xml.gz, .zip, .xz et XML brut) :
| Guide | Contenu annoncé | URL (format .xml.gz) |
|---|---|---|
| TNT France | Toutes les chaînes de la TNT française | https://xmltvfr.fr/xmltv/xmltv_tnt.xml.gz |
| France | Environ 400 chaînes accessibles en France métropolitaine | https://xmltvfr.fr/xmltv/xmltv_fr.xml.gz |
| Complet | Environ 780 chaînes | https://xmltvfr.fr/xmltv/xmltv.xml.gz |
Le site demande d’utiliser de préférence les versions compressées, beaucoup plus légères que le XML brut (la version brute du guide TNT est disponible en https://xmltvfr.fr/xmltv/xmltv_tnt.xml). Choisissez le plus petit guide qui couvre vos chaînes : un fichier énorme ralentit les appareils modestes. La liste des chaînes de chaque guide est consultable sur le site avec leur identifiant (par exemple TF1.fr pour TF1) : c’est la valeur que doit porter le tvg-id de la chaîne dans votre playlist.
Le projet iptv-org/epg
Le projet open source iptv-org/epg sur GitHub n’est pas une URL prête à coller : c’est un ensemble d’outils qui génère un fichier guide.xml à partir de sites de programmes, sur votre propre machine (Node.js) ou via Docker. Il s’adresse donc à des utilisateurs à l’aise avec la ligne de commande. Le dépôt contient aussi un fichier GUIDES.md où des membres de la communauté partagent des guides générés ; leur disponibilité dépend de ces contributeurs.
Ajouter une source EPG dans votre application
Le principe est le même partout : coller l’URL XMLTV dans les réglages EPG ou dans les paramètres de la playlist, puis forcer une mise à jour du guide.
IPTV Smarters Pro
Avec une connexion Xtream, l’EPG du fournisseur est chargé par l’application ; si le guide est vide, ouvrez les paramètres de l’application et lancez le chargement ou l’actualisation de l’EPG, puis patientez pendant le téléchargement. Les intitulés exacts varient selon la version et la plateforme. Si l’application elle-même ne démarre plus ou ne se connecte plus, consultez IPTV Smarters Pro ne fonctionne plus.
TiviMate
Avec une playlist Xtream, l’EPG du fournisseur est normalement associé automatiquement. Pour une source supplémentaire, ouvrez les paramètres de TiviMate, rubrique consacrée à l’EPG, ajoutez une nouvelle source en collant l’URL XMLTV, puis lancez une mise à jour du guide. Les noms de menus pouvant changer d’une version à l’autre, fiez-vous aux intitulés affichés dans votre application.
Kodi (PVR IPTV Simple Client)
Dans l’extension PVR IPTV Simple Client, choisissez Configurer, ouvrez l’onglet EPG, réglez l’emplacement sur chemin distant et collez l’URL XMLTV. Selon la documentation officielle de l’extension, les fichiers compressés Gzip (.xml.gz) et XZ sont acceptés, et un réglage de décalage (EPG time shift) corrige les horaires de -12 h à +14 h. Toute la procédure est détaillée dans notre guide Kodi IPTV avec PVR IPTV Simple Client.
SS IPTV
SS IPTV dispose déjà de son propre guide pour de nombreuses chaînes. Pour une source externe, la documentation SS IPTV indique qu’il faut déclarer l’URL dans l’en-tête de la playlist : #EXTM3U x-tvg-url="URL_du_guide". Points importants de cette documentation :
- le XMLTV compressé n’est pas accepté : utilisez un fichier
.xmlbrut ; - la taille recommandée d’un XMLTV est inférieure à 5 Mo, car les téléviseurs ont peu de ressources ;
- l’identifiant de chaîne utilisé est
tvg-name, ettvg-shiftdécale les horaires (par exempletvg-shift="+1").
À titre indicatif, le guide TNT brut de XML TV Fr pèse un peu plus de 5 Mo : il dépasse légèrement cette recommandation. Plus de détails dans notre guide SS IPTV.
Pour les autres lecteurs (Apple TV, iPhone, Smart TV), notre comparatif des meilleures applications IPTV indique lesquelles gèrent une source EPG externe.
« EPG non disponible » : les causes et leurs corrections
Commencez par un test simple : ouvrez l’URL XMLTV dans un navigateur. Si rien ne se télécharge ou qu’une erreur s’affiche, la source est en cause, pas votre appareil.
| Symptôme | Cause probable | Correction |
|---|---|---|
| Guide vide sur toutes les chaînes | URL absente, mal saisie, expirée, ou serveur EPG du fournisseur indisponible | Vérifiez l’URL, testez-la dans un navigateur, relancez la mise à jour ; si elle ne répond nulle part, contactez le fournisseur |
| Guide vide sur certaines chaînes seulement | tvg-id de la M3U différent du channel id du XMLTV, ou chaîne non couverte par la source |
Comparez les deux identifiants ; certaines applications permettent d’associer manuellement une chaîne à une entrée du guide |
| Bons programmes, mauvaises heures | Fuseau horaire de l’appareil ou décalage EPG | Mettez l’horloge de l’appareil en automatique, remettez le décalage à 0, puis ajustez heure par heure si nécessaire |
| Le guide ne se charge pas du tout | Format non pris en charge (.gz refusé, ou fichier trop lourd pour l’appareil) |
Essayez la version .xml brute (SS IPTV) ou la version .xml.gz (Kodi), ou un guide plus petit |
| Le guide s’arrête après quelques jours | Fichier non actualisé | Vérifiez l’intervalle de mise à jour automatique ou forcez une actualisation ; les sources gratuites couvrent généralement quelques jours seulement |
Un compte expiré coupe aussi l’EPG du fournisseur : vérifiez la date d’échéance de l’abonnement. Si la chaîne elle-même ne se lance pas, ce n’est plus un problème de guide : voyez notre page erreur de lecture IPTV.
Si vous cherchez un abonnement qui fournit son guide des programmes avec la connexion, découvrez Smart Abonnement IPTV et les tarifs de l’abonnement IPTV.
Questions fréquentes
Qu’est-ce que l’EPG sur IPTV ?
C’est le guide électronique des programmes affiché dans l’application IPTV : titre, horaire et description des émissions de chaque chaîne. Les données viennent d’un fichier XMLTV, fourni par votre fournisseur ou par une source externe. Il n’est pas nécessaire à la lecture des chaînes.
Comment ajouter une source EPG ?
Ouvrez les réglages EPG (ou les paramètres de la playlist) de votre application, collez l’URL XMLTV, puis lancez une mise à jour du guide. Sur SS IPTV, l’URL se déclare dans l’en-tête de la playlist avec x-tvg-url. Sur Kodi, elle se colle dans l’onglet EPG de PVR IPTV Simple Client.
C’est quoi l’EPG non disponible ?
Ce message signifie que l’application n’a trouvé aucun programme pour la chaîne. Soit la source EPG est absente ou injoignable, soit l’identifiant de la chaîne ne correspond à aucune entrée du fichier XMLTV. La chaîne reste généralement lisible.
Où puis-je trouver un EPG gratuit pour mon appareil IPTV ?
Pour les chaînes françaises, XML TV Fr publie des guides gratuits (TNT, France, complet) mis à jour chaque jour, par exemple https://xmltvfr.fr/xmltv/xmltv_tnt.xml.gz. Le projet iptv-org/epg permet de générer son propre guide, mais demande des compétences techniques.
Comment activer EPG ?
Avec une connexion Xtream, l’EPG est en général activé automatiquement : il suffit de lancer son chargement dans l’application. Avec une M3U, ajoutez une URL XMLTV dans les réglages EPG, puis forcez l’actualisation et patientez pendant le téléchargement.
