Was ist ein IPTV-EPG und wie verknüpft man ihn mit öffentlichen Playlists?

Viele, die sich zum ersten Mal mit Live-Streaming beschäftigen, gehen davon aus, dass mit einer M3U-Playlist bereits alles eingerichtet ist. Öffnet man die Datei jedoch auf einer TV-Box oder in einer Client-App, sieht man oft nur eine nüchterne Liste von Sendernamen: Es gibt keine Information darüber, welche Sendung gerade läuft, wann der aktuelle Beitrag endet oder was zur Primetime ausgestrahlt wird. Ohne Zusatzdaten bleibt die Playlist im Grunde ein simples Adressverzeichnis.

Damit eine Abspielsoftware die gewohnte Bedienung mit Programmübersicht wie am klassischen Fernseher bieten kann, benötigt man einen EPG. In diesem Artikel erklären wir die technischen Mechanismen: wie EPG und XMLTV zusammenhängen, warum Senderliste und Sendedaten getrennt geführt werden, wie beide über Metadatenfelder zusammenfinden und wo die Grenzen öffentlicher Datenquellen liegen.

Ohne Programmführer ist eine Playlist nur eine Namenssammlung

Wer unseren Beitrag zum Aufbau von M3U-Dateien kennt, weiß: Eine Standard-M3U-Datei dient lediglich dazu, Streaming-Adressen zusammen mit grundlegenden Beschreibungs-Tags zu speichern.

Fehlt ein passender Programmführer, kann der Player ausschließlich den Kanalnamen und die Wiedergabe-URL auslesen. Was die Fernbedienung dann anzeigt, ist bestenfalls eine einfache Auswahlliste. Liegen dem Player jedoch Programmdaten vor, kann er eine vollwertige Zeitleiste aufspannen: Auf der horizontalen Achse die Uhrzeit, vertikal die Sender, und in jedem Feld der Titel der Sendung samt Start- und Endzeit sowie Inhaltsangabe. Diese Struktur zur Anzeige von Sendeabläufen nennt man EPG (Electronic Program Guide).

Was sind EPG und XMLTV?

EPG bezeichnet die Funktion an sich, während XMLTV das etablierteste offene Datenformat ist, mit dem diese Funktion realisiert wird.

XMLTV nutzt die XML-Syntax und wurde ursprünglich geschaffen, um Fernsehprogrammdaten zwischen Open-Source-Anwendungen und verschiedenen Plattformen auszutauschen. Ein Standard-XMLTV-Dokument setzt sich aus zwei zentralen Datenbereichen zusammen:

1. Kanaldefinitionen (channel-Tags): Deklarieren den eindeutigen Kanalbezeichner (id), den angezeigten Namen (display-name) und optional das Senderlogo (icon).
2. Sendungseinträge (programme-Tags): Bilden das konkrete Programmschema ab. Jeder Eintrag enthält die ID des zugehörigen Senders (channel), die Anfangszeit (start), die Endzeit (stop), den Sendungstitel (title) sowie optionale Detailbeschreibungen oder Genre-Kategorien.

Moderne IPTV-Clients (wie dedizierte TV-Apps oder Open-Source-Mediencenter) laden diese XMLTV-Datei beim Start, wandeln die Zeitstempel in die lokale Zeitzone des Endgeräts um und stellen das Ergebnis als übersichtliche EPG-Tabelle dar.

Warum sind Senderliste und Sendeplan zwei separate Dateien?

Oft kommt die Frage auf: Wenn beides ohnehin zusammengehört, warum integriert man den Programmablauf nicht direkt in die Playlist, anstatt zwei getrennte Dateien für M3U und XMLTV zu nutzen?

Der Grund liegt in zwei maßgeblichen Unterschieden: Aktualisierungsintervall und Dateigröße.

• Unterschiedliche Lebenszyklen: Die Streaming-Adressen von TV-Sendern bleiben in der Regel stabil. Sofern keine Serverwartung oder Umstellung erfolgt, muss eine M3U-Playlist oft über Wochen oder Monate nicht angefasst werden. Programmdaten hingegen sind tagesaktuell: Sie wechseln fortlaufend und müssen im Abstand weniger Tage oder täglich neu abgerufen werden.
• Gravierender Unterschied beim Datenvolumen: Eine M3U-Playlist mit mehreren Dutzend frei empfangbaren Sendern ist oft nur wenige Kilobyte (KB) groß. Würde man jedoch die detaillierten, minutengenauen Programmdaten samt Beschreibungen für eine ganze Woche für dieselben Sender anhängen, wäre die XMLTV-Datei nach dem Entpacken schnell Dutzende Megabyte (MB) schwer. Müsste dieser Datenberg bei jedem Senderwechsel oder Adress-Check erneut übertragen werden, würde das unnötig Bandbreite kosten und leistungsschwache TV-Hardware beim Parsen stark ausbremsen.

Diese Trennung gilt auch im breiteren Open-Data-Bereich. Bei frei zugänglichen Streaming-Sammlungen pflegt die Community Test-Streams in einem gesonderten Verzeichnis (mehr dazu in unserem Leitfaden für Verzeichnisse öffentlicher TV-Sender), während die Web-Scraper für internationale Programmdaten in einem komplett separaten EPG-Repository laufen. Beide Systeme arbeiten autonom, ohne sich gegenseitig zu belasten.

Die Verknüpfung im Detail und typische Fehlerquellen

Die Playlist verrät dem Player, woher er den Videostream beziehen soll; die Programmübersicht teilt ihm mit, was auf diesem Sender zu welcher Zeit läuft. Das Bindeglied zwischen beiden Welten ist die eindeutige Senderkennung – innerhalb der M3U üblicherweise als tvg-id hinterlegt.

Die typische Zuweisung sieht wie folgt aus:

In der M3U-Datei definiert eine Zeile die Kanaleigenschaften:

#EXTINF:-1 tvg-id="CCTV1.cn" tvg-name="CCTV-1" tvg-logo="[原文](https://example.com/logo.png"),CCTV-1 综合
[原文](https://example.com/live/cctv1.m3u8)

In der zugehörigen XMLTV-Datei findet sich der entsprechende Gegenspieler:

<channel id="CCTV1.cn">
  <display-name>CCTV-1</display-name>
</channel>
<programme start="20260908120000 +0800" stop="20260908123000 +0800" channel="CCTV1.cn">
  <title lang="zh">新闻30分</title>
</programme>

Der Client vergleicht den Wert von tvg-id aus der M3U mit dem Attribut channel id im XMLTV-Dokument. Stimmen beide Zeichenketten exakt überein, ordnet der Player die Sendung „新闻30分“ problemlos dem Eintrag „CCTV-1 综合“ zu.

Bleibt der Programmführer nach der Einrichtung leer oder stimmen die Zuordnungen nicht, liegen meist folgende Ursachen vor:

1. Fehler bei Groß-/Kleinschreibung oder Schreibfehler in der tvg-id: Steht in der M3U etwa tvg-id="cctv1", im XMLTV aber channel id="CCTV1.cn", scheitert der zeichengenaue Abgleich trotz ähnlicher Benennung.
2. Falsche Zeitzoneninterpretation: Zeitangaben in XMLTV folgen meist dem ISO-Format mit Zeitzonen-Offset (beispielsweise +0800). Rechnet der Client diesen Offset nicht korrekt in die Systemzeit des Geräts um, erscheint die laufende Sendung um mehrere Stunden vor- oder nachverlegt.
3. Abgelaufene Programmdaten: Öffentlich erfasste EPG-Daten haben ein festes Gültigkeitsfenster. Ist das Scraping-Skript der Quelle in der Vorwoche abgerissen, findet der Player für den heutigen Tag keine passenden Einträge – selbst bei absolut identischen IDs bleibt die Anzeige leer.
4. Syntax- und Kodierungsfehler im XML: XML verzeiht keine Fehler. Nicht maskierte Sonderzeichen (wie ein ungeschütztes &) oder offene Tags führen zu Abbrüchen beim Parsen, wodurch oft auch alle folgenden Sender in der Datei unlesbar werden.

EPG-Daten auf dieser Website prüfen und verwalten

Damit Sie lokale oder öffentlich bezogene Dateien zügig analysieren können, stellen wir auf unserer Website passende Prüfwerkzeuge bereit:

• XMLTV-Dateien analysieren und validieren: Nutzen Sie den /xmltv-checker/. Das Tool parst XMLTV-Texte oder Web-Links, listet enthaltene Sender-IDs auf und zeigt Zeitfenster sowie Programmstrukturen an. So sehen Sie sofort, ob eine Datei syntaktisch korrekt und zeitlich noch gültig ist.
• Playlist-Tags abgleichen: Bevor eine Liste auf das Endgerät übertragen wird, empfiehlt sich ein Abgleich im /m3u-playlist-editor/. Stellen Sie sicher, dass jedes tvg-id-Feld buchstabengetreu mit der XMLTV-Kanal-ID übereinstimmt, um Lücken durch Leerzeichen oder Schreibfehler auszuschließen. Die Erreichbarkeit einzelner Streaming-Adressen lässt sich parallel im /hls-player/ prüfen.
• Abonnements bündeln und synchronisieren: Über den Arbeitsbereich /playlist-sync/ können Sie Ihre Playlists zentral verwalten, bei Bedarf eine EPG-Adresse verknüpfen und einen aggregierten, privaten Abonnement-Feed generieren.

Wichtiger Hinweis zur Fehleranalyse am PC: Gelegentlich wird versucht, einen generierten Feed oder .m3u-Link direkt in die Adresszeile von Google Chrome einzufügen. Chrome ist ein herkömmlicher Webbrowser: Er behandelt die Datei als einfachen Textdownload oder versucht, den Stream direkt abzuspielen. Ein Browser fragt jedoch keine verknüpften EPG-Daten ab und parst diese nicht wie eine IPTV-App. Ein Funktionstest im Desktop-Browser ersetzt daher keinen Test in einem echten, XMLTV-kompatiblen IPTV-Client.

Reale Grenzen frei zugänglicher Daten

Beim Aufbau einer eigenen Streaming-Umgebung sollten Sie die praktischen Grenzen öffentlicher EPG-Quellen berücksichtigen:

• Aufgabe dieser Website: m3u8-player.net ist eine reine Plattform für technische Analysewerkzeuge. Der /xmltv-checker/ dient ausschließlich dem Prüfen und Validieren von Textstrukturen. Wir betreiben keine Sendeanstalten, übertragen keine TV-Inhalte und vertreiben keinerlei Senderabonnements.
• Unzuverlässigkeit öffentlicher Feeds: Viele im Netz geteilte EPG-Dateien stammen von Freiwilligen, die Programmdaten über automatisierte Skripte von Websites auslesen. Solche Feeds können unangekündigt ausfallen, ihr Format ändern, pausieren oder kleinere Nischenkanäle auslassen. m3u8-player.net kann und wird nicht garantieren, dass für jeden frei verfügbaren Kanal im Internet lückenlose EPG-Daten existieren.

Für eine zuverlässige Nutzung empfiehlt es sich, die eigene Senderliste schlank zu halten: Prüfen Sie vorab die tvg-id Ihrer bevorzugten Sender mit unseren Tools und koppeln Sie diese mit einer stabilen, konformen EPG-Quelle, anstatt tausende inaktive Kanäle in die Abspielliste zu laden.

Fazit

Das Zusammenspiel von IPTV-Playlist und EPG ähnelt dem Verhältnis von Empfangsgerät und gedruckter Fernsehzeitung: Die Playlist liefert den Signalweg, das XMLTV-Dokument die Orientierung im Programm, und die tvg-id verbindet beides eindeutig miteinander. Wer versteht, wie diese beiden Dateien ineinandergreifen, behebt typische Wiedergabeprobleme, fehlende Vorschaudaten oder Synchronisationsfehler im Handumdrehen.

Wenn Sie eine neue Programmdatei erhalten haben oder prüfen möchten, ob Darstellungsfehler an einer fehlerhaften Dateisyntax liegen, rufen Sie den /xmltv-checker/ auf, um Gültigkeit und Senderzuordnungen direkt zu testen.

Quellen

• 知友「易三福」: EPG sorgt für die Programmvorschau im Client, nutzt das XMLTV-Format und gleicht Kanäle über die tvg-id ab (原文)
• 知友「x1ao4」: M3U und XMLTV müssen parallel vorliegen; stimmen die IDs nicht überein, fehlen Senderlogos und Programmdaten (原文)
• 知友「怪侠说不说」: Im iptv-org-Ökosystem werden EPG- und Playlist-Repositories getrennt voneinander gepflegt (原文)