Xtream Codes dans IPTV Smarters Pro : URL, identifiants et erreurs

Pour ajouter un abonnement dans IPTV Smarters Pro, l'option recommandée est Login with Xtream Codes API. Elle demande trois informations : une URL de serveur, un nom d'utilisateur et un mot de passe. C'est plus rapide et plus complet qu'un lien M3U, mais c'est aussi là que se produisent la plupart des erreurs de connexion. Ce guide explique ce que sont les identifiants Xtream Codes, comment les saisir sans erreur dans IPTV Smarters Pro, et comment interpréter les messages d'erreur.

D'où vient le nom Xtream Codes ?

À l'origine, Xtream-Codes était un logiciel de gestion de serveurs IPTV utilisé par de nombreux fournisseurs. Il a été démantelé en 2019 lors d'une opération de police menée en Italie contre la diffusion illégale de chaînes payantes.

Le nom est pourtant resté, pour une raison simple : le logiciel avait popularisé une interface de connexion standard (une API) que les lecteurs IPTV savent interroger. Aujourd'hui, de nombreux serveurs compatibles utilisent toujours ce format, et les lecteurs l'appellent « Xtream Codes API » ou « XC API ». Le terme désigne donc désormais une méthode de connexion, et non plus le logiciel d'origine.

Les trois identifiants à saisir dans IPTV Smarters Pro

Identifiant	Exemple (fictif)	Ce qu'il faut vérifier
URL du serveur	`http://exemple-serveur.com:8080`	Le préfixe `http://` ou `https://` et le port après les deux-points
Nom d'utilisateur	`jean_dupont42`	Majuscules, minuscules, chiffres exacts
Mot de passe	`aB3xK9pQ`	Aucun espace avant ou après

Certains lecteurs demandent en plus un nom de profil (« Any Name », « Playlist name ») : c'est un libellé libre, qui sert seulement à vous repérer si vous avez plusieurs abonnements.

Le piège du port

L'URL du serveur comprend souvent un port, le nombre placé après les deux-points (par exemple :8080 ou :80). L'oublier est l'erreur la plus fréquente : le lecteur n'arrive pas à joindre le serveur et affiche une erreur de connexion, alors que les identifiants sont justes. Recopiez l'URL exactement telle qu'elle vous a été fournie.

La connexion Xtream Codes dans IPTV Smarters Pro pas à pas

Ouvrez IPTV Smarters Pro et choisissez Add User.
Sélectionnez Login with Xtream Codes API.
Remplissez les quatre champs :
- Any Name : un nom libre, par exemple « Salon » ;
- Username : votre nom d'utilisateur ;
- Password : votre mot de passe ;
- URL : l'adresse du serveur, avec http:// et le port.
Validez avec Add User.

IPTV Smarters Pro vérifie alors le compte, puis charge les rubriques Live TV, Films et Séries ainsi que le guide des programmes. Si vous avez plusieurs abonnements, ou un abonnement principal et un essai, créez un utilisateur par compte : l'application permet de passer de l'un à l'autre depuis l'écran de sélection des profils, sans rien ressaisir.

Pourquoi préférer Xtream Codes au M3U ?

Les deux méthodes donnent accès au même contenu, mais pas avec le même confort.

Critère	Connexion Xtream Codes	Lien M3U
Saisie	Trois champs courts	Une longue URL
Chaînes, films et séries	Rangés dans des rubriques séparées	Souvent mélangés en une seule liste
Guide des programmes	Chargé automatiquement	Parfois à ajouter séparément
Fiches des films (affiche, résumé)	Oui, si le fournisseur les renseigne	Rarement
Replay (catch-up)	Pris en charge si le fournisseur le propose	Plus limité
Chargement	Par rubrique, plus rapide	Toute la liste d'un coup, plus lent
Informations sur le compte	Date d'expiration, connexions autorisées	Aucune

En résumé, le M3U reste utile pour les lecteurs qui ne gèrent que ce format (VLC, certains lecteurs pour Smart TV) et pour le dépannage. Pour un usage quotidien, la connexion Xtream Codes est plus agréable. Notre article sur la liste M3U IPTV détaille l'autre format.

Comment la connexion fonctionne

Sans entrer dans le détail technique, voici ce qui se passe quand vous validez vos identifiants :

Le lecteur interroge le serveur pour vérifier le compte : existe-t-il, est-il actif, quand expire-t-il, combien de connexions sont autorisées ?
Il récupère ensuite les catégories de chaînes, de films et de séries.
Il télécharge le guide des programmes associé.
Quand vous choisissez un programme, il demande l'adresse du flux correspondant et le lit.

Cette organisation explique pourquoi la connexion Xtream charge plus vite : le lecteur ne télécharge pas tout d'un coup, mais rubrique par rubrique, au fur et à mesure de votre navigation.

IPTV Smarters Pro et les autres lecteurs compatibles

La plupart des lecteurs modernes acceptent la connexion Xtream Codes :

IPTV Smarters Pro et Smarters Player Lite : option « Login with Xtream Codes API ». Voir notre guide d'IPTV Smarters Pro.
TiviMate : Add playlist > Xtream Codes. Voir TiviMate.
Hot Player : source « Xtream Code » sur le site de l'éditeur. Voir Hot Player.
IBO Player et Flix IPTV : selon les versions, sur le site de gestion des playlists.
Les lecteurs de l'App Store comme iMPlayer : type « XC API ».

À l'inverse, VLC, Smart IPTV et SS IPTV fonctionnent principalement avec des liens M3U. Dans ce cas, vous pouvez construire le lien M3U à partir de vos identifiants Xtream Codes, comme expliqué dans notre article sur la liste M3U, ou le demander à votre fournisseur.

Résoudre les erreurs de connexion dans IPTV Smarters Pro

Message	Cause probable	Solution
« Invalid username or password »	Faute de frappe, majuscule, espace en trop	Copier-coller depuis l'e-mail d'origine
« Connection failed » / chargement infini	Port oublié, `http://` manquant	Recopier l'URL complète
« Account expired »	Abonnement arrivé à échéance	Vérifier la date d'expiration auprès du fournisseur
« Max connections reached »	Trop d'appareils connectés en même temps	Fermer le lecteur sur un autre appareil
Rubriques Films et Séries vides	Offre sans VOD, ou lecteur limité	Vérifier le contenu de l'abonnement

Le message sur le nombre maximal de connexions mérite une précision : un abonnement autorise un nombre défini d'appareils simultanés. Un lecteur resté ouvert sur une tablette, dans une autre pièce, peut suffire à bloquer le téléviseur du salon.

Consulter les informations de son compte

Un avantage méconnu de cette méthode de connexion : le lecteur peut afficher l'état de votre abonnement, directement depuis le serveur. Selon les applications, on trouve ces informations dans une rubrique « Compte », « Account info » ou dans les détails du profil.

Information	À quoi elle sert
Date d'expiration	Savoir quand renouveler, sans attendre la coupure
Connexions actives / autorisées	Comprendre pourquoi un appareil est refusé
Statut du compte	Vérifier qu'il est actif et non suspendu
Date de création	Retrouver la date de début de l'abonnement

Ces informations sont précieuses pour dépanner. Si un appareil affiche une erreur alors que le compte indique « actif » et une connexion libre, le problème vient de la saisie ou du réseau. Si le nombre de connexions actives est déjà au maximum, fermez le lecteur sur les autres écrans avant de chercher plus loin.

Ce tableau de bord n'existe pas avec un simple lien de playlist : c'est l'une des raisons pratiques de privilégier la connexion par identifiants lorsque votre lecteur la propose. Pensez aussi à noter la date d'expiration dans votre agenda : la plupart des fournisseurs ne renouvellent pas automatiquement, et une coupure un soir de match est toujours mal vécue.

Sécurité : protéger ses identifiants

Vos identifiants Xtream Codes donnent un accès direct à votre abonnement. Quelques règles de bon sens :

Ne les partagez pas en dehors du foyer : un compte utilisé depuis de nombreuses adresses différentes peut être suspendu.
Ne les saisissez pas sur un site inconnu qui prétend « tester » votre abonnement ou « activer » un lecteur à votre place.
Méfiez-vous des captures d'écran que vous envoyez pour obtenir de l'aide : masquez le mot de passe.
Demandez un changement de mot de passe si vous pensez qu'ils ont fuité.

Questions fréquentes

Où mettre l'URL, le nom d'utilisateur et le mot de passe dans IPTV Smarters Pro ?

Dans Add User, puis Login with Xtream Codes API. L'URL du serveur va dans le champ URL, avec http:// et le port, et les identifiants dans Username et Password.

Qu'est-ce que Xtream Codes en IPTV ?

C'est une méthode de connexion standard : une URL de serveur, un nom d'utilisateur et un mot de passe, que le lecteur utilise pour récupérer chaînes, films, séries et guide des programmes. Le nom vient d'un ancien logiciel de gestion de serveurs.

Xtream Codes est-il légal ?

La méthode de connexion est une simple interface technique, utilisée par de nombreux serveurs. La légalité dépend du contenu diffusé et des droits du fournisseur, pas du format de connexion. Voir l'IPTV est-elle légale en France ?.

Où trouver mes identifiants Xtream Codes ?

Dans l'e-mail ou le message envoyé par votre fournisseur à l'activation. Ils sont parfois aussi visibles dans votre espace client.

Peut-on convertir des identifiants Xtream en lien M3U ?

Oui, la plupart des serveurs compatibles génèrent un lien M3U à partir des mêmes identifiants. Demandez-le à votre fournisseur si votre lecteur n'accepte que le M3U.

Pourquoi mes identifiants fonctionnent sur un appareil et pas sur un autre ?

Le plus souvent, l'URL a été mal recopiée sur le second appareil, ou le nombre de connexions simultanées est atteint. Comparez les deux saisies caractère par caractère.

Conclusion

Dans IPTV Smarters Pro, la connexion Xtream Codes est la méthode la plus confortable : trois champs bien remplis, URL avec son port, nom d'utilisateur et mot de passe, suffisent à obtenir des rubriques bien rangées et un guide des programmes chargé automatiquement. La plupart des erreurs viennent d'une faute de frappe ou d'un port oublié. Pour essayer cette méthode avec un abonnement réel, notre test IPTV gratuit vous fournit des identifiants Xtream Codes prêts pour IPTV Smarters Pro.