M3U Playlist Format — Vollständiger Leitfaden
Was ist eine M3U-Datei?
M3U steht für MP3 URL und ist ein Dateiformat, das ursprünglich von Winamp in den späten 1990er-Jahren entwickelt wurde. Heute ist es weit über MP3 hinausgewachsen und der De-facto-Standard für die Organisation von Medien-Streams — insbesondere im IPTV-Bereich.
Eine M3U-Datei ist im Kern eine einfache Textdatei, die eine Liste von URLs enthält. Jede URL verweist auf einen Medien-Stream oder eine Mediendatei. Öffnet man diese Datei mit einem kompatiblen Player, werden die darin aufgelisteten Medien der Reihe nach oder nach Auswahl abgespielt.
Aufbau einer M3U-Datei
Einfaches M3U
Die einfachste Form einer M3U-Datei ist nichts weiter als eine Liste von URLs, eine pro Zeile:
http://example.com/stream1.ts
http://example.com/stream2.ts
http://example.com/stream3.tsExtended M3U (EXTM3U)
Die erweiterte Variante — erkennbar am Header #EXTM3U — enthält zusätzliche Metadaten zu jedem Eintrag. Dies ist das Format, das im IPTV-Bereich fast ausschließlich verwendet wird:
#EXTM3U
#EXTINF:-1 tvg-id="das-erste.de" tvg-name="Das Erste" tvg-logo="https://example.com/logo.png" group-title="Deutschland",Das Erste HD
http://example.com/daserstehd.ts
#EXTINF:-1 tvg-id="zdf.de" tvg-name="ZDF" tvg-logo="https://example.com/zdf.png" group-title="Deutschland",ZDF HD
http://example.com/zdfhd.tsDie wichtigsten Felder im Detail
#EXTM3U — Der Datei-Header
Die erste Zeile einer Extended M3U-Datei ist immer #EXTM3U. Dieser Header signalisiert dem Player, dass es sich um eine erweiterte Playlist mit Metadaten handelt. Ohne diesen Header werden die Zusatzinformationen möglicherweise ignoriert.
#EXTINF — Die Eintrags-Definition
Jede Zeile, die mit #EXTINF: beginnt, definiert einen neuen Eintrag. Das Format:
#EXTINF:<Dauer> <Attribute>,<Anzeigename>
<URL>- Dauer: Bei Live-Streams üblicherweise
-1(unbekannte Dauer) - Attribute: Schlüssel-Wert-Paare in Anführungszeichen
- Anzeigename: Der Text nach dem Komma — wird dem Nutzer im Player angezeigt
Gängige Attribute
| Attribut | Beschreibung | Beispiel |
|---|---|---|
tvg-id | Eindeutige Kanal-ID für EPG-Zuordnung | "das-erste.de" |
tvg-name | Technischer Kanalname | "Das Erste" |
tvg-logo | URL zum Kanal-Logo (Bild) | "https://example.com/logo.png" |
group-title | Gruppenname zur Kategorisierung | "Deutschland" |
tvg-language | Sprache des Kanals | "German" |
tvg-country | Ländercode des Kanals | "DE" |
Gruppen
Das Attribut group-title ist besonders wichtig für die Organisation. Es ermöglicht die Kategorisierung von Kanälen in Gruppen wie Länder, Genres oder Sprachen. In einem Editor kannst du nach Gruppen filtern und Kanäle zwischen Gruppen verschieben.
M3U vs. M3U8 — Was ist der Unterschied?
Die Begriffe M3U und M3U8 werden oft synonym verwendet, es gibt aber einen wichtigen technischen Unterschied:
| Eigenschaft | M3U | M3U8 |
|---|---|---|
| Zeichenkodierung | ASCII / Latin-1 | UTF-8 |
| Internationale Zeichen | Eingeschränkt | Vollständige Unterstützung |
| Verbreitung | Ältere Systeme | Moderner Standard |
| HLS-Streaming | Selten verwendet | Standard bei Apple HLS |
M3U8 ist im Grunde eine M3U-Datei mit UTF-8-Kodierung. Das bedeutet, dass Sonderzeichen wie Umlaute (ä, ö, ü), kyrillische Buchstaben oder arabische Schriftzeichen korrekt dargestellt werden.
Im IPTV-Kontext verwenden die meisten Provider heute M3U8, auch wenn die Dateiendung oft noch .m3u lautet. Der M3U Playlist Editor verarbeitet beide Formate gleichermaßen.
Häufige Probleme mit M3U-Dateien
Zeichenkodierung
Das häufigste Problem: Sonderzeichen werden als kryptische Zeichen dargestellt (z.B. ä statt ä). Ursache ist meist eine falsche Kodierung. Lösung: Die Datei sollte immer als UTF-8 gespeichert werden.
Fehlende oder fehlerhafte Header
Ohne den #EXTM3U-Header am Anfang erkennen manche Player die Metadaten nicht. Die Kanäle werden dann zwar abgespielt, aber ohne Namen, Logos oder Gruppen.
Ungültige URLs
Streams können aus verschiedenen Gründen nicht mehr erreichbar sein — der Server wurde abgeschaltet, die URL hat sich geändert oder der Stream wurde auf eine andere Adresse umgezogen. Im M3U Playlist Editor kannst du mit der Stream-Check-Funktion alle URLs auf Erreichbarkeit prüfen.
Zu große Dateien
Playlists mit hunderttausenden Einträgen können in einfachen Texteditoren Probleme verursachen. Der M3U Playlist Editor ist speziell für solche Größenordnungen optimiert und verarbeitet Playlists mit über 300.000 Einträgen performant.
M3U-Dateien bearbeiten
Mit einem Texteditor
Da M3U-Dateien reiner Text sind, kann man sie theoretisch mit jedem Texteditor (Notepad, VS Code etc.) bearbeiten. Das funktioniert bei kleinen Playlists, wird aber bei größeren schnell unübersichtlich und fehleranfällig.
Mit dem M3U Playlist Editor
Der komfortablere Weg ist ein spezialisierter Editor. Im M3U Playlist Editor importierst du deine Playlist auf dem Dashboard — entweder als Datei-Upload oder per URL. Danach stehen dir alle Bearbeitungsfunktionen zur Verfügung:
- Drag & Drop zum Umsortieren
- Gruppenfilter in der Seitenleiste
- Suche nach Kanalnamen oder URLs
- Massenbearbeitung für mehrere Kanäle gleichzeitig
- Duplikaterkennung zum Finden doppelter Einträge
Best Practices
- Immer UTF-8 verwenden — vermeidet Zeichenprobleme
- Gruppen konsequent benennen — erleichtert die Navigation
- EPG-IDs pflegen — ermöglicht die Zuordnung zur Fernsehzeitung
- Regelmäßig Stream Check durchführen — hält die Playlist aktuell
- Backups anlegen — vor größeren Änderungen die Playlist sichern
Fazit
Das M3U-Format ist trotz seines Alters der unangefochtene Standard für IPTV-Playlists. Die einfache Textstruktur macht es universell kompatibel, die erweiterten Attribute ermöglichen eine professionelle Organisation. Mit dem richtigen Editor wird die Verwaltung auch großer Playlists zum Kinderspiel.