Xtream Codes et Liste M3U : le guide complet
Quand vous activez un abonnement IPTV, vous recevez soit des Xtream Codes, soit un lien M3U, parfois les deux. Ces deux formats donnent accès exactement au même contenu, mais ils ne fonctionnent pas de la même manière et n'offrent pas le même confort d'utilisation.
Ce guide fait partie de notre pilier Installation IPTV. Il explique ce que chaque format fait réellement, lequel choisir selon votre application, comment passer de l'un à l'autre, et comment corriger les erreurs les plus fréquentes. Si vous débutez complètement, commencez plutôt par notre guide IPTV pour débutants.
Qu'est-ce qu'un lien M3U ?
Le M3U est un format de playlist qui existe depuis les débuts du MP3. Dans le contexte de l'IPTV, un fichier M3U est un document texte qui liste, une par une, toutes les chaînes de votre abonnement avec l'adresse de leur flux vidéo. Quand votre fournisseur vous envoie un « lien M3U », il vous donne en réalité une adresse web qui génère ce fichier à la volée, à jour au moment où vous l'ouvrez.
Chaque entrée du fichier suit une structure simple. Une ligne #EXTINF décrit la chaîne — son nom, son logo, sa catégorie — puis la ligne suivante contient l'URL du flux. Multipliez cela par 36 000 chaînes et vous obtenez un fichier de plusieurs mégaoctets que votre lecteur doit télécharger et analyser entièrement avant d'afficher quoi que ce soit.
#EXTM3U
#EXTINF:-1 tvg-id="TF1.fr" tvg-logo="https://.../tf1.png" group-title="TNT",TF1 FHD
http://serveur.com:8080/live/utilisateur/motdepasse/12345.ts
#EXTINF:-1 tvg-id="M6.fr" tvg-logo="https://.../m6.png" group-title="TNT",M6 FHD
http://serveur.com:8080/live/utilisateur/motdepasse/12346.tsC'est cette simplicité qui fait sa force et sa faiblesse : n'importe quel lecteur vidéo sait ouvrir un M3U, y compris VLC sur PC et Mac, mais aucune information de programmation n'est incluse et la moindre modification du bouquet impose un rechargement complet.
Qu'est-ce que Xtream Codes ?
Xtream Codes n'est pas un fichier mais une interface de programmation. Plutôt que de télécharger toute la liste d'un coup, votre application dialogue avec le serveur et lui demande uniquement ce dont elle a besoin : d'abord la liste des catégories, puis les chaînes d'une catégorie quand vous l'ouvrez, puis le flux vidéo quand vous lancez une chaîne.
Concrètement, vous ne saisissez plus une longue URL mais trois champs distincts : l'adresse du serveur, votre nom d'utilisateur et votre mot de passe. L'application se charge du reste. Ce fonctionnement par requêtes successives explique pourquoi une interface Xtream s'ouvre en deux secondes là où une playlist M3U de 36 000 entrées peut mettre une minute à charger sur une Smart TV d'entrée de gamme.
Chargement à la demande
Seule la catégorie ouverte est téléchargée, pas les 36 000 chaînes.
Contenus séparés
Direct, films et séries arrivent dans trois sections distinctes.
EPG intégré
Le guide des programmes est fourni par le serveur, sans réglage manuel.
Xtream Codes ou M3U : le comparatif
Les deux formats donnent accès au même abonnement et à la même qualité d'image. La différence porte entièrement sur le confort d'utilisation et la compatibilité.
| Critère | Xtream Codes API | Lien M3U |
|---|---|---|
| Ce que vous saisissez | URL du serveur + identifiant + mot de passe | Une seule URL complète |
| Vitesse de chargement | Rapide, par catégorie | Lente, liste entière |
| VOD séparée du direct | Oui | Tout est mélangé |
| Guide des programmes | Automatique | À ajouter manuellement |
| Mise à jour des chaînes | Automatique | Rechargement manuel |
| Reprise de lecture VOD | Mémorisée | Non gérée |
| Compatible VLC | Non | Oui |
| Usage recommandé | Usage quotidien | Test et diagnostic |
En résumé : utilisez Xtream Codes dès que votre application le propose — c'est le cas de TiviMate, IPTV Smarters Pro et de la quasi-totalité des lecteurs modernes présentés dans notre comparatif des applications IPTV. Gardez le M3U comme solution de repli et comme outil de diagnostic.
Où trouver vos identifiants IPTV
À l'activation de votre abonnement, vous recevez un message contenant trois informations. Elles sont identiques sur tous vos appareils et ne changent pas pendant toute la durée de votre formule.
URL du serveur
Format http://domaine.com:port. Le numéro de port fait partie de l'adresse : sans lui, la connexion échoue systématiquement.
Nom d'utilisateur
Une suite de lettres et de chiffres, sensible à la casse. Une majuscule oubliée suffit à bloquer la connexion.
Mot de passe
Également sensible à la casse. Copiez-collez systématiquement plutôt que de saisir au clavier de la télécommande.
Un conseil qui évite beaucoup de perte de temps : avant de vous installer devant la télévision, envoyez-vous le message d'activation par email. Saisir un mot de passe de vingt caractères avec une télécommande est l'étape où la majorité des erreurs se produisent. Sur Fire Stick et Android TV, l'application Downloader ou un clavier Bluetooth changent radicalement l'expérience — nous détaillons ces astuces dans le tutoriel d'installation sur Fire Stick.
Vos identifiants sont personnels. Les partager entraîne des connexions simultanées au-delà de votre formule et provoque des coupures pour vous en premier. En cas de doute sur une fuite, demandez une réinitialisation depuis le support client.
Configurer vos codes application par application
La procédure varie légèrement selon le lecteur, mais le principe reste le même : choisir le mode Xtream Codes, saisir les trois champs, valider. Voici les cas les plus fréquents.
IPTV Smarters Pro
- Ouvrez l'application et choisissez Login with Xtream Codes API.
- Renseignez un nom de profil libre, par exemple « Salon » ou « Chambre ».
- Collez l'URL du serveur avec son port, puis l'identifiant et le mot de passe.
- Validez : les catégories Live TV, Movies et Series apparaissent séparément.
Réglages avancés, buffer et sous-titres dans notre guide complet IPTV Smarters Pro.
TiviMate
- Menu Add playlist puis Xtream Codes.
- Saisissez l'URL, l'identifiant et le mot de passe.
- Activez le téléchargement de l'EPG à l'étape suivante.
- Choisissez les groupes de chaînes à afficher pour alléger l'interface.
Configuration détaillée dans le guide TiviMate, et comparaison des deux lecteurs dans TiviMate ou IPTV Smarters.
VLC — lien M3U uniquement
- Menu Média puis Ouvrir un flux réseau.
- Collez le lien M3U complet et validez.
- La liste des chaînes s'ouvre dans la playlist latérale.
VLC ne gère ni l'API Xtream ni l'EPG, mais c'est le meilleur outil de diagnostic : si le flux passe dans VLC, vos identifiants sont valides et le problème vient d'ailleurs. Voir l'IPTV sur PC Windows et Mac.
Smart TV Samsung et LG
Les applications natives des Smart TV (Smart IPTV, Set IPTV, Net IPTV) fonctionnent majoritairement au lien M3U, souvent via un portail web où vous enregistrez l'adresse MAC de votre téléviseur avant de coller la playlist.
Procédure complète dans notre comparatif des applications IPTV pour Smart TV et dans le tutoriel IPTV sur Smart TV Samsung et LG.
Le portail MAC : le troisième format
Moins connu que les deux précédents, le portail MAC équipe les boîtiers de type MAG et les applications compatibles Stalker. Le principe est différent : vous ne transmettez ni identifiant ni mot de passe, mais l'adresse MAC de votre appareil, un numéro unique gravé dans son matériel. Le fournisseur associe cette adresse à votre abonnement, puis vous communique une URL de portail à saisir dans les réglages du boîtier.
L'avantage est la sécurité : aucun mot de passe ne circule et l'abonnement ne peut pas être utilisé ailleurs. L'inconvénient est la rigidité — changez de boîtier et il faut faire réassocier la nouvelle adresse MAC. C'est pourquoi ce mode reste réservé aux boîtiers dédiés, tandis que les box Android présentées dans notre comparatif des box Android TV utilisent les Xtream Codes classiques.
Passer d'un format à l'autre
Bonne nouvelle : les deux formats contiennent les mêmes informations, ce qui permet de reconstruire l'un à partir de l'autre sans rien demander à votre fournisseur. Un lien M3U classique se présente ainsi :
http://serveur.com:8080/get.php?username=IDENTIFIANT&password=MOTDEPASSE&type=m3u_plus&output=tsLes trois éléments colorés sont vos Xtream Codes : le serveur avec son port, votre identifiant et votre mot de passe. Si vous n'avez reçu qu'un lien M3U, vous pouvez donc l'utiliser en mode Xtream immédiatement.
L'opération inverse fonctionne aussi : à partir de vos trois champs Xtream, reconstruisez l'URL ci-dessus en remplaçant les valeurs, et vous obtenez un lien M3U utilisable dans VLC ou dans une application de Smart TV qui n'accepte que ce format.
Configurer le guide des programmes (EPG)
L'EPG affiche le programme en cours et à venir sur chaque chaîne. En mode Xtream Codes, il est fourni automatiquement par le serveur : aucune manipulation n'est nécessaire, et un rafraîchissement quotidien se déclenche seul.
En mode M3U, l'EPG doit être ajouté séparément sous la forme d'une seconde URL, généralement au format XMLTV et terminée par xmltv.php. Vous la saisissez dans le champ « EPG URL » ou « Guide TV » de votre application. Si les programmes ne s'affichent pas alors que l'URL est correcte, la cause la plus fréquente est un décalage de fuseau horaire dans les réglages du lecteur.
À noter : un EPG complet sur 36 000 chaînes représente un fichier volumineux. Sur les appareils peu puissants, limitez l'EPG aux groupes de chaînes que vous regardez réellement — le gain de fluidité est immédiat.
Les erreurs courantes et leur solution
Invalid credentials / Identifiants invalides
Un espace s'est glissé au collage, ou la casse ne correspond pas. Recollez les trois champs depuis le message d'origine sans les retaper à la main. Vérifiez également que le port figure bien après le nom de domaine.
La liste se charge mais aucune chaîne ne démarre
Le port est bloqué par votre box ou votre fournisseur d'accès. Testez en partage de connexion mobile : si tout fonctionne, le blocage vient du réseau domestique et un changement de DNS ou un VPN résout généralement le problème.
Chargement infini au démarrage
Trop de chaînes chargées d'un coup en mode M3U. Basculez sur Xtream Codes, qui charge par catégorie, ou masquez les groupes de chaînes que vous ne regardez pas.
Le guide des programmes reste vide
En M3U, l'EPG doit être ajouté séparément via une URL XMLTV. En Xtream Codes, forcez une actualisation de l'EPG dans les réglages et vérifiez le fuseau horaire de l'appareil.
Coupures régulières aux heures de pointe
Rarement un problème d'identifiants. Il s'agit le plus souvent du débit ou du Wi-Fi : notre guide de résolution du buffering détaille la méthode de diagnostic.
Erreur de connexion sur un seul appareil
Vous dépassez le nombre de flux simultanés de votre formule. Fermez complètement l'application sur les autres appareils — une mise en veille ne libère pas toujours la connexion.
Si les coupures persistent après vérification des identifiants, suivez la méthode complète de résolution du buffering IPTV et contrôlez votre débit internet réellement disponible.
Sécuriser et gérer vos identifiants
Ne publiez jamais vos codes
Un identifiant partagé sur un forum est exploité en quelques minutes et sature votre quota de connexions.
Respectez vos flux simultanés
Une formule 1 écran s'installe sur autant d'appareils que vous voulez, mais ne lit qu'un flux à la fois.
Préférez le câble Ethernet
La majorité des coupures attribuées aux identifiants viennent en réalité du Wi-Fi sur la TV.
Conservez le message d'activation
Archivez-le dans un dossier email dédié : vous en aurez besoin à chaque nouvel appareil.
Si vous regardez sur plusieurs postes à la maison, une formule multi-écrans évite les conflits de connexion : voir notre guide IPTV famille et multi-écrans. Sur la question du chiffrement du trafic, notre guide VPN pour IPTV explique quand un VPN aide réellement et quand il dégrade la fluidité.
Recevez vos codes en 5 minutes
Chaque abonnement est livré avec vos identifiants Xtream Codes et votre lien M3U, plus l'assistance à l'installation sur l'appareil de votre choix.
Pack Abonnement IPTV
IPTV 12 MOIS Premium
Smart TV, Mobile, PC
soit 4,16€/mois seulement
Questions fréquentes
Articles liés
Installation IPTV : le guide pilier
Tous les tutoriels par appareil
Quelle application IPTV choisir
Comparatif des lecteurs 2026
Guide IPTV Smarters Pro
Installation et réglages avancés
Guide TiviMate
Le lecteur n°1 sur Android TV
Applications IPTV pour Smart TV
Smart IPTV, Set IPTV, Net IPTV
IPTV sur PC Windows et Mac
VLC et lecteurs desktop
Guide IPTV pour débutants
Les bases expliquées simplement