Configuration
Xtream Codes expliqué : serveur, identifiant, mot de passe
Xtream Codes IPTV expliqué simplement : différence avec M3U, champs serveur/utilisateur/mot de passe, ports et fonctionnement de la connexion API.
Le terme « Xtream » revient souvent dans les emails d'activation IPTV, mais son fonctionnement technique reste rarement expliqué clairement. Ce guide détaille ce que sont réellement les identifiants Xtream Codes, comment ils diffèrent d'une URL M3U, et à quoi correspond chaque champ demandé par l'application.
D'où vient le terme Xtream Codes ?
Xtream Codes désignait à l'origine un panneau de gestion utilisé par certains fournisseurs IPTV pour administrer leurs serveurs. Dans l'usage courant aujourd'hui, « connexion Xtream Codes » ou « Xtream Codes API » désigne simplement une méthode de connexion structurée, où l'application communique avec le serveur via une interface de programmation (API) plutôt qu'en téléchargeant un simple fichier texte. Une API est, de façon générale, une interface qui permet à deux programmes d'échanger des données de façon structurée, comme le rappelle la définition de Wikipédia.
Quels sont les trois champs Xtream Codes à renseigner ?
Une connexion Xtream Codes demande systématiquement trois informations : une adresse de serveur (avec son port), un nom d'utilisateur et un mot de passe, comme illustré dans le schéma ci-dessus.
| Champ | Rôle | Exemple de format |
|---|---|---|
| Adresse du serveur | URL du serveur IPTV, avec son port | http://exemple-serveur.fr:8080 |
| Nom d'utilisateur | Identifiant unique associé à votre abonnement | Fourni par email |
| Mot de passe | Clé associée à cet identifiant | Fourni par email |
L'adresse du serveur inclut généralement un numéro de port (souvent après les deux-points, comme :8080) : ce numéro fait partie intégrante de l'adresse et doit être recopié à l'identique, sans l'omettre. Une erreur fréquente consiste à ne saisir que le nom de domaine sans le port, ce qui empêche toute connexion.
Que récupère l'application une fois connectée ?
Une fois les trois champs validés, l'application interroge le serveur via l'API et affiche séparément le direct, la VOD et l'EPG fournis par le compte. Dans le détail :
- le direct (chaînes en temps réel, organisées par catégories) ;
- la VOD (films et séries à la demande) ;
- l'EPG (guide des programmes), lorsque le serveur le fournit.
C'est cette séparation automatique en rubriques distinctes qui différencie le plus visiblement une connexion Xtream Codes d'une simple liste M3U, où tout apparaît généralement dans une seule liste, selon l'organisation propre au lecteur. Des applications comme TiviMate ou IPTV Smarters Pro exploitent pleinement cette structure via leur écran de connexion dédié « Xtream Codes API ».
Quelle est la vraie différence entre Xtream Codes et M3U ?
La différence ne porte pas sur la qualité du flux vidéo, identique dans les deux cas puisqu'il s'agit du même abonnement. Elle porte sur la méthode de connexion et l'organisation du catalogue :
- M3U transmet une URL unique que le lecteur interprète comme une liste, selon la structure décrite dans notre article sur l'anatomie d'un fichier M3U.
- Xtream Codes transmet trois identifiants distincts et laisse l'application interroger le serveur pour construire dynamiquement direct, VOD et EPG.
Le format M3U reste par ailleurs plus universellement compatible, y compris avec des lecteurs simples ne proposant aucun écran de connexion IPTV dédié, comme le documente la fiche de référence du format sur Wikipedia. Notre comparatif M3U ou Xtream Codes détaille comment choisir entre les deux selon votre application.
Que faire en cas d'erreur de connexion Xtream Codes ?
Les erreurs les plus courantes viennent d'une faute de frappe dans l'un des trois champs, en particulier sur mobile où la copie peut ajouter un caractère invisible. Si la connexion échoue malgré une saisie soigneusement vérifiée, cela peut indiquer une expiration du compte ou un dépassement du nombre de connexions simultanées incluses dans votre formule, un point détaillé sur notre page tarifs. Notre article dédié erreur d'authentification Xtream Codes détaille chaque code d'erreur et sa cause la plus probable.
En résumé
Xtream Codes est une méthode de connexion IPTV par API, qui repose sur trois champs (serveur, utilisateur, mot de passe) pour livrer un catalogue organisé en rubriques distinctes. Elle ne remplace pas techniquement le format M3U, mais offre une navigation plus structurée quand l'application la prend en charge. Consultez notre FAQ pour d'autres questions courantes sur la configuration.
Questions fréquentes
Qu'est-ce qu'une connexion Xtream Codes exactement ?
C'est une méthode de connexion structurée : votre application se connecte à un serveur via une API en utilisant une adresse de serveur, un nom d'utilisateur et un mot de passe, plutôt qu'une simple URL de playlist. L'application récupère ensuite le direct, la VOD et l'EPG de façon organisée.
Où trouver mes identifiants Xtream Codes ?
Ils sont généralement envoyés par email lors de l'activation de votre abonnement : une adresse de serveur (URL avec un numéro de port), un nom d'utilisateur et un mot de passe. Conservez cet email, vous en aurez besoin à chaque nouvelle installation.
Que signifie le numéro de port dans l'adresse du serveur ?
Le port fait partie de l'adresse réseau du serveur et indique sur quel canal spécifique se fait la connexion (souvent 80, 8080 ou un numéro personnalisé). Il doit être recopié exactement comme fourni, sans l'omettre ni le modifier.
Xtream Codes est-il plus fiable que M3U ?
Aucune des deux méthodes n'est intrinsèquement plus fiable : la stabilité dépend du serveur, du réseau et de l'application, pas du protocole de connexion. Xtream Codes propose surtout une organisation du catalogue plus structurée quand l'application le prend en charge.
Que faire si l'erreur d'authentification Xtream Codes apparaît ?
Vérifiez d'abord que le serveur, l'utilisateur et le mot de passe sont recopiés sans espace ni caractère invisible, en particulier sur mobile. Si l'erreur persiste, cela peut venir d'une expiration de compte ou d'un dépassement du nombre de connexions simultanées autorisées.
Peut-on utiliser Xtream Codes sans application dédiée ?
Certains lecteurs génériques peuvent parfois reconstituer une URL M3U équivalente à partir des identifiants Xtream Codes, mais l'usage prévu reste une application qui propose explicitement un écran de connexion « Xtream Codes API ».
