Un code Xtream, ce sont trois informations : l’adresse d’un serveur, un nom d’utilisateur et un mot de passe. Rien de plus. Vous les tapez une fois dans une application comme IPTV Smarters ou TiviMate, et elle range toute seule les chaînes, les films, les séries et le guide des programmes. Le nom vient d’un logiciel, Xtream Codes, qui a disparu en 2019. Son format, lui, est resté : c’est aujourd’hui la façon la plus courante de livrer un abonnement IPTV. Ce guide explique comment lire ces identifiants, où les saisir, comment les transformer en lien M3U quand une application ne les accepte pas, et que faire quand la connexion échoue.
Sommaire
Xtream Codes, c’est quoi ?
À l’origine, Xtream Codes était un logiciel de gestion pour fournisseurs IPTV. Il servait à créer des comptes, à fixer leur date d’expiration, à limiter le nombre d’écrans et à distribuer les flux. Pour que les applications des clients puissent se connecter à ces serveurs, il proposait une interface standard, une « API ». Les développeurs d’applications l’ont adoptée en masse, parce qu’elle leur évitait de réinventer la roue pour chaque fournisseur.
C’est cette interface qui a donné son nom au « code Xtream ». Quand un fournisseur vous envoie un code Xtream IPTV, il vous donne en réalité de quoi vous connecter à cette API : où se trouve le serveur, et qui vous êtes.
Concrètement, vous recevez toujours ces trois éléments :
- L’URL du serveur, parfois appelée « host », « portal » ou « server URL ». Elle ressemble à
http://serveur.exemple:8080. - Le nom d’utilisateur, propre à votre abonnement.
- Le mot de passe, lié à ce nom d’utilisateur.
Certains fournisseurs ajoutent un lien M3U et un lien EPG dans le même message. Ce ne sont pas des abonnements différents : ce sont les mêmes accès, présentés autrement. On y revient plus bas.
Attention à une confusion fréquente. Le code IPTV à 12 ou 16 chiffres utilisé par certaines applications, comme les codes d’activation, n’a rien à voir avec un code Xtream. Le premier se tape sur un seul champ. Le second en demande toujours trois.
Xtream Codes ou lien M3U : ce qui change
Un lien M3U est une longue adresse qui pointe vers un fichier texte. Ce fichier contient la liste des chaînes, l’une après l’autre. L’application le télécharge, le lit, et affiche ce qu’elle y trouve. C’est simple et universel : presque tous les lecteurs savent ouvrir un M3U, de VLC à Smart IPTV.
Avec un code Xtream, l’application ne télécharge pas une liste figée. Elle dialogue avec le serveur et lui demande, au fur et à mesure, les catégories, les chaînes, les films, les séries, les affiches et le programme TV. Le résultat est plus propre, et plus rapide à charger sur les gros catalogues.
| Critère | Code Xtream | Lien M3U |
|---|---|---|
| Ce que vous recevez | URL + utilisateur + mot de passe | Une seule adresse très longue |
| Films et séries | Rangés à part, avec affiches et résumés | Mélangés aux chaînes, souvent sans affiche |
| Guide des programmes | Récupéré automatiquement | Lien EPG à ajouter à la main |
| Mises à jour | Visibles tout de suite | Il faut recharger la liste |
| Infos du compte | Date d’expiration et écrans affichés | Aucune |
| Compatibilité | IPTV Smarters, TiviMate, GSE, XCIPTV… | Presque partout, dont Smart IPTV et VLC |
En pratique, si votre application propose une connexion Xtream, utilisez-la. Gardez le M3U pour les cas où vous n’avez pas le choix.
Lire ses identifiants : URL, port, utilisateur, mot de passe
La plupart des erreurs de connexion viennent d’une faute de recopie. Prenons un exemple fictif, tel qu’un fournisseur pourrait l’envoyer :
URL : http://serveur.exemple:8080Utilisateur : martin2026Mot de passe : a7Kp92xQ
Voici comment lire chaque morceau.
Le protocole : http ou https
Le début de l’adresse, http:// ou https://, n’est pas décoratif. Si le serveur fonctionne en http et que vous tapez https, la connexion échoue sans message clair. Recopiez exactement ce que l’on vous a donné. Certaines applications ajoutent le protocole toutes seules : dans ce cas, ne le tapez pas deux fois.
Le nom du serveur
C’est la partie entre // et les deux-points. Il peut s’agir d’un nom de domaine ou d’une adresse IP en chiffres. Pas d’espace, pas de majuscule ajoutée par le correcteur du téléphone.
Le port
Le nombre après les deux-points est le port. On voit souvent 80, 8080, 8000, 25461 ou 2095, mais chaque fournisseur choisit le sien. S’il est indiqué, il doit figurer dans l’URL. Une adresse sans port, alors qu’il en fallait un, ne mènera nulle part. Si aucun port n’est indiqué, l’application utilise le port par défaut, 80 en http et 443 en https.
L’utilisateur et le mot de passe
Les deux sont sensibles aux majuscules. « Martin2026 » et « martin2026 » sont deux comptes différents. Méfiez-vous des caractères qui se ressemblent : le zéro et la lettre O, le chiffre 1 et la lettre l minuscule. Le plus sûr reste le copier-coller, en vérifiant qu’aucun espace ne s’est glissé à la fin.
Un point que beaucoup ignorent : l’URL du serveur ne doit contenir que le protocole, le nom et le port. Si vous collez http://serveur.exemple:8080/get.php?username=… dans le champ URL, l’application ne trouvera rien. Cette forme longue, c’est le lien M3U, pas l’URL Xtream.
Configurer un code Xtream dans son application
Le principe est le même partout : on choisit le mode de connexion Xtream, on remplit trois champs, on valide. Seuls les noms des menus changent. Voici les applications les plus utilisées.
IPTV Smarters Pro
- Ouvrez l’application et choisissez Login with Xtream Codes API.
- Dans « Any Name », mettez le nom de votre choix, par exemple « Salon ». Ce champ est purement décoratif.
- Remplissez « Username », « Password » et « URL » avec vos trois identifiants.
- Appuyez sur Add User. Le premier chargement peut prendre une à deux minutes sur un gros catalogue.
Le guide détaillé, avec les captures pour Android, Fire TV et Smart TV, se trouve sur notre page IPTV Smarters Pro.
TiviMate
- Allez dans Ajouter une playlist, puis choisissez Xtream Codes.
- Saisissez l’adresse du serveur, puis l’utilisateur et le mot de passe.
- Validez. TiviMate récupère les chaînes et le guide des programmes, et vous propose de nommer la playlist.
TiviMate affiche ensuite la date d’expiration du compte dans les réglages de la playlist, pratique pour ne pas être surpris.
GSE Smart IPTV
- Ouvrez le menu et choisissez Xtream Codes API.
- Appuyez sur le bouton + pour ajouter un compte.
- Remplissez le nom, l’URL du serveur, l’utilisateur et le mot de passe, puis enregistrez.
Pour les écrans propres à chaque version, iPhone, Android ou Apple TV, consultez notre guide GSE Smart IPTV.
Smart IPTV, SmartOne et les applications sans Xtream
Toutes les applications n’acceptent pas les codes Xtream. Smart IPTV, très répandue sur les téléviseurs Samsung et LG, ne fonctionne qu’avec une liste M3U, envoyée depuis le site my.iptv.app avec l’adresse MAC du téléviseur. La démarche complète est décrite dans notre guide Smart IPTV. Pour SmartOne IPTV ou Flix IPTV, cela dépend de la version : certaines acceptent les deux formats, d’autres uniquement le M3U. Dans tous ces cas, la solution est la même : convertir le code Xtream en lien M3U.
Convertir un code Xtream en lien M3U
Bonne nouvelle : pas besoin d’outil en ligne ni de logiciel. Le lien M3U se construit à la main à partir de vos trois identifiants. Il suit toujours le même modèle :
http://serveur.exemple:8080/get.php?username=VOTRE_UTILISATEUR&password=VOTRE_MOT_DE_PASSE&type=m3u_plus&output=ts
Il suffit de remplacer trois morceaux :
- Le début,
http://serveur.exemple:8080, par votre URL de serveur, port compris. VOTRE_UTILISATEURpar votre nom d’utilisateur.VOTRE_MOT_DE_PASSEpar votre mot de passe.
Le reste ne bouge pas. Deux réglages méritent tout de même une explication :
type=m3u_plusdemande une liste enrichie, avec les logos et les catégories. Si votre application affiche une liste vide ou plante, essayeztype=m3u, plus basique.output=tschoisit le format des flux. Sur certains téléviseurs et sur iPhone,output=m3u8donne une lecture plus fluide. Faites l’essai si l’image saccade.
Pour récupérer aussi le guide des programmes, le lien EPG se construit de la même façon, avec xmltv.php à la place de get.php :
http://serveur.exemple:8080/xmltv.php?username=VOTRE_UTILISATEUR&password=VOTRE_MOT_DE_PASSE
Avant de coller le lien dans votre application, testez-le dans le navigateur d’un ordinateur. S’il déclenche le téléchargement d’un fichier, tout est bon. S’il affiche une page blanche ou une erreur, l’un des trois identifiants est mal recopié, ou l’abonnement n’est plus actif.
L’opération inverse marche aussi. Si vous n’avez reçu qu’un lien M3U de cette forme, vous pouvez en extraire l’URL, l’utilisateur et le mot de passe pour vous connecter en mode Xtream. Ce n’est possible que si le lien contient bien get.php?username= : les M3U hébergés ailleurs, sur un raccourcisseur d’adresse par exemple, ne se convertissent pas.
L’API Xtream Codes, en coulisses
Les recherches sur « xtream codes api » ont fortement augmenté cette année, souvent de la part de curieux qui veulent comprendre ce que fait leur application. Voici l’essentiel, sans entrer dans le code.
Quand vous validez vos identifiants, l’application appelle une adresse du type …/player_api.php?username=…&password=…. Le serveur répond par une fiche de votre compte : statut actif ou non, date d’expiration, nombre d’écrans autorisés, nombre de connexions en cours. C’est là que TiviMate ou Smarters vont chercher la date qu’ils vous affichent.
Ensuite, l’application ajoute à cette même adresse une « action » pour chaque besoin : les catégories de chaînes, la liste des chaînes d’une catégorie, les films, les séries et leurs épisodes, le programme des prochaines heures. Chaque demande ne charge que ce qui est nécessaire. C’est pour cette raison qu’un catalogue de plusieurs milliers d’entrées s’affiche plus vite en Xtream qu’avec un M3U, qui doit être téléchargé en entier à chaque mise à jour.
Ce fonctionnement a une conséquence pratique : votre mot de passe passe dans l’adresse à chaque requête. Sur un serveur en http, il circule en clair. Raison de plus pour ne jamais réutiliser ce mot de passe ailleurs, pour votre messagerie ou votre banque.
Les erreurs fréquentes et leurs solutions
La plupart des messages d’erreur se ressemblent d’une application à l’autre. Ce tableau regroupe les plus courants.
| Message ou symptôme | Cause probable | Que faire |
|---|---|---|
| Authorization failed / Invalid credentials | Utilisateur ou mot de passe mal recopié | Copier-coller à nouveau, vérifier majuscules, 0 et O, espace final |
| Account expired | Abonnement arrivé à échéance | Vérifier la date de fin, renouveler auprès du fournisseur |
| Max connections reached | Trop d’écrans utilisent le compte en même temps | Fermer l’application sur les autres appareils, attendre une minute |
| Connexion impossible / Server not found | URL, port ou protocole incorrect | Comparer caractère par caractère, tester http au lieu de https |
| Liste vide après connexion | URL longue collée dans le champ URL, ou catégories masquées | Ne garder que protocole, nom et port ; vérifier les filtres de l’application |
| Chaînes qui coupent | Wi-Fi faible ou serveur saturé | Passer en Ethernet, changer de format de flux (ts ou m3u8) |
Deux réflexes avant d’aller plus loin. D’abord, essayez les mêmes identifiants dans une autre application : si la connexion marche ailleurs, le problème vient de l’application, pas du compte. Ensuite, redémarrez la box ou le routeur. Certains fournisseurs d’accès bloquent des serveurs au niveau de leurs DNS, et un redémarrage ne règle pas ce cas-là, mais il élimine les blocages temporaires.
Un code Xtream sur plusieurs appareils
Vous pouvez enregistrer le même code Xtream sur autant d’appareils que vous voulez : la télévision du salon, une tablette, un téléphone. Ce qui compte, c’est le nombre d’appareils qui regardent au même moment. Un abonnement standard n’autorise souvent qu’une seule lecture à la fois. Si deux personnes lancent une chaîne en même temps, l’une sera déconnectée, ou les deux, avec le message « max connections ».Si plusieurs personnes regardent en parallèle chez vous, il faut un abonnement qui autorise plusieurs connexions simultanées. Sur une application qui affiche les infos du compte, vous voyez d’ailleurs le nombre de connexions permises et le nombre de connexions actives : c’est le moyen le plus simple de vérifier ce que vous avez acheté. C’est le principe de notre abonnement IPTV multi écran : 2, 3 ou 4 connexions en même temps. Pour un seul écran, toutes les durées sont sur la page abonnement Smart IPTV.Protéger ses identifiants Xtream
Vos trois identifiants donnent accès à votre abonnement, et à rien d’autre. Mais quelqu’un qui les récupère peut s’en servir à votre place, et c’est vous qui serez déconnecté. Quelques précautions simples :
- Ne les publiez pas, même en capture d’écran sur un forum pour demander de l’aide. Masquez au moins le mot de passe.
- Gardez-les dans une note sécurisée ou un gestionnaire de mots de passe, pas dans une conversation de groupe.
- Méfiez-vous des applications inconnues qui demandent vos identifiants Xtream. Privilégiez celles des boutiques officielles, Google Play, App Store ou la boutique de votre téléviseur.
- Si vous pensez qu’ils ont fuité, demandez à votre fournisseur de changer le mot de passe. L’ancien cessera de fonctionner sur tous les appareils.
Xtream Codes, le logiciel : ce qu’il en reste
En septembre 2019, une enquête menée depuis l’Italie a visé la société qui éditait Xtream Codes. Des serveurs ont été saisis dans plusieurs pays européens, et le logiciel a cessé d’être distribué officiellement. Beaucoup d’utilisateurs ont alors cru que les « codes Xtream » allaient disparaître.
Ce n’est pas ce qui s’est passé. Le format de connexion, lui, était devenu un standard de fait. D’autres logiciels de gestion ont repris la même API pour que les applications existantes continuent de fonctionner. C’est pourquoi on parle toujours de « code Xtream » en 2026, alors que le produit d’origine n’existe plus. Le mot désigne aujourd’hui une façon de se connecter, pas un fournisseur ni un logiciel précis.
Il faut garder en tête une chose : un format technique ne dit rien de la légalité du contenu diffusé. Un code Xtream peut donner accès à un service parfaitement en règle comme à un service pirate. Pour faire la différence et connaître les risques réels en France, lisez notre article IPTV illégal ou légal.
Codes Xtream gratuits : pourquoi les éviter
Tapez « code Xtream gratuit » dans un moteur de recherche et vous trouverez des dizaines de pages qui promettent des identifiants à jour, souvent « testés aujourd’hui ». Dans la grande majorité des cas, ce sont des comptes piratés à de vrais abonnés, des accès qui expirent au bout de quelques heures, ou un prétexte pour vous faire installer une application douteuse ou cliquer sur des publicités.
Même quand un code fonctionne, il est partagé par des centaines de personnes en même temps. Il sature, coupe, puis disparaît. Et vous ne savez pas d’où viennent les flux. Pour juger un service avant de payer, la seule méthode fiable reste un test IPTV fourni directement par le vendeur, sur votre propre télévision et à l’heure où vous regardez d’habitude.
Questions fréquentes
Comment avoir un code Xtream ?
Un code Xtream est fourni par le service IPTV auquel vous vous abonnez, en général par e-mail ou par messagerie juste après l’achat ou la demande de test. Il comprend une URL de serveur, un nom d’utilisateur et un mot de passe. Il n’existe pas de code Xtream officiel à générer soi-même.
Comment créer un compte Xtream ?
En tant qu’utilisateur, vous ne créez pas de compte Xtream vous-même : c’est le fournisseur qui le crée sur son serveur et vous envoie les identifiants. Côté application, il suffit ensuite d’ajouter un profil en choisissant la connexion « Xtream Codes API ».
Comment convertir un code Xtream en lien M3U ?
Assemblez le lien suivant avec vos identifiants : URL du serveur avec le port, puis /get.php?username= votre utilisateur, &password= votre mot de passe, et &type=m3u_plus&output=ts. Testez-le dans un navigateur : il doit lancer le téléchargement d’un fichier.
Quelle application utiliser avec un code Xtream ?
IPTV Smarters Pro, TiviMate, GSE Smart IPTV et XCIPTV acceptent les codes Xtream. Sur les téléviseurs Samsung et LG, Smart IPTV n’accepte que le M3U : il faut donc convertir le code avant de l’utiliser.
Où trouver l’URL du serveur Xtream ?
Elle figure dans le message envoyé par votre fournisseur, sous le nom URL, host, server ou portal. Si vous n’avez qu’un lien M3U, l’URL du serveur correspond au début du lien, jusqu’au port inclus, juste avant /get.php.
Un code Xtream fonctionne-t-il sur plusieurs appareils ?
Oui, vous pouvez l’enregistrer sur plusieurs appareils. En revanche, le nombre d’écrans qui regardent en même temps est limité par votre abonnement, souvent un seul. Au-delà, l’application affiche « max connections ».
Pourquoi mon code Xtream ne marche plus ?
Les causes les plus courantes sont un abonnement expiré, un mot de passe changé par le fournisseur, un serveur qui a changé d’adresse ou un blocage par votre fournisseur d’accès. Vérifiez d’abord la date d’expiration dans l’application, puis contactez le service qui vous a fourni le code.
À propos de cet article
Guide pratique rédigé par l’équipe d’abonnement-smart-iiptv.fr à partir de la configuration réelle des applications citées. Les identifiants montrés dans l’article et les images sont fictifs. Dernière mise à jour : octobre 2026.
Prêt à essayer ? Demandez un test IPTV pour vérifier la connexion sur votre propre écran, et gardez sous la main notre guide du code IPTV. À lire aussi : comment fonctionne l’IPTV et quel boîtier IPTV choisir.