Xtream Codes est devenu le standard de fait des fournisseurs IPTV modernes — une seule URL donne accès aux chaînes, à l'EPG, à la VOD et aux séries en un bundle. Voici comment relier votre portail à OneTV Connect sur Apple TV en moins de deux minutes, plus la demi-douzaine de pièges qui font échouer la plupart des premières installations.
1 — Installer OneTV Connect
Ouvrez l'App Store sur votre Apple TV, recherchez OneTV Connect, installez. La version de base est gratuite et inclut la lecture IPTV complète — Pro n'est nécessaire que pour Plex, Sport Centre, Trakt et les thèmes. Connectez-vous à iCloud avant : toute playlist ajoutée sur Apple TV apparaîtra automatiquement sur iPhone et iPad.
2 — Ouvrir l'assistant Xtream
Depuis l'écran d'accueil, allez dans Réglages → Playlists → Ajouter une playlist → Xtream Codes. L'assistant Xtream dédié saute l'étape de parsing M3U et utilise directement l'API JSON du fournisseur, ce qui est plus rapide et donne une arborescence de catégories plus riche.
3 — Coller les identifiants du portail
Vous avez besoin de trois choses chez votre fournisseur : l'URL du portail (sans slash final, format http://host:port), votre identifiant et votre mot de passe. Collez-les, cliquez Valider. L'app ping le portail, récupère les infos utilisateur, et commence à indexer les chaînes en arrière-plan — typiquement 5 à 30 secondes pour une playlist de 5 000 chaînes.
4 — Vérifier l'EPG et la VOD
Une fois l'indexation terminée, ouvrez l'onglet Live — les programmes doivent apparaître à côté de chaque nom de chaîne. Si une chaîne affiche « Pas de programme », appui long et choisissez la bonne chaîne EPG dans la liste recherchable (le mapping est ensuite synchronisé via iCloud). VOD et séries sont dans leurs propres onglets et alimentés par le même endpoint Xtream, avec enrichissement TMDB qui tourne en arrière-plan dans les minutes qui suivent.
5 — Les pièges qu'aucun fournisseur ne mentionne
- Portails HTTPS avec certificat auto-signé qui échouent en silence. OneTV Connect gère ça en transparence via sa couche proxy pour MPV, mais VLC et KSPlayer peuvent encore erronner — basculez sur MPV dans Réglages → Lecteur si vous voyez des erreurs SSL.
- Le fournisseur bloque les user-agents « non-MAG ». Certains portails refusent le user agent par défaut d'Apple TV. Réglages → Lecteur → User-agent personnalisé permet de spoofer une chaîne VLC générique.
- La VOD renvoie HTTP 404. La plupart des endpoints VOD Xtream ne supportent pas les requêtes HTTP range. OneTV Connect détecte ça et désactive le seek — mais si vous voyez du 404 sur chaque lecture VOD, c'est un bug de routage du fournisseur ; demandez-lui d'activer le byte-range.
- EPG en retard d'un jour. Certains fournisseurs ne rafraîchissent leur XMLTV qu'à minuit UTC. Réglages → EPG → Rafraîchir maintenant force un re-fetch à la demande.
- Logos de chaînes manquants. Le fournisseur n'a pas rempli
tvg-logo. OneTV Connect bascule sur le logo de la chaîne EPG quand le logo M3U est vide — ajoutez une URL personnalisée dans le menu d'appui long si vous voulez un logo spécifique.
C'est tout. Ajouter un deuxième portail Xtream fonctionne pareil — les deux apparaîtront dans le sélecteur de playlist et vous basculez de l'un à l'autre en un geste. Besoin d'aide avec un fournisseur ou un message d'erreur précis ? La page de support contient la checklist de diagnostic complète.