Listes M3U et guides XMLTV, expliqués
La plupart des services de TV en direct et des tuners décrivent leurs chaînes avec deux fichiers : une liste M3U (les chaînes) et un guide XMLTV, souvent appelé EPG (ce qui passe). Voici ce que contient chacun, comment ChannelSplice les utilise et comment régler les problèmes courants.
Qu'est-ce qu'une liste M3U
Une liste M3U est un simple fichier texte, qui se termine en général par .m3u ou .m3u8, et qui liste des chaînes. Chaque chaîne a une ligne qui la décrit et une ligne avec l'adresse de son flux :
#EXTM3U url-tvg="https://example.com/guide.xml.gz"
#EXTINF:-1 tvg-id="harbor.news" tvg-logo="https://example.com/harbor.png" group-title="News",Harbor News
https://example.com/live/harbor-news.m3u8
#EXTINF:-1 tvg-id="summit.sports" tvg-chno="12" group-title="Sports",Summit Sports
https://example.com/live/summit-sports.m3u8
ChannelSplice lit ces éléments de chaque chaîne :
- Le nom après la virgule (ou
tvg-name). group-title: le groupe où elle apparaît. Vous choisissez quels groupes chaque écran affiche.tvg-id: l'identifiant de la chaîne dans le guide. C'est ce qui relie une chaîne à ses programmes.tvg-logo: son logo, ettvg-chno: son numéro de chaîne (les sous-chaînes comme la 5.1 gardent le leur).- Les informations de rattrapage, quand le fournisseur garde les derniers jours d'une chaîne (
catchup,catchup-source,catchup-days) : vous pouvez alors revenir en arrière dans le guide et regarder un programme depuis le début.
Qu'est-ce qu'un guide XMLTV (EPG)
Le guide est un fichier séparé au format XMLTV, qui se termine par .xml ou .xml.gz (compressé ; les deux fonctionnent). Il liste les chaînes par identifiant, et chaque programme avec son début et sa fin, son titre, son résumé et souvent son épisode, sa classification et une image. ChannelSplice en fait le guide TV de vos écrans : maintenant et ensuite, la grille horaire, les rappels, la recherche dans ce qui passe et la page Sport.
D'où vient le guide :
- Un accès fournisseur apporte son propre guide. Rien à ajouter.
- Un lien de liste : ajoutez l'adresse du guide à côté sur la page de votre compte. Laissez-la vide et ChannelSplice utilise le guide que la liste indique dans sa première ligne (
url-tvgoux-tvg-url), s'il y en a un. - Un tuner HDHomeRun utilise le guide gratuit de SiliconDust.
Les ajouter à ChannelSplice
- Sur la page de votre compte, choisissez Playlists I add here, puis Add a playlist, Playlist link (M3U).
- Collez l'adresse de la liste, et celle du guide si vous l'avez.
- Cochez les écrans auxquels elle est destinée. Test sur la liste essaie les deux adresses depuis votre navigateur, directement chez votre fournisseur.
Vos adresses sont chiffrées dans votre navigateur avec votre phrase secrète avant d'être enregistrées, donc ChannelSplice ne peut pas les lire. Chaque écran télécharge lui-même la liste et le guide, les garde, et ne les télécharge de nouveau que s'ils ont changé. Étape par étape pour une TV : Fire TV et Android TV.
Pourquoi le guide est vide, et comment le réparer
- Pas d'adresse de guide. La liste n'indique aucun guide et aucun n'a été ajouté : ajoutez l'adresse du guide dans la liste.
- Les identifiants ne correspondent pas. Les chaînes trouvent leurs programmes par leur
tvg-id. Une chaîne sans identifiant, ou avec un identifiant que le guide n'utilise pas, n'a pas de programmes. ChannelSplice compare aussi le nom de la chaîne aux noms du guide, ce qui en complète beaucoup, mais pas toutes. - Le guide est épuisé. « Le guide est épuisé : sa source n'a pas été mise à jour » signifie que le fichier n'a plus de programmes à partir de maintenant. Le fournisseur doit le mettre à jour.
- Un gros guide. Les gros guides prennent un peu plus de temps la première fois. Ensuite, ils sont gardés sur l'écran.
- Un fournisseur qui exige un lecteur précis peut aussi refuser le guide : réglez son User-Agent dans la liste (Only if your provider asks).
ChannelSplice Server, un programme gratuit pour un ordinateur à la maison, va plus loin pour ceux qui ont plusieurs listes ou guides : il fusionne les listes en une programmation, relie les chaînes aux bonnes données de guide, donne à une chaîne au guide vide les programmes de la même chaîne depuis un autre de vos guides, et prévient quand un guide est sur le point de s'épuiser.
Lien de liste ou accès fournisseur ?
Si votre service vous donne une adresse de serveur, un identifiant et un mot de passe, utilisez Provider login : il apporte le guide et les films et séries du fournisseur avec affiches et fiches, et indique quand votre abonnement se termine. Un lien de liste sert pour tout le reste, y compris les listes que vous tenez vous-même. Les deux peuvent figurer dans un seul guide avec ChannelSplice Pro.
Des questions, des idées ou quelque chose de dépassé ? Demandez sur le Discord de ChannelSplice ou sur r/ChannelSplice sur Reddit, ou écrivez à support@channelsplice.com.