Konfiguration
Struktur einer M3U-Datei: Anatomie einer IPTV-Playlist
M3U-Datei verstehen: Aufbau einer IPTV-Playlist mit #EXTM3U, #EXTINF, group-title und tvg-logo – jede Zeile einer M3U-Liste einfach erklärt.
Wer die interne Struktur einer M3U-Datei versteht, kann Anzeigeprobleme (fehlendes Logo, falsch einsortierter Sender) leichter eingrenzen und besser nachvollziehen, was die App tatsächlich tut, wenn sie eine Liste „lädt“. Dieser Ratgeber erklärt jede Zeile – ganz ohne technische Vorkenntnisse.
Was genau ist eine M3U-Datei?
Eine M3U-Datei ist eine reine Textdatei (kein Video), die auf eine Reihe von Streams oder Titeln verweist. Das Format gibt es seit den Anfängen von MP3 und wurde später für Video-Streaming übernommen; es zählt bis heute zu den am weitesten unterstützten Playlist-Formaten unter Media-Playern, wie das Datenblatt bei Wikipedia dokumentiert. Wenn eine App eine M3U-URL „öffnet“, lädt sie in Wirklichkeit diese Textdatei herunter und wertet jede Zeile aus, um die auf dem Bildschirm angezeigte Senderliste aufzubauen – wie im Diagramm oben dargestellt.
Wozu dient der Header #EXTM3U?
Der Header #EXTM3U weist die Datei als erweiterte M3U-Playlist aus und muss immer allein in der ersten Zeile stehen. Fehlt er an dieser Position, behandeln die meisten Player die Datei nicht als gültige Senderliste. So sieht diese Zeile aus:
#EXTM3U
Er teilt dem Player mit, dass es sich um eine „erweiterte“ M3U-Datei handelt, also ein Format, das die unten beschriebenen zusätzlichen Metadaten erlaubt. Eine einfache M3U-Datei ohne diesen Header wäre auf eine bloße Liste von URLs ohne Namen oder Logos beschränkt.
Was enthält die #EXTINF-Zeile eines Senders?
Die #EXTINF-Zeile steht vor jedem Eintrag der Playlist und beschreibt den Sender mit Dauer, optionalen Attributen und Anzeigenamen. Ihre typische Struktur sieht so aus:
#EXTINF:-1 tvg-id="sender1" tvg-logo="https://beispiel.de/logo.png" group-title="Sport",Sendername
https://server-beispiel.de/live/sender1/index.m3u8
Drei Elemente bilden diese Zeile:
- Die Dauer (
-1für einen Live-Stream ohne festgelegte Dauer – ein positiver Wert gäbe die Dauer in Sekunden für On-Demand-Inhalte an). - Optionale Attribute:
tvg-id(Kennung zur Zuordnung eines Programmführers),tvg-logo(URL des Logobilds),group-title(angezeigte Kategorie, zum Beispiel „Sport“ oder „Cinema“). - Der angezeigte Name, hinter dem abschließenden Komma.
Die folgende Zeile enthält die URL des Streams selbst: die Adresse, die der Player nutzt, um die Wiedergabe zu starten, sobald Sie den Sender auswählen.
Wozu dient group-title in einer M3U-Playlist?
Das Attribut group-title legt fest, unter welcher Kategorie ein Sender in Apps erscheint, die es auswerten. Fehlt dieses Attribut, oder unterstützt der Player es nicht, erscheinen alle Sender meist in einer flachen, ungeordneten Liste. Das ist einer der Gründe, warum dieselbe M3U-Liste in einer App besser sortiert wirkt als in einer anderen: Die Ordnung hängt davon ab, wie der jeweilige Player dieses Attribut auswertet, nicht von der Playlist selbst.
M3U oder M3U8: worin liegt der Unterschied?
Der Unterschied zwischen beiden Endungen liegt allein in der Zeichenkodierung. Eine .m3u8-Datei nutzt UTF-8-Kodierung, die nötig ist, um Akzente und nicht-lateinische Zeichen in Sendernamen korrekt darzustellen. Das erweiterte M3U8-Format kommt außerdem beim adaptiven HLS-Streaming (HTTP Live Streaming) zum Einsatz, bei dem jede Playlist auf aufeinanderfolgende Videosegmente statt auf einen einzigen durchgehenden Stream verweist, wie Wikipedia beschreibt. Für die klassische IPTV-Nutzung bleibt diese Unterscheidung im Hintergrund: Nahezu alle aktuellen Apps akzeptieren beide Endungen gleichermaßen.
Wie öffnet ein Player eine M3U-URL wirklich?
Öffnet eine App eine M3U-URL, lädt sie die Textdatei herunter und wertet jede Zeile aus, um die Senderliste aufzubauen. Manche Apps wie VLC tun das direkt über ihr Netzwerk-Wiedergabemenü, ohne eigenen IPTV-Anmeldebildschirm, ein Vorgehen, das die offizielle VideoLAN-Dokumentation beschreibt. Andere spezialisierte IPTV-Apps wie IPTV Smarters Pro bieten einen eigenen Bildschirm zum Einfügen der M3U-URL und legen eine eigene Oberfläche über die hier beschriebene Struktur.
Wie grenzt man ein Anzeigeproblem anhand der M3U-Struktur ein?
Wer diese Struktur kennt, versteht leichter, woher bestimmte Anzeigeprobleme rühren:
- Fehlendes Logo: Die im Attribut
tvg-logoeingetragene URL ist defekt oder aus Ihrem Netzwerk nicht erreichbar. - Falsch einsortierter oder nicht kategorisierter Sender: Das Attribut
group-titlefehlt in der #EXTINF-Zeile, oder der Player wertet es nicht aus. - Liste lädt gar nicht: Das Problem liegt weiter vorn, oft auf Ebene der Gesamt-URL oder der Verbindung, nicht in der internen Dateistruktur – sehen Sie in unseren eigenen Ratgeber, wenn Ihre M3U-Playlist nicht lädt.
Sobald Sie die Struktur verstanden haben, erklärt unser Artikel zum Verwalten einer M3U-Playlist, wie Sie sie ordnen, aktualisieren und dauerhaft übersichtlich halten.
Fazit
Eine M3U-Datei bleibt eine schlichte, strukturierte Textdatei: ein Header, dann Paare aus #EXTINF- und URL-Zeilen, die jeden Sender beschreiben. Wer diese Anatomie versteht, kann das Verhalten seiner App besser deuten und ein Playlist-Problem von einem Netzwerkproblem unterscheiden. Zur Wahl zwischen dieser Methode und einer Xtream-Codes-Verbindung lesen Sie unseren Artikel M3U oder Xtream Codes.
Häufig gestellte Fragen
Was ist der Unterschied zwischen .m3u und .m3u8?
Beide folgen derselben Struktur. Die Endung .m3u8 gibt lediglich an, dass die Datei in UTF-8 kodiert ist – nötig, um Akzente und Sonderzeichen (etwa Sendernamen in mehreren Sprachen) korrekt anzuzeigen. Die meisten aktuellen IPTV-Apps akzeptieren beide gleichermaßen.
Wozu dient die Zeile #EXTM3U ganz am Anfang der Datei?
Das ist der obligatorische Header, der die Datei als erweiterte M3U-Playlist ausweist. Fehlt diese Zeile an erster Position, verweigern die meisten Player, die Datei als gültige Senderliste zu behandeln.
Was bedeutet group-title in einer #EXTINF-Zeile?
Das ist ein optionales Attribut, das die Kategorie eines Senders angibt (z. B. „Sport“, „Cinema“, „News“). Apps, die es unterstützen, nutzen es, um die Liste automatisch nach Themen zu ordnen, statt alle Sender ungeordnet anzuzeigen.
Warum werden manche Senderlogos nicht angezeigt?
Das Logo stammt von einer URL im Attribut tvg-logo der Zeile #EXTINF. Fehlt diese URL, ist sie abgelaufen oder wird vom Netzwerk blockiert, zeigt der Player statt des Logos ein Standardsymbol an.
Kann man eine M3U-Datei in einem einfachen Texteditor öffnen und abspielen?
Ja, eine M3U-Datei ist eine reine Textdatei: Sie können sie mit jedem Editor öffnen, um ihren Inhalt zu prüfen. Abspielbar wird sie dadurch nicht – nur eine kompatible App (VLC, TiviMate, IPTV Smarters Pro usw.) kann die Streams, auf die sie verweist, tatsächlich abspielen.
Enthält die M3U-Datei das Video direkt?
Nein. Sie enthält nur Adressen (URLs), die auf Videostreams auf einem entfernten Server verweisen, sowie Metadaten (Name, Logo, Kategorie). Die Datei selbst ist nur wenige Kilobyte groß – unabhängig vom Umfang des referenzierten Katalogs.
