Le guide des programmes XMLTV : ce que c’est, comment il s’associe et comment l’importer

5 min de lecture

Un guide des programmes (EPG, d’après le sigle anglais) vous indique ce qui passe en ce moment sur chaque chaîne et ce qui suit. Pour les listes M3U, la façon la plus courante de le distribuer est XMLTV, un format ouvert en XML qui existe depuis de nombreuses années et que comprennent presque tous les lecteurs. Vous verrez ici à quoi il ressemble, comment il se relie à vos chaînes et que faire quand il n’apparaît pas ou affiche des horaires décalés.

À quoi ressemble un fichier XMLTV

Il comporte deux parties : la liste des chaînes et la liste des programmes. Un exemple réduit :

<?xml version="1.0" encoding="UTF-8"?>
<tv>
<channel id="CanalUno.es">
<display-name>Canal Uno</display-name>
<icon src="https://example.com/logos/canal-uno.png"/>
</channel>
<programme start="20261106210000 +0100" stop="20261106220000 +0100" channel="CanalUno.es">
<title>Informativo de la noche</title>
<desc>Resumen de la actualidad del día.</desc>
<category>Noticias</category>
</programme>
</tv>

channel id est l’identifiant de la chaîne. Il n’a pas de format fixe, même si l’on trouve souvent quelque chose comme NombreDelCanal.es.
display-name est son nom lisible ; il peut y en avoir plusieurs.
programme indique la chaîne à laquelle il appartient et les heures de début et de fin, au format AAAAMMDDhhmmss suivi du décalage par rapport au temps universel : +0100 correspond à l’heure de l’Espagne péninsulaire en hiver, et +0200, en été.
À l’intérieur figurent le titre et, s’ils existent, le sous-titre, la description, la catégorie et une image.

Les guides complets peuvent peser des centaines de mégaoctets, c’est pourquoi ils sont souvent publiés compressés, en .xml.gz ou en .zip.

Comment le guide s’associe à vos chaînes

Le guide et la liste sont des fichiers distincts, souvent issus de sources différentes. Pour savoir quels programmes vont avec chaque chaîne, le lecteur cherche des correspondances. Whatplay procède dans cet ordre :

Par le tvg-id de la chaîne dans la M3U (ou l’epgId en W3U), comparé au channel id du guide.
Par le nom, s’il n’y a pas d’identifiant ou s’il ne correspond pas : le nom de la chaîne dans votre liste comparé au display-name du guide.

Inutile qu’ils correspondent lettre pour lettre. Whatplay compare sans tenir compte des majuscules, des accents, des espaces ni des signes ; il retire à la fin les mentions de qualité (HD, FHD, UHD, 4K) et, dans les identifiants, le suffixe du pays, comme .es. Ainsi, « Canal Uno HD » dans votre liste trouve « Canal Uno » dans le guide. Mais « C1 » et « Canal Uno » n’ont rien en commun : c’est à cela que sert le tvg-id.

Une chaîne bien préparée pour le guide ressemble à ceci dans la M3U :

#EXTINF:-1 tvg-id="CanalUno.es" tvg-logo="https://example.com/logos/canal-uno.png",Canal Uno
https://example.com/emision/canal-uno.m3u8

Comment l’importer dans Whatplay

Si votre liste l’indique déjà (dans la M3U, avec url-tvg ou x-tvg-url dans la ligne #EXTM3U ; en W3U, avec epg), le Guide vous le signale avec le message « La liste « … » inclut son guide des programmes » et un bouton pour l’importer.
Sinon, allez dans le Guide et appuyez sur « Importer un guide ». Collez l’adresse d’un guide XMLTV (.xml, .xml.gz ou .zip) ou appuyez sur « Depuis un fichier » pour en choisir un sur l’appareil.

Le guide se télécharge en arrière-plan et s’affiche au fur et à mesure. Dans « Guides importés », vous verrez combien de chaînes et de programmes il contient, et vous pourrez le retirer. Le Guide propose deux vues : « Maintenant », avec ce qui passe en ce moment sur chaque chaîne, et « Grille », avec la journée entière et un sélecteur de jours. Dans le lecteur, sous le nom de la chaîne, apparaissent « En ce moment » et « À suivre ». Whatplay met à jour les guides de temps en temps et, s’ils n’ont pas changé, ne les télécharge pas de nouveau. L’aide le résume dans Comment ajouter le guide des programmes ?

Problèmes courants

« Aucune chaîne de vos listes ne figure dans les guides importés »

Le guide a bien été importé, mais aucun identifiant ni aucun nom ne correspond. Ouvrez le guide dans un éditeur de texte, cherchez comment votre chaîne y est nommée dans ses channel id et reportez cette valeur dans le tvg-id de votre liste. Vérifiez aussi que le guide concerne le même pays ou la même région que vos chaînes.

Les programmes sont décalés d’une heure

En général, le guide déclare mal son fuseau horaire : des heures locales marquées +0000, ou un décalage qui ne change pas avec l’heure d’été. Whatplay respecte ce qu’indique chaque programme et le convertit à votre heure : si le guide est faux, c’est le guide qu’il faut corriger.

« Ce n’est pas un guide XMLTV ou il ne contient aucun programme pour ces jours-ci »

Soit l’adresse ne mène pas à un XMLTV (elle ouvre par exemple une page web), soit le guide est périmé et ne contient que des programmes passés. Les guides sont régénérés souvent : une copie ancienne devient vite inutilisable.

Vous avez collé le guide dans « Ajouter une liste »

Whatplay le détecte, vous indique qu’il s’agit d’un guide des programmes et non d’une liste, et vous montre où l’importer avec la même adresse.

Le chargement est très long

Les gros guides sont longs à télécharger et à lire. Utilisez la version compressée si elle existe et, si la source le permet, un guide limité aux chaînes que vous utilisez.

Le guide se trouve sur votre réseau domestique

Depuis Android 17, pour télécharger un guide depuis un ordinateur ou un NAS de votre réseau, Whatplay a besoin de l’autorisation « Appareils à proximité ». L’appli vous la demande par un message.

Créer votre propre guide

Si vous diffusez votre propre contenu à heures fixes, comme la radio d’une association ou la chaîne d’un établissement scolaire, vous pouvez écrire un XMLTV à la main : il suffit d’un channel et de ses programme, avec le bon fuseau horaire et un fichier en UTF-8. Pour le relier à votre chaîne, utilisez le même identifiant dans le tvg-id de votre liste M3U ou dans l’epgId de votre W3U ; les deux formats sont expliqués dans M3U, M3U8 et W3U.