Documentation du pont M3U

1. Pour commencer

M3U Bridge agit comme un proxy intelligent et une couche de normalisation entre vos sources multimédias autorisées (codes M3U ou Xtream) et vos applications de lecture IPTV (telles que TiviMate, IPTV Smarters, Apple TV ou applications Android TV).

2. Ajouter une source

Depuis le tableau de bord de votre locataire sur app.m3ubridge.com, accédez à Sources et cliquez sur Add Source. Vous pouvez configurer soit une URL de playlist M3U, soit un point de terminaison de serveur compatible Xtream. Les identifiants amont sont chiffrés au repos avec AES-256-GCM.

3. Entrée M3U

M3U Bridge prend en charge les listes de lecture M3U et M3U8 standard (y compris les balises EXTINF, tvg-id, tvg-name, tvg-logo et group-title). L'analyseur gère les listes de lecture volumineuses de plusieurs mégaoctets grâce au découpage en segments et à la synchronisation périodique en arrière-plan.

4. Entrée compatible Xtream

Si votre fournisseur d'accès utilise le protocole Xtream Codes, saisissez l'URL de base de votre serveur, votre nom d'utilisateur et votre mot de passe. M3U Bridge synchronise les flux en direct, les films à la demande, les séries TV et les catégories via le protocole standard player_api.php.

5. Identifiants générés

Au lieu de saisir les informations du serveur en amont dans chaque lecteur, créez des lignes d'abonné dédiées dans votre tableau de bord :

• URL du serveur : https://live.m3ubridge.com
• Nom d'utilisateur : Nom d'utilisateur personnalisé généré par utilisateur/appareil
• Mot de passe : Mot de passe sécurisé avec vérification Argon2id
• Nombre maximal de connexions : Limites de concurrence appliquées par abonné

Votre tableau de bord affiche les URL exactes à coller dans votre lecteur, construites à partir de l'adresse du serveur ci-dessus et du nom d'utilisateur/mot de passe générés pour chaque ligne d'abonné :

• player_api.php — Endpoint d'authentification et d'API Xtream Codes utilisé par les applications compatibles Xtream (p. ex. TiviMate, IPTV Smarters) pour lister les flux en direct, la VOD, les séries et les catégories.
• get.php — Endpoint de playlist M3U pour les lecteurs qui ne prennent en charge que le format classique M3U/M3U8 à la place de l'API Xtream.
• xmltv.php — Endpoint du guide électronique des programmes XMLTV (EPG), mis en correspondance et normalisé automatiquement par M3U Bridge.

6. Correspondance EPG

M3U Bridge associe automatiquement les chaînes compatibles aux sources de données EPG disponibles (sous licence ou fournies par le client) afin de résoudre les problèmes d'identifiants de guide des programmes manquants ou incohérents. Son moteur de normalisation prend en charge les grilles de programmes gérées, les entrées XMLTV des clients et les futurs fournisseurs de guides.

7. Enrichissement des métadonnées

Les titres des films et des séries sont comparés à la base de données The Movie Database (TMDB) pour récupérer des affiches haute résolution, des arrière-plans, des résumés d'intrigue, des années de sortie, des distributions et des listes d'épisodes sans exposer votre infrastructure privée.

8. Modes de passerelle

Le pont M3U prend en charge le mode de redirection directe et le mode de relais technique protégé, selon les contraintes de sécurité du serveur en amont et les exigences de protection des identifiants. En mode protégé, le trafic réseau est relayé temporairement afin de masquer les identifiants du serveur en amont et de maintenir la connectivité.

La capacité et les quotas de trafic des relais protégés sont définis séparément des limites de compte et d'utilisateur et peuvent évoluer pendant l'accès anticipé.

9. Foire aux questions