Guide technique · Silo Installation

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.ts

C'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èreXtream Codes APILien M3U
Ce que vous saisissezURL du serveur + identifiant + mot de passeUne seule URL complète
Vitesse de chargementRapide, par catégorieLente, liste entière
VOD séparée du direct Oui Tout est mélangé
Guide des programmesAutomatiqueÀ ajouter manuellement
Mise à jour des chaînesAutomatiqueRechargement manuel
Reprise de lecture VODMémoriséeNon gérée
Compatible VLC Non Oui
Usage recommandéUsage quotidienTest 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

  1. Ouvrez l'application et choisissez Login with Xtream Codes API.
  2. Renseignez un nom de profil libre, par exemple « Salon » ou « Chambre ».
  3. Collez l'URL du serveur avec son port, puis l'identifiant et le mot de passe.
  4. 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

  1. Menu Add playlist puis Xtream Codes.
  2. Saisissez l'URL, l'identifiant et le mot de passe.
  3. Activez le téléchargement de l'EPG à l'étape suivante.
  4. 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

  1. Menu Média puis Ouvrir un flux réseau.
  2. Collez le lien M3U complet et validez.
  3. 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=ts

Les 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.

OFFRE LIMITÉE

Pack Abonnement IPTV

IPTV 12 MOIS Premium

Smart TV, Mobile, PC

89€49€

soit 4,16€/mois seulement

+36 000 chaînes HD/4K
VOD & Replay inclus
1 Mois Offert
S'ABONNER MAINTENANT

Garantie 30 jours|Paiement Sécurisé

Questions fréquentes

Un lien M3U est un simple fichier texte contenant la liste complète des chaînes. Xtream Codes est une API : vous saisissez une adresse de serveur, un nom d'utilisateur et un mot de passe, et l'application interroge le serveur pour récupérer les chaînes, la VOD et le guide des programmes séparément. Xtream Codes charge plus vite, met à jour la liste automatiquement et sépare le direct de la vidéo à la demande. Le M3U reste utile pour les lecteurs qui ne gèrent pas l'API, comme VLC.
Ils vous sont envoyés par WhatsApp ou par email à l'activation de votre abonnement. Le message contient trois éléments : l'URL du serveur (souvent au format http://domaine.com:port), votre nom d'utilisateur et votre mot de passe. Conservez ce message : ce sont les mêmes identifiants sur tous vos appareils, quelle que soit l'application utilisée.
Les identifiants fonctionnent sur n'importe quel appareil, mais le nombre de flux simultanés dépend de votre formule. Une formule 1 écran autorise une seule lecture à la fois : vous pouvez installer l'application sur la TV, le téléphone et le PC, mais un seul appareil peut regarder en même temps. Les formules Famille permettent 2 à 5 lectures simultanées.
Trois causes, par ordre de fréquence : le lien a été copié incomplet (il doit se terminer par &type=m3u_plus&output=ts), l'abonnement est arrivé à expiration, ou votre fournisseur d'accès bloque le port utilisé. Testez d'abord le lien dans VLC sur un ordinateur. S'il fonctionne là mais pas sur la TV, le problème vient de l'application ou du réseau local, pas des identifiants.
C'est un troisième mode de connexion, utilisé par les boîtiers de type MAG et les émulateurs Stalker. Au lieu d'un identifiant et d'un mot de passe, vous communiquez l'adresse MAC de votre boîtier et le fournisseur l'associe à votre abonnement. Vous saisissez ensuite une URL de portail dans les réglages du boîtier. L'avantage est qu'aucun mot de passe ne circule ; l'inconvénient est que l'abonnement est lié à un appareil précis.
Rarement plus de quelques heures. Ces codes sont des identifiants partagés publiquement : le serveur limite les connexions simultanées, l'accès sature immédiatement et le compte est désactivé. Ils exposent aussi à des serveurs non maîtrisés qui peuvent enregistrer votre adresse IP. Un essai gratuit fourni par un service identifié donne un accès complet et stable pendant 24 heures.
Ce n'est pas nécessaire au fonctionnement. Un VPN devient utile dans deux cas : si votre fournisseur d'accès ralentit ou bloque certains ports de streaming, et si vous souhaitez masquer votre activité réseau. Notez qu'un VPN mal choisi ajoute de la latence et peut dégrader la fluidité en 4K. Privilégiez un serveur proche géographiquement.
En mode Xtream Codes, la mise à jour est automatique : les nouvelles chaînes apparaissent au redémarrage de l'application. En mode M3U, vous devez recharger manuellement la playlist depuis les réglages de votre lecteur. C'est l'une des raisons principales de préférer l'API Xtream quand votre application la propose.

Articles liés