EPG IPTV : comment fonctionne le guide TV

Ce qu’est l’EPG

L’EPG est un fichier qui liste des chaînes et, pour chacune, les programmes à venir avec leur heure de début et de fin, leur titre et souvent un résumé. Presque tous les fournisseurs IPTV utilisent le même format, XMLTV. Un tout petit fichier ressemble à ceci :

<tv>
  <channel id="news.example">
    <display-name>Example News</display-name>
  </channel>
  <programme start="20260916180000 +0200" stop="20260916183000 +0200" channel="news.example">
    <title>Evening Bulletin</title>
    <desc>The day's headlines.</desc>
  </programme>
</tv>

Chaque channel porte un identifiant, et chaque programme nomme la chaîne à laquelle il appartient. Les horaires indiquent leur décalage par rapport à l’heure UTC, ici +0200, pour que le lecteur les affiche dans votre fuseau horaire. Le vrai guide d’un fournisseur couvre des milliers de chaînes sur plusieurs jours et pèse de nombreux mégaoctets.

Le lecteur transforme ce fichier en grille : les chaînes sur le côté, les heures en haut, et une ligne qui marque l’heure actuelle.

D’où vient le lien EPG

Avec un accès Xtream Codes, le serveur publie le guide à une adresse fixe, construite à partir de vos identifiants, et le lecteur le récupère sans rien vous demander. Dans ZiroTV, laissez le champ du lien EPG vide. Ne le remplissez que si votre fournisseur vous a donné un autre lien de guide : un lien saisi remplace le guide de l’accès.

Avec un lien M3U, la playlist ne contient aucune grille horaire : le guide a besoin de son propre lien. Les fournisseurs l’indiquent en général à côté du lien M3U, dans votre espace client ou dans l’e-mail de bienvenue, parfois sous le nom de lien XMLTV. Il se termine souvent par .xml ou contient xmltv.php. Ce que contient la playlist elle-même, le guide du fichier M3U le détaille.

Utilisez le guide de votre fournisseur. Ses identifiants de chaînes sont écrits pour sa propre playlist, et c’est ce qui place les programmes sur les bonnes chaînes. Xtream Codes ou M3U compare les deux types d’accès plus en détail.

Comment le guide retrouve vos chaînes

Le lecteur doit décider quelle grille va avec quelle chaîne. ZiroTV procède en trois passes :

1. Par identifiant. Une chaîne dont le tvg-id figure dans le guide reçoit cette grille.
2. Par nom. Une chaîne sans identifiant correspondant est cherchée par son nom parmi les noms de chaînes du guide.
3. Par un nom proche. Ce qui reste sans correspondance est comparé une dernière fois, sans les mentions comme HD ou FHD, sans les préfixes de pays et sans le texte entre crochets ou entre parenthèses. Seule une correspondance très proche est retenue, pour ne pas mettre des programmes sur la mauvaise chaîne.

Une chaîne qui ne correspond à rien affiche son nom sans programmes. C’est normal pour quelques chaînes dans la plupart des playlists : toutes les chaînes d’un fournisseur ne figurent pas dans son guide.

Ajouter un lien EPG dans ZiroTV

Avec un accès Xtream Codes, il n’y a rien à faire : le guide arrive avec l’accès. Avec un lien M3U, collez le lien EPG dans le champ du guide TV quand vous ajoutez la playlist, avant de lancer l’ajout et la synchronisation. Pour ajouter ou changer le lien d’une playlist que vous avez déjà :

1. Ouvrez les réglages.
2. Choisissez le bouton de modification, le crayon, à côté de la playlist.
3. Collez le lien dans le champ du guide TV, à la place de l’ancien.
4. Enregistrez : ZiroTV synchronise aussitôt la playlist et charge le nouveau guide.

Sur une TV, quand vous ajoutez une nouvelle playlist, vous pouvez la saisir depuis votre téléphone : un long lien EPG se colle alors sur le téléphone au lieu de se taper à la télécommande.

Comment le guide reste à jour

ZiroTV affiche vos chaînes dès qu’elles sont chargées et récupère le guide juste après : la grille se remplit un instant plus tard. Il garde le guide 30 minutes, puis le télécharge de nouveau à la vérification suivante : toutes les 15 minutes tant que l’application est ouverte, quand vous revenez dans l’application et quand vous arrêtez de regarder. Il ne lance jamais de téléchargement pendant la lecture d’une chaîne, pour laisser toute la connexion à l’image. Inutile de mettre le guide à jour à la main.

Le guide de ZiroTV va de quelques heures en arrière jusqu’aussi loin que votre fournisseur publie, souvent plusieurs jours. Avec un accès Xtream Codes, les programmes déjà diffusés se retrouvent dans la liste du replay, qui les demande directement au fournisseur. Avec une playlist M3U qui porte des balises de replay, cette liste montre ce que votre guide contient encore. Le replay IPTV expliqué.

EPG non disponible : pourquoi le guide TV reste vide

« EPG non disponible » veut dire que le lecteur n’a aucun programme à afficher pour une chaîne, ou pour toutes : le lien du guide manque, ne répond pas, ou ses chaînes ne correspondent pas aux vôtres. Vérifiez les points suivants dans l’ordre. Les trois premiers règlent la plupart des guides vides.

Il n’y a pas de lien EPG

Une playlist M3U sans lien EPG n’a pas de guide du tout. Demandez le lien à votre fournisseur et ajoutez-le comme indiqué plus haut.

Le lien est faux ou a expiré

Un lien de guide contient souvent votre nom d’utilisateur et votre mot de passe : il cesse de fonctionner quand ils changent ou quand l’abonnement prend fin. Copiez-le de nouveau depuis votre fournisseur, et vérifiez qu’il n’a ni espace ni caractère manquant.

Le guide a besoin d’un moment

Après une synchronisation, un gros guide met un moment à se télécharger et à s’associer à vos chaînes. Attendez une minute avant de changer quoi que ce soit, et laissez l’application ouverte pendant le chargement.

Le lien mène à un fichier compressé

Certains liens de guide se terminent par .gz : c’est une copie compressée du fichier. ZiroTV lit le fichier XMLTV tel quel. Demandez à votre fournisseur la version non compressée, en général la même adresse sans .gz.

Le guide est très volumineux

ZiroTV lit le guide en entier, quelle que soit sa taille, et accorde deux minutes au téléchargement. Un guide qui liste de nombreux jours pour un très grand nombre de chaînes, envoyé par un serveur lent, peut manquer de temps et laisser des chaînes vides. Si votre fournisseur propose un guide sur moins de jours ou moins de chaînes, prenez celui-là.

Les identifiants et les noms ne correspondent pas

Un guide qui ne vient pas de votre fournisseur, ou qui est prévu pour une autre région du même service, utilise des identifiants et des noms que votre playlist n’a pas. Utilisez le lien de guide qui va avec votre playlist.

Le serveur du guide est en panne

Cela arrive, et le guide revient de lui-même dès que le serveur répond de nouveau. ZiroTV réessaie à son rythme habituel.

Pourquoi les horaires du guide sont faux

Si tous les programmes sont décalés de la même durée, en général une heure ou plus, le fuseau horaire de l’appareil est la cause probable. Sur une Fire TV, vérifiez le fuseau horaire dans les préférences des paramètres. Sur Google TV et Android TV, vérifiez la date et l’heure dans les paramètres système. Si l’horloge est juste, le guide omet peut-être le décalage par rapport à l’heure UTC : ZiroTV lit alors ses horaires comme de l’heure UTC, et seul votre fournisseur peut corriger le fichier.

Si seuls certains programmes sont faux, la grille du fournisseur pour ces chaînes n’est pas à jour. Le guide ne peut pas être meilleur que le fichier dont il vient. Le reste de ce que fait le lecteur se trouve dans les fonctionnalités de ZiroTV.