M3U-Bridge-Dokumentation

1. Erste Schritte

Die M3U Bridge fungiert als intelligenter Proxy und Normalisierungsschicht zwischen Ihren autorisierten Medienquellen (M3U- oder Xtream-Codes) und Ihren IPTV-Wiedergabeanwendungen (wie TiviMate, IPTV Smarters, Apple TV oder Android TV-Apps).

2. Eine Quelle hinzufügen

Navigieren Sie in Ihrem Mandanten-Dashboard unter app.m3ubridge.com zu Sources und klicken Sie auf Add Source. Sie können entweder eine M3U-Playlist-URL oder einen Xtream-kompatiblen Serverendpunkt konfigurieren. Die Upstream-Zugangsdaten werden im Ruhezustand mit AES-256-GCM verschlüsselt.

3. M3U-Eingang

M3U Bridge unterstützt Standard-M3U- und M3U8-Wiedergabelisten (einschließlich EXTINF-Tags, tvg-id, tvg-name, tvg-logo und Gruppentitel). Der Parser verarbeitet große Wiedergabelisten im Multi-Megabyte-Bereich mit Streaming-Chunking und regelmäßiger Hintergrundsynchronisierung.

4. Xtream-kompatibler Eingang

Wenn Ihr Upstream-Provider das Xtream-Codes-Protokoll verwendet, geben Sie Ihre Server-Basis-URL, Ihren Benutzernamen und Ihr Passwort ein. M3U Bridge synchronisiert Live-Streams, VOD-Filme, Fernsehserien und Kategorien über das Standardprotokoll player_api.php.

5. Generierte Anmeldeinformationen

Anstatt die Details des Upstream-Servers in jedem Player einzugeben, erstellen Sie dedizierte Abonnentenzeilen in Ihrem Dashboard:

• Server-URL: https://live.m3ubridge.com
• Benutzername: Benutzerdefinierter Benutzername, der pro Benutzer/Gerät generiert wird
• Passwort: Sicheres Passwort mit Argon2id-Verifizierung
• Max Verbindungen: Gleichzeitigkeitsbeschränkungen pro Abonnent

Ihr Dashboard zeigt die genauen URLs, die Sie in Ihren Player einfügen können. Sie werden aus der oben genannten Serveradresse und dem generierten Benutzernamen/Passwort für jede Abonnentenzeile erstellt:

• player_api.php — Xtream-Codes-Authentifizierungs- und API-Endpunkt, den Xtream-kompatible Apps (z. B. TiviMate, IPTV Smarters) verwenden, um Live-Streams, VOD, Serien und Kategorien aufzulisten.
• get.php — M3U-Playlist-Endpunkt für Player, die nur das klassische M3U/M3U8-Format statt der Xtream-API unterstützen.
• xmltv.php — XMLTV-Endpunkt für den elektronischen Programmführer (EPG), der von M3U Bridge automatisch zugeordnet und normalisiert wird.

6. EPG-Abgleich

M3U Bridge gleicht automatisch kompatible Kanäle mit verfügbaren lizenzierten oder vom Kunden bereitgestellten EPG-Datenquellen ab, um fehlende oder inkonsistente Programmführerkennungen zu beheben. Die Normalisierungs-Engine unterstützt verwaltete Sendepläne, kundeneigene XMLTV-Eingaben und zukünftige Programmführeranbieter.

7. Metadatenanreicherung

Film- und Serientitel werden mit der Movie Database (TMDB) abgeglichen, um hochauflösende Poster, Hintergründe, Inhaltsangaben, Erscheinungsjahre, Besetzungslisten und Episodenlisten abzurufen, ohne Ihre private Infrastruktur preiszugeben.

8. Gateway-Modi

Die M3U Bridge unterstützt je nach Sicherheitsanforderungen des Upstream-Servers und den Anforderungen an den Schutz der Anmeldeinformationen sowohl den Direktumleitungsmodus als auch den geschützten technischen Relay-Modus. Im geschützten Modus wird der Netzwerkverkehr vorübergehend umgeleitet, um die Anmeldeinformationen des Upstream-Servers zu schützen und die Verbindung aufrechtzuerhalten.

Die Kapazität und die Verkehrszulagen des geschützten Relays werden getrennt von den Konto- und Benutzerlimits definiert und können sich während der Early-Access-Phase ändern.

9. Häufig gestellte Fragen