Guide
Comment trouver et ajouter un guide TV (EPG) à votre IPTV
L’EPG, le guide électronique des programmes, est ce qui affiche « en ce moment » et « à suivre » à côté de chaque chaîne. C’est un fichier XMLTV, à une adresse bien à lui. Voici à quoi ressemble cette adresse, où la trouver, comment l’ajouter dans Aina, et quoi vérifier quand le guide n’affiche rien.
Mis à jour le · L’équipe Aina IPTV
D’où vient votre lien EPG ?
- Des identifiants Xtream Codes en contiennent un, sur le même serveur, avec le même nom d’utilisateur et le même mot de passe :
http://serveur:port/xmltv.php?username=…&password=…. C’est le lienget.phpavecxmltv.phpà la place. Aina le récupère tout seul : rien à saisir. - Une liste M3U indique souvent le sien, dès sa première ligne :
#EXTM3U x-tvg-url="https://…/guide.xml.gz"(ouurl-tvg). Certaines en donnent plusieurs, séparés par des virgules, un par pays ; Aina les charge tous sans qu’on le lui demande. - Sinon, votre fournisseur vous en envoie un : un lien qui se termine par
.xml, ou par.xml.gzquand il est compressé. Les deux fonctionnent. - Un portail MAC apporte son propre guide, qu’Aina lit comme le ferait un boîtier. Un portail qui n’en publie pas peut recevoir un lien de guide dans Réglages, puis Sources du guide TV.
Que contient un fichier XMLTV ?
XMLTV est le format qu’utilisent presque tous les guides IPTV : un simple fichier texte, souvent compressé en gzip, avec la liste des chaînes puis leurs programmes. Voici les éléments qui comptent :
| Élément | Ce qu’il contient |
|---|---|
<channel id="…"> | Une chaîne et l’identifiant sous lequel ses programmes sont rangés, par exemple chaine-exemple.fr. La liste des chaînes du guide, ce sont tous ces éléments. |
<display-name> | Le nom de la chaîne, parfois en plusieurs langues. |
<programme start="…" stop="…" channel="…"> | Un programme : son début et sa fin avec leur fuseau horaire, et l’identifiant de la chaîne à laquelle il appartient. |
<title>, <desc>, <category> | Le titre du programme, son résumé et son genre. |
Une semaine de guide pour un gros abonnement peut peser des centaines de mégaoctets, c’est pourquoi les fournisseurs le compressent. Aina écrit le fichier dans le stockage à mesure qu’il le télécharge et le lit morceau par morceau : même un guide de cette taille ne sature pas la mémoire d’un téléphone ou d’une clé TV.
Si votre fournisseur n’a pas de guide
- Demandez-le d’abord. Un guide fait pour votre abonnement correspond le mieux à ses chaînes, et la plupart des fournisseurs en ont un, même quand ils n’en parlent pas.
- Regardez dans la liste. Ouvrez-la dans un éditeur de texte et cherchez
x-tvg-urlsur sa première ligne. - Fabriquez-en un. iptv-org/epg est un projet ouvert sur GitHub qui construit un fichier XMLTV à partir des programmes que publient les sites de télévision, pour les chaînes que vous choisissez. C’est un outil à faire tourner vous-même sur un ordinateur, pas un lien tout prêt, et le fichier qu’il produit doit se trouver à une adresse que vos appareils peuvent atteindre.
Vérifiez un lien de guide avant de l’ajouter
Ouvrez-le dans le navigateur d’un ordinateur. Un lien .xml qui fonctionne affiche un texte qui commence par <?xml ou <tv ; un lien .xml.gz télécharge un fichier. Une page de connexion, une erreur ou une page vide veulent dire que le lien est faux ou qu’il a expiré : demandez-en un nouveau à votre fournisseur. Un lien xmltv.php de Xtream Codes qui revient vide signifie en général que le fournisseur ne publie aucun guide pour cet abonnement.
Ajouter un lien EPG à une liste M3U
Les boutons sont cités ici tels qu’ils s’affichent dans l’application en français.
- 1
Commencez à ajouter la liste
Dans Aina, choisissez Liste M3U sur l’écran Ajoutez votre abonnement, ou allez dans Réglages, puis Abonnements, puis Ajouter un abonnement.
- 2
Collez le lien de la liste
Dans Lien de la liste, comme d’habitude.
- 3
Collez le lien du guide
Dans Lien du guide (facultatif) : le lien
.xmlou.xml.gz. Laissez-le vide si la liste indique déjà son guide. - 4
Connectez-vous
Appuyez sur Se connecter. Les chaînes arrivent d’abord, le guide ensuite. Un gros guide peut prendre une minute.
Ajouter un autre guide plus tard
Réglages, puis Sources du guide TV, vaut pour tous les abonnements, Xtream Codes et portails MAC compris. Ajoutez un guide par son adresse XMLTV pour compléter les chaînes que le guide de votre fournisseur oublie, donnez à chaque guide son propre décalage, et désactivez celui que vous voulez. Mettre à jour le guide applique un changement tout de suite.
Comment le guide retrouve vos chaînes
Une liste M3U donne à chaque chaîne l’identifiant qu’elle doit porter dans le guide, tvg-id="chaine-exemple.fr", et le guide range ses programmes sous <channel id="chaine-exemple.fr">. Aina fait correspondre les deux. Quand une chaîne n’a pas d’identifiant, ou que le guide en utilise un autre, Aina essaie le nom de la chaîne : un guide venu d’une autre source peut ainsi remplir une bonne partie de votre abonnement.
Guide TV vide ou faux : les causes
- Le guide ne couvre pas ces chaînes. Un guide est publié pour un ensemble de chaînes : demandez à votre fournisseur celui qui est fait pour votre abonnement.
- Les identifiants et les noms ne correspondent pas. Les chaînes que le guide appelle autrement restent vides. Le guide de votre propre fournisseur est celui qui correspond le mieux.
- Le guide est arrivé à sa fin. Un guide couvre quelques jours à l’avance. Si le fournisseur cesse de le mettre à jour, les programmes s’arrêtent là où le fichier s’arrête.
- Il est encore en train de charger. Aina remplit les programmes une fois le fichier arrivé en entier, ce qui peut prendre une minute ou deux pour un gros guide.
- Les horaires sont décalés. Un guide indique le fuseau horaire de chaque programme, et Aina affiche les heures dans le vôtre : à Montréal comme à Casablanca, une chaîne d’un autre pays s’affiche à votre heure. Si tous les programmes sont décalés du même nombre d’heures, c’est le guide du fournisseur qui est mal étiqueté : dans Réglages, puis Sources du guide TV, décalez-le plus tard ou plus tôt, à l’heure ou à la demi-heure, jusqu’à ce qu’il tombe juste.
Ce que vous obtenez une fois le guide chargé
En ce moment et à suivre sous chaque chaîne ; le guide TV de ce qui passe maintenant et ce soir, avec une recherche par programme ; une semaine par chaîne ; et le replay là où votre fournisseur garde une archive.
Questions et réponses
Avec des identifiants Xtream Codes, c’est le xmltv.php de votre serveur, avec votre nom d’utilisateur et votre mot de passe, et Aina s’en sert tout seul. Avec une liste M3U, cherchez x-tvg-url sur sa première ligne, ou demandez à votre fournisseur son lien de guide .xml ou .xml.gz.
Le format de fichier que presque tous les fournisseurs IPTV utilisent pour leur guide : une liste de chaînes, chacune avec son identifiant, et de programmes avec leur chaîne, leurs heures de début et de fin, leurs titres et leurs descriptions.
Seulement parce qu’il est compressé, ce qui le rend bien plus léger à télécharger. Aina lit les deux.
Oui, tout lien XMLTV fonctionne dans Aina. Un guide venu d’une autre source ne remplit que les chaînes dont l’identifiant ou le nom correspond : commencez donc par le guide de votre fournisseur, et ajoutez un guide gratuit à côté, dans Sources du guide TV, pour combler les trous.
Non. Le guide vient tout seul du panel de votre fournisseur. Vous pouvez quand même ajouter vos propres guides dans Réglages, puis Sources du guide TV, pour les chaînes qu’il ne couvre pas.