La réponse courte
Une playlist M3U est une liste unique de chaînes (et parfois de films et séries), fournie sous forme de lien ou de fichier. Un code Xtream (identifiants Xtream Codes) se compose d’une adresse de serveur, d’un nom d’utilisateur et d’un mot de passe : l’application se connecte au serveur de votre fournisseur et lui demande la TV en direct, les films, les séries, le guide TV et, quand c’est proposé, le replay.
Vous n’avez pas vraiment à choisir : c’est votre fournisseur qui décide de ce qu’il vous remet, et beaucoup donnent les deux. Si vous avez le choix, Xtream est souvent plus pratique dans un lecteur, et M3U plus universel. Dans tous les cas, aucun contenu n’est fourni avec le lecteur : utilisez un fournisseur que vous avez le droit d’utiliser.
Qu’est-ce qu’une playlist M3U ?
Le M3U est un simple fichier texte. C’est soit une URL qui se termine par .m3u ou .m3u8 (ou qui comporte des paramètres), soit un fichier à télécharger. Chaque chaîne tient sur une ligne d’informations suivie de l’adresse du flux :
#EXTM3U
#EXTINF:-1 tvg-id="chaine1.example" tvg-logo="http://provider.example/logo1.png" group-title="Infos",Chaîne Un
http://provider.example/live/chaine1
- #EXTINF introduit une chaîne et son nom affiché.
- tvg-id relie la chaîne à sa fiche dans le guide TV.
- tvg-logo est l’image du logo.
- group-title est la catégorie dans laquelle la chaîne apparaît.
La playlist ne contient que les flux. Le guide TV se trouve normalement dans un fichier XMLTV séparé, avec son propre lien. Le lecteur doit télécharger les deux, puis les associer grâce aux valeurs tvg-id. C’est pourquoi le guide est parfois vide avec une playlist M3U ; voir guide TV EPG et replay IPTV.
Que sont des identifiants Xtream Codes ?
Xtream Codes est une interface utilisée par de nombreux fournisseurs IPTV. On vous remet trois informations : une adresse de serveur (avec un port), un nom d’utilisateur et un mot de passe. Le lecteur s’en sert pour interroger l’API du fournisseur, qui renvoie :
- les chaînes en direct et leurs catégories ;
- les films et les séries, listés séparément, avec saisons et épisodes ;
- le guide TV de chaque chaîne ;
- le replay ou timeshift sur les chaînes dont le fournisseur conserve une archive.
Comme l’application demande chaque rubrique séparément, les grandes bibliothèques sont généralement mieux organisées et s’actualisent plus vite qu’avec un énorme fichier. Le fonctionnement de chaque élément dépend toujours du service de votre fournisseur.
M3U ou Xtream Codes : comparatif
| Playlist M3U | Identifiants Xtream Codes | |
|---|---|---|
| Ce que vous saisissez | Un lien, ou un fichier | Adresse du serveur, identifiant, mot de passe |
| TV en direct | Oui | Oui |
| Films et séries | Mélangés dans la liste, classés par catégorie | Rubriques séparées avec saisons et épisodes |
| Guide TV | Demande un lien XMLTV séparé et des tvg-id concordants | Fourni par l’API |
| Replay | Seulement si le fournisseur ajoute des informations d’archive à la liste | Si le fournisseur propose le timeshift |
| Compatibilité | Très large : la plupart des lecteurs et de nombreuses TV | Demande un lecteur compatible Xtream |
| Saisie sur une TV | Un long lien | Trois champs courts |
| Identifiants | Le plus souvent dans le lien | Champs séparés |
Aucun format n’offre une meilleure qualité : l’image vient du flux du fournisseur dans les deux cas.
Comment savoir ce que votre fournisseur vous a donné
- Un lien ou un fichier qui mentionne m3u, m3u_plus ou m3u8 : une playlist M3U.
- Une adresse de serveur, un identifiant et un mot de passe, parfois appelés « code Xtream », « Xtream API » ou « identifiants de connexion » : un accès Xtream.
- Un lien du type
http://provider.example:8080/get.php?username=...&password=...&type=m3u_pluscontient un accès Xtream dans un lien M3U. Vous pouvez l’ajouter comme M3U, ou saisir séparément les trois valeurs. - Un lien distinct vers un fichier de guide (XMLTV, souvent en
.xmlou.xml.gz) : c’est le guide TV, pas une playlist.
Si vous n’avez qu’un lien M3U, demandez à votre fournisseur s’il propose aussi des identifiants Xtream, et inversement.
Les ajouter dans HHPlayer
HHPlayer accepte les deux. Installez-le depuis la page des plateformes, puis ajoutez une playlist dans l’application :
- Pour du M3U : saisissez le lien de la playlist.
- Pour du Xtream : saisissez l’adresse du serveur, l’identifiant et le mot de passe exactement comme votre fournisseur les a écrits.
- Patientez pendant le chargement des chaînes. HHPlayer actualise automatiquement vos playlists et en garde plusieurs côte à côte.
Si rien ne se charge, vérifiez le lien ou les trois valeurs (faute de frappe), votre connexion, puis utilisez Réessayer sur l’écran d’accueil. La page d’aide liste les vérifications habituelles. Vous pouvez aussi tester le lecteur sans fournisseur : ajoutez la playlist de démo publique https://hhplayer.app/demo.m3u (voir la page de démo).
Le guide et le replay apparaissent quand votre fournisseur fournit les données ; la page des fonctionnalités détaille ce que fait HHPlayer. Pour choisir un lecteur selon votre appareil, commencez par le guide Android TV, ou lisez HHPlayer ou IPTV Smarters.
Conseils de sécurité
- Un lien M3U vaut un mot de passe. Beaucoup contiennent votre identifiant et votre mot de passe. Quiconque possède le lien peut utiliser votre abonnement : ne le publiez ni sur un forum, ni dans une capture d’écran, ni dans un message d’aide.
- Ne partagez pas vos identifiants. Les fournisseurs limitent souvent le nombre de connexions simultanées, et le partage peut faire bloquer le compte.
- Choisissez un fournisseur sérieux. Vous êtes responsable de l’usage de playlists et de contenus auxquels vous avez le droit d’accéder.
- Cachez vos identifiants quand vous demandez de l’aide. Décrivez le problème sans montrer les accès.
- Changez le mot de passe auprès de votre fournisseur si vous pensez qu’un lien a fuité.
Questions fréquentes
Quelle est la différence entre M3U et Xtream Codes ?
Le M3U est un lien ou un fichier de playlist qui liste des flux. Xtream Codes, c’est une adresse de serveur, un identifiant et un mot de passe qui permettent à l’application de demander séparément TV en direct, films, séries, guide et replay.
Xtream Codes est-il meilleur que M3U ?
Pas pour la qualité d’image, qui dépend du fournisseur. Xtream est souvent plus pratique, avec des rubriques séparées et un guide via l’API, tandis que le M3U fonctionne dans plus de lecteurs.
Où trouver mon lien M3U ou mon code Xtream ?
C’est votre fournisseur qui les donne, en général dans votre espace client ou un message de bienvenue. Un lien avec get.php et des paramètres username/password contient à la fois les identifiants et une playlist M3U.
Puis-je utiliser un lien M3U et des identifiants Xtream dans HHPlayer ?
Oui, HHPlayer accepte les playlists M3U et les identifiants Xtream, et vous pouvez garder plusieurs playlists. Vous pouvez aussi le tester avec la playlist de démo https://hhplayer.app/demo.m3u.
Peut-on partager son lien M3U sans risque ?
Non. Beaucoup de liens M3U contiennent votre identifiant et votre mot de passe : quiconque les a peut utiliser votre abonnement. Gardez-les privés, y compris dans les captures d’écran et les demandes d’aide.