Wenn dein IPTV-Anbieter dir einen Xtream-Login geschickt hat (Server, Benutzername, Passwort), der Player aber nur eine einzige M3U-URL akzeptiert — oder umgekehrt — sitzt du nicht fest. Beides ist dasselbe. Darunter ist ein Xtream-Login nur eine aufgeräumte Art, alles zu notieren, was eine M3U-URL ohnehin enthält.

Dieser Guide erklärt die Umwandlung in beide Richtungen, worauf du achten musst, und wie du es tust, ohne deine Zugangsdaten irgendwo einzutippen, wo Fremde sie mitlesen können. Der Xtream-↔-M3U-URL-Konverter auf dieser Seite macht die Umwandlung komplett im Browser — hinter der Seite gibt es keinen Server-Endpunkt.

Drei beschriftete Chips — Server, Benutzername, Passwort — oben, mit farbigen Impulsen, die nach unten in die entsprechenden Teile der get.php-URL-Formel tropfen.

Die M3U-URL ist eine feste Vorlage; ein Xtream-Login ist einfach die drei Zugangsdaten, die in diese Vorlage gesteckt werden.

Warum die Umwandlung überhaupt ein Thema ist

Derselbe Anbieter unterstützt fast immer beide Formen, aber der Player, den du installierst, fragt nur eine davon ab. Apps unterscheiden sich in einigen konkreten Punkten:

  • Alte, reine M3U-Player (VLC, einfache Smart-TV-Apps, dedizierte IPTV-Boxen) nehmen eine einzige URL. Sie kennen die Xtream-API-Endpunkte nicht; sie laden eine flache Playlist-Datei und spielen Streams daraus.
  • Xtream-fähige Player (die meisten modernen IPTV-Apps, einschließlich Klipa) bevorzugen das Zugangsdaten-Trio. Sie nutzen es, um Live-Senderliste, VOD-Bibliothek, Serien-Katalog und EPG als separate Dokumente abzurufen — schönere Kategorisierung, dynamische Aktualisierung, On-Demand-Bereiche, die der M3U-Export nicht abbilden kann.

Wenn dein Anbieter dir die eine Form gegeben hat und dein Player die andere will, ist die Umwandlung eine 30-Sekunden-Sache. Du musst beim Anbieter nicht „das andere Format" anfragen — er liefert dir bereits beide, nur in einer Schreibweise.

Die Xtream-zu-M3U-Formel

Jeder Xtream-Anbieter nutzt dieselbe URL-Vorlage. Wenn du sie kennst, kannst du die M3U-URL aus den Zugangsdaten von Hand bauen:

http://<server>:<port>/get.php?username=<USERNAME>&password=<PASSWORD>&type=m3u_plus&output=mpegts

Drei konkrete Beispiele mit den Zugangsdaten server: http://server.example:8080, username: ABC, password: XYZ:

M3U:        http://server.example:8080/get.php?username=ABC&password=XYZ&type=m3u_plus&output=mpegts
EPG:        http://server.example:8080/xmltv.php?username=ABC&password=XYZ
player_api: http://server.example:8080/player_api.php?username=ABC&password=XYZ

Die Bestandteile:

  • get.php ist der Playlist-Endpunkt. Heißt immer get.php — es gibt hier keine anbieterspezifische Namensgebung.
  • type=m3u_plus fordert das erweiterte M3U-Format an, das Senderlogos und Gruppentitel enthält. Reines type=m3u funktioniert auch, liefert aber eine schlankere Playlist; du willst fast immer m3u_plus.
  • output=mpegts fordert Streams an, die als rohes MPEG-TS laufen. Die andere übliche Option ist output=hls, was HLS-URLs (.m3u8) liefert — nützlich für Browser und manche Apple-Geräte, weniger universell auf TV-Boxen. Zickt dein Player, ist das Umschalten von output das Erste, was du probieren solltest.
  • xmltv.php ist der EPG-Endpunkt. Dieselben Zugangsdaten, separates Dokument. Die meisten Player nehmen diese URL in einem anderen Feld an („EPG-URL" oder „XMLTV-URL").
  • player_api.php ist die JSON-API. Player, die „Xtream nativ sprechen", nutzen sie, um Live-/VOD-/Serien-Bäume und Senderlogos zu bekommen.

Andersherum: Zugangsdaten aus einer M3U-URL extrahieren

Gegeben eine M3U-URL, die nach der Formel oben aussieht, kannst du die drei Xtream-Felder direkt wieder herauslesen:

http://server.example:8080/get.php?username=ABC&password=XYZ&type=m3u_plus
                                            └────┘          └────┘
                                          username        password
  • Server ist alles vor dem ersten Schrägstrich nach dem Host: http://server.example:8080. Den Teil /get.php und alles dahinter abschneiden.
  • Benutzername ist der Wert des Query-Parameters username.
  • Passwort ist der Wert des Query-Parameters password.

Fehlt ein Query-Parameter, ist die URL nicht im Standard-Xtream-Format. Manche Anbieter liefern reine M3U-URLs, in denen gar keine Zugangsdaten stehen — typischerweise statische oder token-basierte Playlists, bei denen die URL selbst das Geheimnis ist. Daraus gibt es nichts zu extrahieren; du nutzt die URL einfach unverändert in jedem M3U-fähigen Player.

Typische Stolpersteine

Ein paar Details stolpern Leute regelmäßig.

URL-Kodierung von Sonderzeichen

Wenn dein Passwort Zeichen wie &, =, +, #, % oder / enthält, müssen die in der URL prozent-kodiert werden. Ein literales & mitten im Passwort macht das URL-Parsen kaputt — der Player würde alles dahinter als separaten Query-Parameter behandeln.

Die meisten Anbieter-Panels machen das für dich. Wenn du die URL von Hand baust und im Passwort etwas Komisches steckt, jag das Passwort vorher durch ein beliebiges „URL encode"-Tool. Oder spar dir das ganz und lass den Browser-Konverter das erledigen.

Der Port

Xtream-Anbieter laufen sehr selten auf den Standardports 80 oder 443. Üblich sind 8080, 25461, 8000 oder ein zufälliger hoher Port. Der Port gehört zur Server-URL und ist nicht optional. Siehst du http://server.example/get.php?… ohne Port, läuft es entweder auf Port 80 (selten) oder der Anbieter hat einen Reverse-Proxy davor (auch selten). Meistens fehlt der Port einfach, weil jemand die URL von Hand kopiert und ihn weggelassen hat.

http vs. https

Die meisten Xtream-Anbieter liefern HTTP, nicht HTTPS. Die https://-Form gibt oft einen Zertifikatsfehler oder einen 404 zurück, weil der Server überhaupt kein TLS bindet. Wurde dir eine Server-URL mit https:// gegeben, die nicht läuft, probier reines http://. Der Preis: Dein Passwort reist jetzt unverschlüsselt; das ist bei IPTV-Anbietern leider die Norm.

Eigener Pfad in der M3U-URL

Manche Anbieter passen ihr Routing an — statt /get.php siehst du /playlist.m3u, /m3u.php oder sogar /index.php?type=m3u. Die Zugangsdaten in diesen URLs passen weiterhin zu dem, was die Xtream-API erwartet, der Konverter extrahiert sie also korrekt — aber die Playlist-URL, die der Anbieter verwendet, ist nicht standardisiert. Wenn du eine eigene M3U-URL über den Standardpfad /get.php baust, lehnt der Anbieter sie möglicherweise ab. In solchen Fällen die Original-URL des Anbieters behalten — nicht „korrigieren".

Leerzeichen am Ende der Zugangsdaten

Beim Einfügen aus E-Mails oder Forenbeiträgen schleppt sich regelmäßig ein unsichtbares Leerzeichen, ein Zeilenumbruch oder ein geschütztes Leerzeichen an den Benutzernamen. Die Xtream-API behandelt ABC und ABC als verschiedene Benutzernamen; du bekommst eine „Authentifizierung fehlgeschlagen"-Antwort, die genau wie ein falsches Passwort aussieht. Der Konverter trimmt Whitespace beim Benutzernamen automatisch und warnt, wenn er das musste. Wenn du die URL von Hand baust, jedes Feld zuerst in einen reinen Texteditor einfügen und das Ende mit dem Auge prüfen.

Die Umwandlung sicher durchführen

Mehrere Websites bieten diese Umwandlung online an. Die meisten sind in Ordnung; einige sind zwielichtig. Das Risiko ist einfach — Zugangsdaten, die in das Formular eines Fremden eingegeben werden, können geloggt, abgegriffen oder wiederverwendet werden. Selbst ein redlicher Betreiber ohne böse Absicht hat Access-Logs.

Der Konverter auf dieser Seite ist so gebaut, dass er gar keine Access-Logs über deine Zugangsdaten haben kann, weil dahinter kein Server-Endpunkt steht. Die Umwandlung läuft komplett im Browser als JavaScript. Die Zugangsdaten leben in DOM-Eingabeelementen, bis du die Seite schließt; sie stehen nicht in der Adresszeile, nicht im localStorage und werden nirgendwohin geschickt. Öffnest du während einer Umwandlung den Netzwerk-Tab des Browsers, siehst du exakt null ausgehende Anfragen mit den Zugangsdaten.

Das ist der Maßstab, den du von jedem Tool erwarten solltest, das nach IPTV-Zugangsdaten fragt. Wenn die Oberfläche eines Konverters beim Klick auf „Umwandeln" eine Netzwerkanfrage stellt, hat sie per Definition deine Zugangsdaten irgendwohin übertragen.

Nach der Umwandlung: prüfen, bevor du importierst

Eine erfolgreich gebaute URL ist noch keine funktionierende URL. Beide Umwandlungsrichtungen sind deterministische String-Transformationen — als Transformationen korrekt, sagen aber nichts darüber aus, ob die Zugangsdaten gültig sind, das Abo aktuell ist oder der Server erreichbar ist.

Zwei günstige Checks, bevor du dich auf den Import einlässt:

  • Für M3U-URLs das Ergebnis in den M3U-Playlist-Tester einfügen. Er holt die Playlist, parst sie und prüft die ersten 100 Streams. Alles grün heißt: URL ist gut; alles rot zeigt dir den konkreten Fehler (HTML-Antwort, 404, tote Streams).
  • Für Xtream-Zugangsdaten das Trio in den Xtream-Zugangsdaten-Prüfer einfügen. Er ruft die API serverseitig auf und liefert Auth-Status, Ablaufdatum, Verbindungslimit und Senderanzahl. Unterscheidet „falsches Passwort" von „abgelaufenes Abo" von „Server nicht erreichbar".

Einen dieser Checks zu fahren, bevor du dich überhaupt mit einem Player herumschlägst, spart etwa zwanzig Minuten Debugging, falls etwas mit den Zugangsdaten selbst nicht stimmt.

Wenn die M3U-URL keine Zugangsdaten enthält

Ein kleiner Teil der M3U-URLs, die dir begegnen, sind gar kein Xtream. Es sind flache Playlists auf einem statischen Server oder Token-URLs, bei denen das Geheimnis im Pfad statt im Query-String steckt:

https://server.example/playlists/9c1f4a8b3e/stream.m3u8

Da gibt es nichts zu extrahieren — die URL selbst ist die Zugangsdaten. Solche URLs funktionieren in reinen M3U-Playern unverändert. Sie haben keine Xtream-äquivalente Form, weil sie nicht vom Xtream-Codes-Panel erzeugt werden; sie kommen aus einem anderen (älteren) IPTV-Stack. Wenn dein Anbieter dir nur das gegeben hat und dein Player auf Xtream-Zugangsdaten besteht, hat dein Anbieter keinen Xtream-Login zu geben. Frag beim Anbieter nach oder wähle einen Player, der M3U-URLs akzeptiert.

So sieht das in Klipa aus

Klipa akzeptiert beide Formen nebeneinander in derselben Bibliothek. Du kannst eine M3U-URL und einen Xtream-Login desselben Anbieters als separate Quellen hinzufügen; die App nutzt jeweils, was gerade gesund ist. Liefert der M3U-Export eines Tages HTML, hält der Xtream-API-Aufruf deine Senderliste bis zur nächsten Aktualisierung am Leben — und umgekehrt.

Das ist die einfache Antwort auf „welches Format soll ich nehmen" — beide. Wenn du nur eines wählen willst, geht der Xtream-vs.-M3U-Vergleich durch, wann du womit anfängst.