Configurer un lecteur IPTV avec Xtream Codes

Le protocole Xtream Codes est l'une des méthodes les plus populaires pour configurer un lecteur IPTV. Ce guide technique explique comment fonctionne ce protocole et comment le configurer correctement.

Qu'est-ce que Xtream Codes ?

Xtream Codes est une API standardisée qui permet aux lecteurs IPTV de communiquer avec des serveurs pour récupérer :

• La liste des chaînes disponibles
• Les flux vidéo en direct
• Le guide EPG (Electronic Program Guide)
• Les contenus VOD (Video On Demand)

Structure de l'URL serveur

Format standard

Une URL Xtream Codes suit cette structure :

http://serveur.exemple.com:8080

Ou avec HTTPS :

https://serveur.exemple.com:8080

Décomposition technique

Protocole : http:// ou https://

• HTTP : Non chiffré (port 80 par défaut)
• HTTPS : Chiffré avec SSL/TLS (port 443 par défaut)

Domaine : serveur.exemple.com

• Peut être un nom de domaine
• Ou une adresse IP : 192.168.1.100

Port : :8080

• Port de communication
• Ports courants : 8080, 25461, 2082, 2052
• Obligatoire si différent du port par défaut

Logique des ports

Ports standards

Les serveurs Xtream Codes utilisent généralement des ports spécifiques :

Port 8080  : Le plus courant (HTTP)
Port 25461 : Alternative populaire
Port 2082  : Utilisé avec cPanel
Port 2052  : Variante moins commune
Port 80    : HTTP standard (rare)
Port 443   : HTTPS standard (rare)

Pourquoi des ports non-standards ?

1. Éviter les conflits : Le port 80 est souvent utilisé par d'autres services
2. Configuration serveur : Facilite la gestion multi-services
3. Routage réseau : Simplifie les règles de pare-feu

Authentification

Identifiants requis

Trois éléments sont nécessaires :

1. URL du serveur : http://serveur.exemple.com:8080
2. Nom d'utilisateur : username123
3. Mot de passe : password456

Validation des identifiants

Les identifiants peuvent contenir :

• Lettres (majuscules et minuscules)
• Chiffres
• Caractères spéciaux (selon le serveur)

Attention :

• Respectez la casse (majuscules/minuscules)
• Pas d'espaces avant ou après
• Copiez-collez pour éviter les erreurs de frappe

Configuration dans un lecteur

Exemple avec IPTV Smarters Pro

1. Ouvrir l'application
2. Sélectionner "Login with Xtream Codes API"
3. Remplir les champs :

Nom du profil : Mon IPTV
Serveur URL   : http://serveur.exemple.com:8080
Username      : username123
Password      : password456

1. Cliquer sur "Add User"

Exemple avec TiviMate

1. Aller dans les paramètres
2. Sélectionner "Add Playlist"
3. Choisir "Xtream Codes"
4. Entrer les informations :

Name     : Mon service
URL      : http://serveur.exemple.com:8080
Username : username123
Password : password456

1. Valider et attendre la synchronisation

Exemple avec Perfect Player

1. Ouvrir les paramètres (⚙️)
2. "General" → "Playlists"
3. Cliquer sur "+" pour ajouter
4. Sélectionner "Xtream Codes"
5. Compléter :

Name     : Mon IPTV
Server   : http://serveur.exemple.com:8080
Username : username123
Password : password456

Erreurs DNS & Host

Erreur : "Unable to resolve host"

Cette erreur signifie que votre appareil ne peut pas convertir le nom de domaine en adresse IP.

Causes possibles :

1. Problème DNS
2. Domaine incorrect
3. Pas de connexion Internet
4. Serveur DNS bloqué

Solutions :

1. Vérifier l'orthographe du domaine
2. Tester la connexion Internet
3. Changer de DNS (8.8.8.8 ou 1.1.1.1)
4. Essayer avec l'IP directe si disponible

Erreur : "Connection timed out"

Le serveur ne répond pas dans le délai imparti.

Causes :

• Serveur hors ligne
• Mauvais port
• Pare-feu bloquant
• Problème réseau

Diagnostic :

# Test de connexion (depuis un PC)
ping serveur.exemple.com
telnet serveur.exemple.com 8080

Erreur : "Authentication failed"

Les identifiants sont incorrects ou expirés.

Vérifications :

1. Username correct (respectez la casse)
2. Password correct (pas d'espaces)
3. Compte actif et non expiré
4. URL du serveur correcte

Endpoints API Xtream Codes

Structure des appels API

Le protocole Xtream Codes utilise plusieurs endpoints :

Player API :

http://serveur:port/player_api.php?username=X&password=Y

Liste des chaînes live :

http://serveur:port/player_api.php?username=X&password=Y&action=get_live_streams

EPG :

http://serveur:port/player_api.php?username=X&password=Y&action=get_simple_data_table&stream_id=Z

VOD :

http://serveur:port/player_api.php?username=X&password=Y&action=get_vod_streams

Flux vidéo

Format URL d'un flux :

http://serveur:port/live/username/password/streamID.ts

Exemple :

http://serveur.exemple.com:8080/live/username123/password456/1234.ts

Optimisation de la configuration

Cache et performances

Certains lecteurs permettent d'ajuster :

• Durée du cache : Temps de mise en cache des données
• Préchargement : Charger les infos à l'avance
• Rafraîchissement : Fréquence de mise à jour

Recommandations :

Cache EPG      : 24 heures
Cache liste    : 6 heures
Timeout        : 15 secondes

Réseau

Pour une connexion stable :

1. Privilégier Ethernet plutôt que Wi-Fi
2. Tester la latence : Ping < 50ms idéal
3. Vérifier la bande passante : > 10 Mbps pour HD
4. Éviter les heures de pointe si possible

Sécurité

HTTPS vs HTTP

HTTP (non chiffré) :

• Moins sécurisé
• Plus rapide
• Compatible partout

HTTPS (chiffré) :

• Plus sécurisé
• Légèrement plus lent
• Certificat SSL requis côté serveur

Protection des identifiants

Bonnes pratiques :

• Ne partagez jamais vos identifiants
• Changez le mot de passe régulièrement
• N'utilisez qu'un seul appareil à la fois (selon limitation serveur)
• Déconnectez-vous des appareils non utilisés

Troubleshooting avancé

Test manuel de connexion

Vous pouvez tester votre configuration avec un navigateur :

http://serveur:port/player_api.php?username=VOTRE_USER&password=VOTRE_PASS

Réponse attendue : JSON avec informations serveur

{
  "user_info": {
    "username": "username123",
    "status": "Active",
    "exp_date": "1735689600"
  },
  "server_info": {
    "url": "serveur.exemple.com",
    "port": "8080"
  }
}

Erreurs courantes et solutions

Comparaison avec M3U

Xtream Codes

Avantages :

• API structurée et standard
• Mises à jour automatiques
• EPG intégré
• Gestion des catégories
• VOD supporté

Inconvénients :

• Nécessite authentification
• Dépend du serveur
• Pas de backup local facile

M3U

Avantages :

• Simple à comprendre
• Peut être local
• Pas d'authentification complexe
• Éditable manuellement

Inconvénients :

• Mise à jour manuelle
• EPG séparé
• Moins structuré

Conclusion

La configuration Xtream Codes est technique mais suit une logique claire. Les erreurs les plus courantes viennent d'une mauvaise saisie de l'URL ou des identifiants.

Points clés :

• Vérifiez trois fois vos identifiants
• Le port est souvent la source d'erreurs
• Testez votre connexion Internet
• Privilégiez HTTPS quand disponible

Avec une configuration correcte, Xtream Codes offre une expérience stable et complète pour l'IPTV.