En bref
- Xtream Codes est une API : l'app parle au serveur du fournisseur et récupère chaînes, guide, films et séries structurés. Quand vous avez le choix, prenez-le.
- M3U est un fichier : une liste de flux, rien d'autre. Ça marche partout, mais le guide vient d'ailleurs et les séries sont à plat.
- Les deux donnent les mêmes flux. Ce qui change, c'est tout ce qu'il y a autour : le guide, les fiches, les saisons, la fraîcheur du catalogue.
Sommaire
Quand vous recevez un abonnement IPTV, le fournisseur vous donne un moyen d'y accéder. Parfois c'est une longue URL en .m3u, parfois trois champs à remplir, adresse, utilisateur, mot de passe, parfois les deux. Ce sont deux portes vers le même contenu, mais elles n'ouvrent pas sur la même expérience. Ce guide explique ce que chacune contient, et ce que ça change une fois dans l'app.
Ce qu'est une playlist M3U
Une M3U est un fichier texte. Chaque chaîne y occupe deux lignes : une ligne de description, avec le nom, le logo, le groupe et parfois un identifiant de guide, puis l'URL du flux. C'est tout. Un fichier de 5 000 chaînes fait quelques mégaoctets, et l'app le télécharge en entier à chaque rafraîchissement.
#EXTINF:-1 tvg-id="france2.fr" tvg-logo="https://…/f2.png" group-title="France",France 2
http://serveur:8080/live/utilisateur/motdepasse/123.ts
Ce format a un mérite : il est universel. Tout lecteur vidéo depuis vingt ans sait le lire. Et une limite : il ne contient que des flux. Pas de guide des programmes, pas de fiche de film, pas de structure de saison. Tout ce qui n'est pas un flux doit venir d'ailleurs, ou être deviné à partir du nom.
Ce qu'est Xtream Codes
Xtream Codes n'est pas un fichier, c'est une API : une façon pour l'app de poser des questions au serveur du fournisseur. « Quelles sont les catégories ? » « Quelles chaînes dans celle-ci ? » « Quel est le programme de cette chaîne ce soir ? » « Quels épisodes dans la saison 2 de cette série ? » Chaque réponse est structurée, et l'app ne demande que ce dont elle a besoin, quand elle en a besoin.
Vous entrez trois informations : l'adresse du serveur, un nom d'utilisateur, un mot de passe. L'app se charge du reste. Le nom vient d'un logiciel de serveur qui a fixé ce format il y a des années ; beaucoup de fournisseurs utilisent aujourd'hui un logiciel compatible, et le nom est resté pour désigner l'API.
Ce que ça change dans l'app
| M3U | Xtream Codes | |
|---|---|---|
| Chaînes en direct | Oui | Oui |
| Guide des programmes | Pas dans IPTV Guard (il faudrait un flux XMLTV à part) | Fourni par le serveur, chaîne par chaîne |
| Films | Une liste à plat, groupée par le nom | Catégories, fiches, durée, année |
| Séries | Des épisodes en vrac, saisons devinées | Saisons et épisodes structurés |
| Infos d'abonnement | Aucune | Expiration, nombre de connexions, état |
| Rafraîchissement | Tout le fichier, à chaque fois | À la demande, par catégorie |
| Changement d'adresse du fournisseur | Nouvelle URL complète | Seule l'adresse du serveur change |
Le guide. C'est la différence que vous verrez en premier. Avec Xtream Codes, le guide vient du même serveur que les chaînes, et il est aligné avec elles. Avec une M3U, le guide devrait venir d'un flux XMLTV séparé, que tous les fournisseurs ne donnent pas et qui doit utiliser les mêmes identifiants de chaînes que la playlist ; IPTV Guard ne lit pas ces flux aujourd'hui, donc une M3U lit ses chaînes sans guide. Le guide sur le guide vide couvre le reste.
Les séries. Avec Xtream Codes, une série est une série : des saisons, des épisodes numérotés, un « épisode suivant » qui a du sens. Avec une M3U, chaque épisode est une entrée comme une autre, et l'app doit reconstituer la structure en lisant les noms, « S02E05 » et ses variantes. Ça marche souvent, pas toujours.
L'abonnement. Xtream Codes indique la date d'expiration et le nombre de connexions autorisées. C'est ce qui permet à un checker de vous dire où vous en êtes, et à une app de vous prévenir avant la fin. Une M3U ne dit rien.
Lequel entrer
Si votre fournisseur donne les deux, entrez Xtream Codes. Les flux sont identiques, et vous gagnez tout le reste. Gardez l'URL M3U comme secours, ou pour un appareil dont le lecteur ne connaît pas Xtream.
Si vous n'avez qu'une URL M3U, regardez-la de près. Beaucoup ressemblent à ceci :
http://serveur:8080/get.php?username=abc&password=xyz&type=m3u_plus&output=ts
Cette forme est la signature d'un serveur Xtream Codes qui génère une M3U à la demande. Les trois informations sont dedans : l'adresse du serveur (http://serveur:8080), l'utilisateur (abc), le mot de passe (xyz). Vous pouvez les entrer directement comme un accès Xtream, et obtenir le guide et les séries que l'URL M3U ne vous donnait pas. Le checker fait cette lecture tout seul : collez l'URL M3U, et s'il y a un serveur Xtream derrière, il affiche l'expiration et le nombre de connexions comme pour un accès Xtream.
Si votre M3U n'a pas cette forme, c'est un fichier réel, hébergé quelque part, sans serveur Xtream derrière. Dans ce cas la M3U est votre seule option, et vous regardez les chaînes sans guide.
Ce qui ne change pas
La vidéo. Dans les deux cas, le flux d'une chaîne est le même fichier, servi par le même serveur, au même débit. Ni le format d'accès ni l'app ne rendent un flux plus fluide que ce que le fournisseur envoie. Si ça saccade, le sujet est ailleurs.
Ce que fait un bon lecteur avec chacun
Avec Xtream Codes, il doit charger le guide en arrière-plan sans bloquer la navigation, mettre en cache ce qu'il a déjà demandé, et compléter les fiches avec une base de données de films pour les affiches et les résumés quand le fournisseur n'en donne pas.
Avec une M3U, il doit reconnaître les épisodes de série derrière les noms, regrouper les films par catégorie, et gérer un fichier de plusieurs mégaoctets sans figer l'interface. Et quand un fournisseur bloque l'API Xtream mais laisse passer la M3U, il doit s'en apercevoir et prendre l'autre chemin sans vous demander de comprendre pourquoi. C'est ce qu'IPTV Guard fait : le format que vous avez ne devrait pas décider de ce que vous voyez.
Dans IPTV Guard
IPTV Guard accepte les deux, et fait le maximum avec chacun. Avec Xtream Codes, l'app obtient guide, fiches et saisons du serveur, et complète avec TMDB pour les affiches et les résumés. Avec une M3U, elle reconstitue films et séries à partir des noms. Et si un fournisseur bloque l'API Xtream tout en laissant passer la M3U, l'app bascule d'elle-même sur ce chemin pour que la playlist charge quand même.
Questions fréquentes
Mon fournisseur me donne les deux. Lequel entrer ?
Xtream Codes. Vous gardez les mêmes chaînes et vous gagnez le guide, les saisons des séries et un catalogue qui se met à jour tout seul. La M3U reste utile comme secours ou pour un lecteur qui ne connaît que ce format.
Je n'ai qu'une URL M3U. Je rate quelque chose ?
Regardez l'URL : si elle contient get.php?username=…&password=…, votre fournisseur a en réalité un serveur Xtream Codes. L'adresse du serveur, l'utilisateur et le mot de passe sont dans l'URL. Vous pouvez l'entrer comme Xtream.
M3U ou M3U8, c'est pareil ?
Pour une playlist, oui : m3u8 signifie simplement que le fichier est en UTF-8. Le format est le même. Par contre, un lien .m3u8 unique est souvent un flux HLS, pas une playlist : c'est une chaîne, pas une liste.
Est-ce que l'un des deux est plus fluide ?
Non. La vidéo passe par les mêmes flux dans les deux cas. La fluidité dépend du fournisseur, du réseau et du lecteur, pas du format d'accès.
Xtream Codes, c'est un fournisseur ?
Non, c'est le nom d'un logiciel de serveur, devenu un standard de fait. Beaucoup de fournisseurs l'utilisent ou utilisent un logiciel compatible. Le nom désigne le format d'accès, pas une société.