L'EPG (Electronic Programme Guide, ou guide électronique des programmes) est le guide TV de vos chaînes en direct : ce qui passe maintenant, ce qui suit et la grille des heures et des jours à venir. En IPTV, ce guide est envoyé par votre service, soit avec les chaînes elles-mêmes, soit dans un fichier séparé au format XMLTV — un fichier texte structuré qui recense les chaînes et leurs programmes, avec des heures de début et de fin précises. Ce guide explique ce qu'est l'EPG, ce que contient un fichier XMLTV, comment le lecteur relie chaque chaîne à ses programmes, et pourquoi un guide est parfois vide ou décalé.
Klyvo Play est un lecteur. Il ne fournit aucune chaîne, aucun film ni aucune série : vous y connectez le service que vous avez déjà et que vous êtes autorisé à utiliser, avec ses identifiants Xtream ou son lien M3U.
Qu'est-ce que l'EPG en IPTV ?
Sur une télévision classique, le guide voyage avec le signal de diffusion. En IPTV, le flux de la chaîne et le guide sont deux choses distinctes. Le flux transporte l'image et le son ; le guide est une donnée qui indique quel programme passe à quelle heure. C'est le lecteur qui les réunit à l'écran : le programme en cours sous chaque chaîne, une grille de ce qui passe, et la liste des programmes passés pour le replay.
D'où une surprise fréquente : une chaîne peut fonctionner parfaitement sans afficher aucun programme. L'image vient d'un endroit, le guide d'un autre, et le service peut tout simplement ne pas fournir de guide pour cette chaîne.
Deux façons pour votre service de fournir le guide
- Via l'API Xtream : le serveur répond, chaîne par chaîne, avec les programmes en cours et à venir (et, pour le replay, les programmes passés). C'est rapide, mais souvent limité à quelques programmes — voir ce qu'est l'API Xtream Codes.
- Via un lien XMLTV : un guide complet pour toutes les chaînes, souvent à une adresse qui se termine par xmltv.php sur le même serveur, ou un lien distinct remis par le service. Il couvre en général plusieurs jours.
Beaucoup de services proposent les deux. Le guide court de l'API assure l'essentiel ; le lien XMLTV apporte une grille plus complète, surtout pour les chaînes que l'API couvre mal.
Qu'est-ce que le XMLTV ? L'intérieur du fichier
Le XMLTV est un format ouvert fondé sur le XML, un langage texte fait de balises. Un fichier de guide comporte deux parties :
- Les chaînes : chacune a un identifiant (l'id), un ou plusieurs noms d'affichage, et parfois une icône. Par exemple, une balise de chaîne avec id="info.exemple" et le nom Info HD.
- Les programmes : chacun désigne sa chaîne par ce même id, avec une heure de début, une heure de fin, un titre, et souvent un résumé, une catégorie et un numéro d'épisode.
Les heures sont écrites sous une forme compacte, avec leur décalage par rapport à l'UTC — par exemple 20261030200000 +0100 signifie le 30 octobre 2026 à 20 h, une heure d'avance sur l'UTC. C'est ce décalage qui permet au lecteur d'afficher la bonne heure locale partout. S'il est faux dans le fichier, tous les programmes de la chaîne apparaissent décalés d'autant — la cause la plus fréquente d'un guide « en retard d'une heure », détaillée dans guide TV IPTV décalé.
Les fichiers XMLTV peuvent être lourds — un guide de milliers de chaînes sur une semaine pèse des dizaines, voire des centaines de mégaoctets — et sont souvent compressés (.xml.gz). C'est une des raisons pour lesquelles un téléphone ou une clé TV ne devrait pas avoir à télécharger et lire tout le fichier lui-même.
Comment les chaînes sont reliées à leurs programmes
Tout repose sur l'identifiant. Dans une playlist M3U, chaque chaîne porte un attribut tvg-id ; via l'API Xtream, chaque chaîne a un identifiant EPG. Le lecteur cherche cet identifiant parmi les chaînes du fichier XMLTV et rattache les programmes correspondants.
- Correspondance exacte : même identifiant des deux côtés — la chaîne reçoit son programme.
- Pas d'identifiant, ou un identifiant différent : la chaîne reste sans programme, même si le guide contient une chaîne au nom proche.
- Plusieurs chaînes pour un même identifiant : les versions HD, SD ou de secours d'une même chaîne peuvent partager le même guide, c'est normal.
Une correspondance par le nom est possible en dernier recours, mais les noms s'écrivent de mille façons (« Info HD », « INFO FHD », « FR: Info »), et l'identifiant reste la méthode fiable.
Guide court ou guide XMLTV complet : lequel vous faut-il ?
Pour zapper, le guide court de l'API Xtream suffit souvent : vous voyez ce qui passe et ce qui suit, ce que la plupart des gens regardent. Un guide XMLTV complet devient utile pour prévoir sa soirée, parcourir le Guide TV d'une catégorie entière ou retrouver un programme déjà diffusé pour le replay. Il aide aussi quand le panneau de votre service envoie des données incomplètes pour certaines chaînes. Si votre service propose un lien XMLTV, l'ajouter ne coûte rien et complète le guide — et comme c'est le serveur Klyvo qui le lit, votre appareil n'est pas ralenti.
Comment Klyvo Play affiche le guide TV
- Sous chaque chaîne en direct : le programme en cours et le suivant, quand votre service fournit un guide pour cette chaîne.
- Dans le Guide TV : ce qui passe en ce moment sur une catégorie, avec la suite.
- Dans Replay : les programmes passés d'une chaîne, quand votre service conserve une archive — voir le replay et le timeshift expliqués.
Les programmes viennent d'abord du panneau de votre service. En complément, un lien EPG XMLTV peut être ajouté à votre playlist — sur le portail client avec les codes de votre appareil, ou par votre revendeur quand il configure la playlist. Le serveur Klyvo lit alors ce guide pour vous, et votre appareil n'a pas à télécharger un fichier énorme : une chaîne trouvée par son identifiant de guide reçoit ce programme, et une chaîne trouvée seulement par son nom le reçoit quand le panneau n'a rien pour elle. Les étapes pratiques sont dans guide TV (EPG) et lien XMLTV.
Klyvo Play n'invente jamais de programme. Quand une chaîne n'affiche aucune information, c'est qu'aucun guide n'a été fourni pour elle.
Pourquoi un guide peut être vide, partiel ou décalé
- Le service n'envoie pas de guide pour cette chaîne — fréquent pour les chaînes peu regardées, les déclinaisons régionales ou les chaînes événementielles.
- Les identifiants ne correspondent pas entre la liste de chaînes et le fichier XMLTV.
- Le guide couvre une période courte : l'API donne quelques programmes, puis plus rien.
- Le décalage horaire du fichier est faux, ce qui décale toutes les heures d'une chaîne.
- Le lien XMLTV a expiré ou changé : les liens de guide contiennent souvent vos identifiants et cessent de fonctionner avec eux.
Chacun de ces cas se règle du côté du guide, par le service ou le revendeur, et non dans le lecteur. La liste complète des vérifications est dans EPG IPTV qui ne s'affiche pas.
Questions fréquentes
L'EPG et le fichier XMLTV, c'est la même chose ? Non. L'EPG est le guide que vous voyez ; le XMLTV est un des formats de fichier qui le transportent. L'API Xtream peut fournir une partie du guide sans aucun fichier XMLTV.
Où trouver mon lien XMLTV ? Demandez-le à votre service : beaucoup en fournissent un, souvent terminé par xmltv.php. On ne peut pas toujours le déduire d'un lien M3U.
Puis-je utiliser n'importe quel lien de guide avec mes chaînes ? Un guide ne fonctionne que si ses identifiants de chaînes correspondent à ceux de votre playlist. Utilisez celui que votre service fournit pour ses chaînes.
Klyvo Play a-t-il besoin du guide pour lire les chaînes ? Non. Les chaînes se lisent sans guide ; le guide ajoute les informations de programme et facilite la navigation dans le replay.
À quelle fréquence le guide est-il mis à jour ? Le service met à jour son guide à son rythme ; Klyvo Play rafraîchit régulièrement ce qu'il affiche pendant que vous regardez.
Profitez pleinement de votre guide TV
L'EPG transforme une liste de chaînes en une télévision que l'on peut prévoir, et le XMLTV est le format qui transporte le guide complet. Si votre service fournit un guide ou un lien XMLTV, Klyvo Play l'affiche sous vos chaînes, dans le Guide TV et dans Replay. Téléchargez Klyvo Play, connectez votre service et essayez l'application complète gratuitement pendant 10 jours.