XMLTV : le format des données EPG expliqué, du tvg-id au dépannage

XMLTV est le format standard des données de programmes TV : un fichier XML qui décrit, chaîne par chaîne, ce qui passe, quand, avec titre et résumé. C’est lui qui alimente le guide des programmes (EPG) de votre application IPTV — la matière première, quand l’EPG est le résultat affiché à l’écran.

Le nom vient d’un projet open source né à la fin des années 1990 pour collecter les grilles TV ; le format a survécu à tout parce qu’il est simple, ouvert et lisible par n’importe quel logiciel — la même recette qui a fait le succès de la liste M3U côté playlists. En IPTV, votre service génère ce fichier et vous en remet l’URL — souvent une adresse en xmltv.php, à côté des identifiants Xtream Codes — que votre application télécharge et croise avec vos chaînes. Il ne décrit que le direct : les fiches de la VOD sont un autre jeu de métadonnées, géré à part. C’est la brique la plus technique du hub Technologies, et celle qui explique le plus de pannes de guide.

Un fichier XMLTV se lit en deux temps : d’abord la liste des chaînes, chacune avec son identifiant ; puis la liste des émissions, chacune rattachée à un identifiant de chaîne. Votre application télécharge le fichier, le croise avec votre playlist, et construit la grille — quatre éléments à connaître :

Les deux mots s’échangent souvent, et la nuance aide pourtant à dépanner : l’EPG est ce que vous voyez — la grille navigable —, XMLTV est ce qui circule — le fichier de données. Quand « l’EPG est vide », la panne est presque toujours côté XMLTV : URL absente, fichier lacunaire ou correspondance ratée.

Les deux fichiers se partagent le travail : la liste M3U transporte les flux — où trouver chaque chaîne —, le fichier XMLTV transporte les programmes — ce qui y passe. Cette séparation n’est pas un défaut de conception : les deux données n’ont ni le même rythme (une playlist change rarement, une grille change chaque jour), ni le même poids, ni la même source. D’où les deux URL distinctes que remet votre service, à côté des identifiants Xtream Codes — et pourquoi même VLC, qui lit n’importe quelle playlist, reste sans grille : il ne parle pas XMLTV.

C’est aussi ce qui explique le réglage oublié le plus fréquent de l’IPTV : une M3U branchée sans son URL XMLTV donne des chaînes qui fonctionnent… et une grille désespérément vide. Les deux URL se saisissent au même endroit, dans les réglages de playlist de votre lecteur — la marche à suivre est dans nos guides Smarters et TiviMate, et sur le portail web pour IBO Player — comme pour tout lecteur du hub Applications.

En connexion Xtream Codes, vous n’avez généralement pas besoin d’URL XMLTV : l’API livre les programmes par la même connexion que les chaînes, déjà associés aux bons canaux. Le fichier XMLTV reste le chemin des configurations M3U — et une roue de secours si le guide intégré d’un service se révèle lacunaire. L’API livre d’ailleurs tout par la même connexion : chaînes, VOD, grilles et catch-up :

Le fichier XMLTV et votre playlist sont deux documents indépendants — il faut bien les relier. C’est le rôle du tvg-id : chaque chaîne de la M3U porte cet attribut, et l’application cherche dans le fichier XMLTV le canal dont l’identifiant correspond exactement. Correspondance trouvée : la chaîne a son programme. Au moindre écart — une majuscule, un suffixe, un point — la chaîne fonctionne mais reste muette dans la grille EPG. En connexion Xtream Codes, cette correspondance est faite côté serveur — le problème disparaît.

Pourquoi les chaînes ne correspondent-elles pas toujours ? Parce qu’il n’existe aucun registre universel des identifiants : chaque source nomme ses canaux à sa façon. C’est la raison de fond pour laquelle brancher une source XMLTV publique sur la playlist d’un service échoue presque toujours — et pourquoi la seule combinaison fiable est la M3U et le XMLTV du même fournisseur, générés depuis la même base. Un critère de sérieux de plus, dans la droite ligne du guide du meilleur abonnement IPTV.

Comme pour la playlist M3U, deux formes existent — et le choix est encore plus tranché : une grille EPG se périme en heures, pas en semaines. En connexion Xtream Codes, la question ne se pose pas — rien à gérer ; en M3U, l’URL, que l’application recharge d’elle-même, est la seule forme qui suit le rythme :

Pourquoi l’EPG reste-t-il vide ? Toujours l’une de ces trois familles : la source n’arrive pas (URL absente, expirée, jamais rechargée), la correspondance échoue (identifiants divergents), ou le contenu manque côté service (chaînes non couvertes). Et n’oubliez pas la solution radicale : passer la playlist en connexion Xtream Codes quand le service la propose — le guide arrive aligné, et le catch-up avec. Le tableau trie les symptômes :

XMLTV est la plomberie du guide des programmes : un fichier que vous ne verrez jamais, mais dont dépendent la grille, le zapping par programme et le catch-up. Retenez les trois règles : l’URL plutôt que le fichier, la source du même service que la playlist (le tvg-id ne pardonne pas), et le fuseau horaire de l’appareil avant tout autre réglage. En connexion Xtream Codes, tout cela devient transparent ; en M3U, c’est le réglage qui change tout. Les autres briques — de l’EPG à la VOD — vous attendent dans le hub Technologies.

La suite du parcours ne change pas : un service choisi avec la méthode des guides d’achat, validé par un essai gratuit — URL XMLTV comprise —, puis une formule à votre mesure — mensuelle ou annuelle, aux fourchettes du guide des prix — sur la page tarifs, les flux se vérifiant toujours en trente secondes dans VLC. Et pour brancher cette URL au bon endroit sur chaque écran — Smart TV, Fire TV Stick ou Android TV —, les guides du hub Appareils prennent le relais.