Stalker Portal — aussi appelé « portail MAC » parce que chaque abonné est identifié par une adresse MAC — a été conçu pour les set-top boxes MAG d'Infomir (MAG250, MAG322, MAG420). C'est l'un des protocoles IPTV les plus courants en Europe de l'Est, au Moyen-Orient et en Asie. Jusqu'à récemment, faire tourner un portail Stalker sur Apple TV impliquait soit un jailbreak, soit du spoofing user-agent dans VLC, soit un EPG cassé. OneTV Connect implémente le protocole Stalker complet en natif. Voici comment l'utiliser.
Qu'est-ce qu'un portail Stalker ?
Un portail Stalker expose une API JSON sur /portal.php (ou /server/load.php sur les versions récentes). Il utilise l'authentification par adresse MAC, un token de session côté serveur, et sert chaînes en direct, VOD, séries, EPG et arborescence de catégories via le même endpoint. Comparé à Xtream Codes, c'est plus ancien et plus rigide — mais beaucoup de fournisseurs premium (notamment en Russie, Turquie, Grèce, Albanie, Iran) n'offrent que du Stalker.
Configurer votre portail dans OneTV Connect
Allez dans Réglages → Playlists → Ajouter une playlist → Portail MAC / Stalker. Trois choses à demander à votre fournisseur :
- L'URL du portail (juste le hôte, ex:
http://portal.example.com:8080). - Votre adresse MAC au format
XX:XX:XX:XX:XX:XX(12 caractères hex). La plupart des fournisseurs vous envoient un « 00:1A:79:XX:XX:XX » — c'est le préfixe Infomir, parfaitement normal. - La langue du portail (par défaut
en; certains portails russes nécessitentrupour l'ordre de chaînes correct).
L'assistant fait le handshake (handshake + get_profile), récupère la liste des chaînes, et démarre un watchdog qui ré-authentifie la session toutes les ~5 minutes. Le tout prend 5 à 10 secondes pour un portail de 1 000 chaînes.
Spoofing d'adresse MAC — bien fait
La MAC est votre identifiant — elle doit être unique par abonné. Certains fournisseurs vous laissent la changer depuis un dashboard client ; d'autres la verrouillent après la première connexion. Si vous avez déjà activé la MAC sur une vraie box MAG, OneTV Connect peut prendre le relais uniquement si vous arrêtez d'utiliser la box d'abord — la plupart des portails imposent une session active par MAC. L'app envoie exactement le même User-Agent qu'une MAG250 (Mozilla/5.0 (QtEmbedded; …) MAG200 stbapp ver: 2 rev: 250 Safari/533.3) pour que le portail ne puisse pas faire la différence.
Routage CDN et TTL des play_token
C'est ici que la plupart des apps IPTV génériques échouent avec Stalker. Le portail retourne une URL de stream qui pointe sur un load balancer CDN, avec un play_token à usage unique qui expire en ~5 secondes. Le DNS de ce hôte CDN est souvent périmé — l'IP résolue ne répond plus. La solution OneTV Connect : toujours réécrire l'URL de stream via le hostname du portail, puis laisser le portail faire un 302 vers le CDN actif. Trois hops (portail → load balancer → CDN final), tous via redirections HTTP natives, sans config supplémentaire de votre part.
Diagnostic des erreurs les plus courantes
- « Authorization failed » à la première connexion. Mauvais format de MAC, ou la MAC n'est pas whitelistée par votre fournisseur. Vérifiez la casse — la plupart des portails sont sensibles à la casse. Envoyez la MAC à votre fournisseur exactement comme elle apparaît dans vos réglages.
- Les chaînes chargent mais la lecture renvoie HTTP 401. La session du portail a expiré — OneTV Connect devrait re-rafraîchir automatiquement, mais si le portail a un verrouillage de session agressif, forcez une reconnexion via Réglages → Playlist → Reconnecter.
- Boucles « play_token expired ». Le portail régénère le token à chaque play. L'app gère ça automatiquement en re-résolvant l'URL à chaque changement de chaîne. Si vous voyez ça dans les logs, vous avez peut-être une vieille URL résolue en cache — appui long sur la chaîne et choisissez « Reset URL en cache ».
- La VOD démarre mais s'arrête à 5 secondes. Les endpoints VOD Stalker ne supportent pas les requêtes range. OneTV Connect détecte ça et désactive le seek. Si vous avez absolument besoin du seek sur la VOD Stalker, basculez le lecteur sur MPV avec
seekable=0— couvert automatiquement dans l'app. - EPG vide. L'EPG Stalker (
get_short_epg) est récupéré à la demande, chaîne par chaîne — il ne pré-remplit pas toute la grille 7 jours. Ouvrez une chaîne et l'EPG apparaît en moins d'une seconde.
Stalker est fragile par design — conçu pour des set-top boxes à 40 €, pas pour des apps modernes. L'approche OneTV Connect est de se comporter exactement comme un iSTB (le client officiel Infomir) au niveau du protocole, ce qui évite 90 % des edge cases sur lesquels les autres apps trébuchent. Si votre fournisseur supporte Stalker, vous pouvez arrêter de chercher des apps « émulateur MAG » ; ça marche dès le premier jour.