EPG ne se charge pas ? Guide complet pour réparer votre guide TV IPTV en 2026

Vous avez configuré votre lecteur IPTV. Les chaînes se chargent. Vous pouvez passer de l'une à l'autre. Tout semble parfait — jusqu'à ce que vous ouvriez le guide TV et n'y trouviez qu'une mer de cases vides. Ou pire : des cases affichant les mauvaises émissions, listant des programmes terminés il y a cinq ans.

Les problèmes de EPG sont la deuxième plainte IPTV la plus signalée après les coupures, et le plus frustrant, c'est que les symptômes sont identiques quelle que soit la cause. Ce guide passe en revue les cinq vrais problèmes à l'origine d'un EPG cassé, dans l'ordre où il vaut la peine de les vérifier.

Ce qu'est réellement un EPG

EPG signifie guide électronique des programmes (Electronic Program Guide). Ce sont les métadonnées qui indiquent à votre lecteur IPTV ce qui passe actuellement sur chaque chaîne, ce qui vient ensuite, et quelles sont les descriptions des programmes. Il n'y a rien de magique là-dedans : votre lecteur télécharge un fichier ou interroge une API, en extrait les titres et horaires des programmes, puis les affiche dans une grille à côté de vos chaînes.

Le format standard est le XMLTV : un seul fichier XML listant chaque chaîne, chaque programme, chaque heure de début, chaque durée, et éventuellement les affiches et descriptions. Un fichier XMLTV typique pour un gros fournisseur peut peser 50 à 500 Mo décompressé et contenir des centaines de milliers d'entrées de programmes.

La raison pour laquelle le EPG tombe si souvent en panne, c'est que ce fichier doit :

1. Se télécharger correctement depuis votre fournisseur.
2. Se décompresser correctement (la plupart sont en gzip).
3. S'analyser sans erreur.
4. Correspondre aux identifiants de chaînes de votre playlist — c'est là que se produisent la plupart des échecs.
5. S'afficher dans la grille de votre lecteur sans expirer.

Un échec à l'une de ces cinq étapes vous donne un guide TV vide. Passons-les en revue.

Un bug que j'ai moi-même livré puis traqué (pour que vous puissiez le repérer dans votre propre lecteur) : une version antérieure de Tuneline conservait le EPG analysé en mémoire et ne l'invalidait pas quand l'utilisateur changeait de source Xtream. Symptôme : le guide semblait rempli, mais les titres des programmes correspondaient aux chaînes du fournisseur précédent. Si vous réinstallez ou forcez l'actualisation et que le bon guide apparaît, c'est ce type de bug — et il est étonnamment courant dans les lecteurs qui mettent en cache agressivement sans cloisonner le cache par source.

---

Cause 1 : l'URL de votre EPG est périmée ou absente

C'est la cause la plus courante et la plus simple à corriger. Si vous utilisez une playlist M3U, votre EPG provient d'une URL XMLTV distincte que vous devez saisir manuellement dans votre lecteur. Beaucoup d'utilisateurs ont soit :

• Jamais saisi d'URL EPG du tout (le M3U a des chaînes mais aucune source de guide).
• Saisi une URL EPG il y a des mois qui est depuis passée hors ligne.
• Saisi la mauvaise URL — un guide pour la liste de chaînes d'un autre fournisseur.

Comment corriger

Trouvez la page de documentation de votre fournisseur. Presque tous les fournisseurs IPTV payants publient à la fois une URL M3U et une URL XMLTV. Elles ressemblent généralement à ceci :

http://your-provider.example/xmltv.php?username=USER&password=PASS

Ou :

http://your-provider.example/epg.xml.gz

Collez-la dans les réglages EPG de votre lecteur, forcez une actualisation, et regardez le guide se remplir. Dans Tuneline, c'est Réglages → EPG → URL XMLTV, avec un bouton d'actualisation juste à côté, et le guide se remplit généralement en quelques secondes après une actualisation.

Si vous êtes sur Xtream Codes, vous n'avez généralement pas besoin de définir d'URL EPG du tout — le EPG passe par la même API que les chaînes. Si votre guide est vide en Xtream, passez à la Cause 3.

---

Cause 2 : le EPG s'est téléchargé mais les identifiants de chaînes ne correspondent pas

C'est l'échec de EPG le plus frustrant parce qu'il donne l'impression que le EPG a fonctionné — votre lecteur indique qu'il s'est chargé avec succès — mais la grille reste vide.

Ce qui s'est passé : votre fichier XMLTV contient des milliers de chaînes, chacune identifiée par un tvg-id comme news.us ou sport.de. Votre playlist M3U a ses propres valeurs tvg-id. Si les identifiants ne correspondent pas, le lecteur ne peut pas relier un programme à sa chaîne. Vous vous retrouvez avec un EPG entièrement chargé mais inutile car rien ne se connecte.

Comment le repérer

Regardez l'entrée d'une chaîne dans votre fichier M3U. La ligne ressemblera à ceci :

#EXTINF:-1 tvg-id="cnn.us" tvg-name="CNN" tvg-logo="...",CNN

Regardez maintenant votre fichier XMLTV (la plupart des fournisseurs vous permettent de le télécharger directement). Cherchez l'identifiant de la chaîne. Y a-t-il une entrée <channel id="cnn.us"> correspondante ? Sinon — ou si les identifiants sont légèrement différents (par exemple CNN.us contre cnn.us) — c'est là votre problème.

Comment corriger

Quelques options, selon votre lecteur :

• Meilleure solution : utilisez un lecteur qui fait de la correspondance approximative — c'est-à-dire qui se rabat sur une correspondance des chaînes par nom normalisé quand le tvg-id est absent ou mal capitalisé. Le moteur de correspondance de Tuneline met les deux côtés en minuscules, supprime les suffixes courants comme « HD »/« FHD »/« 4K » et les codes de région en fin de nom, et réduit les espaces avant de comparer. Ce n'est pas parfait (deux chaînes réellement nommées de la même façon entreront en collision), mais cela sauve les 70 à 80 % de playlists où les identifiants du fournisseur sont simplement bâclés.
• Solution manuelle : modifiez votre fichier M3U et changez les valeurs tvg-id pour qu'elles correspondent au fichier XMLTV. C'est fastidieux mais ça marche.
• Solution côté fournisseur : écrivez à votre fournisseur IPTV et dites-lui que ses identifiants M3U et ses identifiants XMLTV ne correspondent pas. Étonnamment souvent, ils régénéreront le fichier — ils reçoivent cette plainte en permanence.

---

Cause 3 : le serveur EPG de votre fournisseur est lent ou limite le débit

Les gros fichiers XMLTV prennent un vrai temps à télécharger. Si le serveur EPG de votre fournisseur est surchargé (très courant aux heures de pointe), votre lecteur peut expirer avant la fin du téléchargement. Certains fournisseurs limitent aussi le débit des téléchargements EPG — si vous avez actualisé le EPG cinq fois dans la dernière heure, la requête suivante pourrait être silencieusement ignorée.

Symptômes

• Le EPG se charge parfois mais pas toujours.
• La première actualisation après l'installation fonctionne, puis les actualisations suivantes reviennent vides.
• Le EPG fonctionne à 3 h du matin mais échoue à 20 h.

Comment corriger

• Augmentez le délai d'expiration du EPG dans votre lecteur. La plupart des lecteurs sont réglés par défaut à 30 secondes. Passez-le à 120.
• Actualisez le EPG moins souvent. Une fois toutes les 12 ou 24 heures suffit largement pour les données de programmes en direct.
• Utilisez la version gzip. Si votre fournisseur expose à la fois epg.xml et epg.xml.gz, utilisez toujours l'URL gzip — elle est généralement 5 à 10× plus petite.
• Si le fournisseur limite le débit, attendez une heure. Actualisez ensuite et n'actualisez plus avant un jour.

---

Cause 4 : votre fichier XMLTV est corrompu

Les exports XMLTV de certains fournisseurs comportent des entrées mal formées — formats de date invalides, caractères UTF-8 cassés, balises non fermées. Un analyseur XML strict refusera de charger le fichier entier à cause d'une seule entrée cassée, vous laissant avec un EPG vide.

Comment le repérer

Si les journaux de votre lecteur (tout lecteur sérieux en a) affichent des erreurs comme « XML parse error at line 47291 » ou « unexpected end of input », vous êtes tombé sur un fichier corrompu.

Comment corriger

Vous avez généralement trois options :

• Utilisez un lecteur plus tolérant. Certains lecteurs (dont Tuneline) sont configurés pour ignorer les entrées mal formées et charger le reste. Les lecteurs stricts abandonnent le fichier entier.
• Utilisez une autre source EPG. De nombreux agrégateurs EPG publics et gratuits republient les données des fournisseurs avec un formatage plus propre. Faites attention aux conditions de licence.
• Signalez le fichier défectueux à votre fournisseur. Ils peuvent généralement le corriger en une journée.

---

Cause 5 : votre lecteur gère tout simplement mal l'affichage des gros EPG

Certains lecteurs prétendent prendre en charge le EPG mais s'étouffent quand la grille dépasse quelques centaines de chaînes. Les données sont là, l'analyse a réussi, mais l'interface soit se fige, soit affiche des cases vides parce qu'afficher des milliers d'entrées de programmes simultanément est trop lent.

Symptômes

• Le défilement du EPG est saccadé.
• Les cases apparaissent et disparaissent au fur et à mesure que vous faites défiler.
• Les 50 premières chaînes affichent des programmes mais tout ce qui est en dessous est vide.

Comment corriger

C'est une limitation du lecteur. Les solutions sont :

• Utilisez un lecteur avec un rendu EPG virtualisé. Les lecteurs modernes n'affichent que les cellules réellement visibles à l'écran : un guide de 5 000 chaînes défile donc aussi vite qu'un guide de 50 chaînes. La grille EPG de Tuneline est virtualisée et testée sur des listes de plus de 10 000 chaînes — un guide volumineux ne devrait jamais être la raison pour laquelle votre expérience de visionnage vous semble lente.
• Filtrez votre liste de chaînes. Si vous ne regardez régulièrement que 30 chaînes, masquez tout le reste. Le EPG s'affiche bien plus vite sur une liste réduite.
• Changez de lecteur. C'est souvent la bonne solution si vous vous battez avec EPG depuis des mois.

---

Un ordre de diagnostic qui fait gagner du temps

Quand on nous demande « pourquoi mon EPG ne se charge pas ? », voici la démarche que nous suivons dans l'ordre :

1. Une URL EPG est-elle configurée ? (Si vous êtes sur M3U.) La plupart des utilisateurs ont sauté cette étape.
2. L'URL fonctionne-t-elle toujours ? Ouvrez-la dans un navigateur : vous devriez voir du XML ou déclencher un téléchargement.
3. Les identifiants de chaîne du M3U correspondent-ils à ceux du XMLTV ? Choisissez une chaîne et vérifiez à la main.
4. Le serveur EPG de votre fournisseur répond-il en ce moment ? Essayez d'actualiser à un autre moment de la journée.
5. Le fichier XMLTV est-il correctement analysé ? Vérifiez les journaux du lecteur à la recherche d'erreurs d'analyse.
6. Votre lecteur peut-il gérer un guide de cette taille ? Essayez avec un sous-ensemble plus petit.

Si vous les passez systématiquement en revue, vous trouverez la cause à chaque fois.

---

À quoi ressemble vraiment un « bon EPG »

Voici le niveau d'exigence que vous devriez attendre de votre lecteur IPTV :

• Premier chargement < 60 secondes pour un guide de 200 Mo en Wi-Fi.
• Actualisation en arrière-plan qui n'interrompt pas la lecture.
• Correspondance approximative des identifiants pour que les listes légèrement décalées se relient quand même.
• Barre En cours / À suivre qui montre ce qui passe en ce moment et ce qui suit, sans ouvrir la grille complète.
• Recherche dans tout le EPG — trouvez « à quelle heure passe le match ? » sans avoir à faire défiler.
• Rappels — prévenez-moi lorsqu'un programme précis est sur le point de commencer.
• Intégration du replay — cliquer sur un programme diffusé il y a 3 heures lance le replay si votre fournisseur le prend en charge.

Si votre lecteur actuel n'assure pas la plupart de ces fonctions, ce n'est pas normal. C'est le signe qu'il est à la traîne par rapport à l'état de l'art.

---

Questions fréquentes

Pourquoi mon EPG affiche-t-il de vieilles émissions datant de plusieurs années ?

Votre fichier XMLTV est périmé. Votre lecteur a téléchargé un guide une seule fois et ne l'a pas actualisé depuis. Forcez une actualisation manuelle, puis vérifiez que l'actualisation automatique est activée selon une fréquence quotidienne.

Pourquoi le EPG fonctionne-t-il pour certaines chaînes et pas pour d'autres ?

C'est presque toujours un problème de correspondance tvg-id (Cause 2). Les chaînes qui ont EPG possèdent des identifiants qui correspondent au fichier XMLTV ; les autres non.

Existe-t-il une source EPG publique et gratuite que je peux utiliser ?

Oui — des projets comme iptv-org/epg maintiennent des exports XMLTV organisés par la communauté pour de nombreux pays. La qualité est variable. Ils sont surtout utiles en complément du EPG de votre fournisseur, et non en remplacement.

Tuneline prend-il mieux en charge le EPG que les lecteurs IPTV plus anciens ?

Nous avons développé la prise en charge du EPG précisément parce que tous les autres lecteurs que nous avons essayés échouaient sur l'une des cinq causes ci-dessus. Tuneline assure la correspondance approximative des identifiants, le rendu virtualisé de la grille, l'actualisation en arrière-plan, la recherche, les rappels et l'intégration du replay lorsqu'elle est prise en charge. Rien de magique là-dedans : c'est simplement ce qu'un guide TV devrait faire en 2026.

À quelle fréquence dois-je actualiser mon EPG ?

Une fois par jour suffit largement pour les données de programmes en direct. La plupart des fournisseurs mettent à jour leur XMLTV une ou deux fois par jour. Actualiser toutes les 15 minutes ne vous donnera pas de données plus récentes : cela ne fera que solliciter votre fournisseur et risque de vous faire limiter le débit.

---

En résumé

Les problèmes de EPG semblent mystérieux, mais ils viennent presque toujours de l'une de ces cinq causes faciles à corriger : URL manquante, identifiants de chaîne mal appariés, fournisseur lent, fichier corrompu ou rendu du lecteur trop faible. Passez-les en revue dans l'ordre et vous réglerez le guide en moins d'une heure.

Si vous en avez assez de vous battre contre les mêmes bizarreries EPG toutes les quelques semaines, essayez Tuneline — correspondance approximative des identifiants, rendu virtualisé et actualisation en arrière-plan sont fournis d'origine. Votre guide devrait tout simplement fonctionner.