Zum Inhalt springen

XMLTV erklärt: Das Format hinter jedem Programmführer

Von Elena Voss3. August 20268 Min. LesezeitAktualisiert am 6. August 2026

XMLTV ist ein offenes, XML-basiertes Dateiformat zur Beschreibung von TV-Programmlisten – welches Programm auf welchem Kanal wann läuft. Es ist das häufigste Format hinter den EPG-Daten, die Ihre Player-App anzeigt, und das Verständnis seiner Struktur klärt viel darüber, warum sich Programmführer manchmal unerwartet verhalten.

Was sich strukturell in einer XMLTV-Datei befindet

Eine XMLTV-Datei ist um zwei Haupt-Elementtypen organisiert: Kanaldefinitionen, die die Kennung und den Anzeigenamen jedes Kanals auflisten, und Programmeinträge, die jeweils eine geplante Sendung mit Startzeit, Endzeit, Titel, und oft einer kurzen Beschreibung beschreiben. Ein vereinfachter Auszug sieht etwa so aus:

<channel id="example.channel">
  <display-name>Example Channel</display-name>
</channel>
<programme start="20260806190000" stop="20260806200000" channel="example.channel">
  <title>Evening News</title>
  <desc>Daily news roundup.</desc>
</programme>

Player-Apps parsen diese XML-Struktur, ordnen jeden Programmeintrag seinem entsprechenden Kanal zu und zeigen ihn im passenden Zeitfenster auf Ihrem Bildschirmleitfaden an.

Wie es sich mit Ihrer Playlist verbindet

Ihre M3U-Playlist und Ihr XMLTV-Leitfaden werden hinter den Kulissen über Kanalkennungen abgeglichen – das tvg-id-Tag in Ihrer M3U-Playlist muss genau dem id-Attribut in der XMLTV-Kanaldefinition entsprechen. Deshalb müssen beide eingegeben – und gelegentlich aktualisiert – werden, damit ein vollständig funktionierender Leitfaden entsteht, und deshalb ist eine Diskrepanz zwischen den beiden Kennungssätzen eine der häufigsten Ursachen für einen Leitfaden, der lädt, aber für bestimmte Kanäle keine Daten anzeigt.

Raw XMLTV file contents shown in a text editor with channel and programme entries visible
XMLTV-Dateien verwenden strukturierte XML-Tags, um Kanäle und ihr geplantes Programm zu beschreiben.

Wie XMLTV-Daten typischerweise generiert und bezogen werden

Anders als Ihre persönliche M3U-Playlist, die üblicherweise speziell für Ihr Konto generiert wird, stammen XMLTV-Leitfadendaten oft von gemeinsam genutzten, aggregierten Listendiensten, die breite regionale Programmpläne abdecken, und werden dann Ihrer spezifischen Kanalauswahl zugeordnet. Deshalb können Leitfadendatenqualität und Aktualisierungshäufigkeit variieren – manche Quellen aktualisieren mehrmals täglich mit detaillierten Beschreibungen, während andere grundlegendere, weniger häufig aktualisierte Listen bereitstellen.

Fehlerbehebung bei nicht übereinstimmenden Zeitplänen

Wenn Programme mit den tatsächlichen Sendezeiten nicht übereinzustimmen scheinen, ist eine Zeitzoneneinstellungsdiskrepanz in Ihrer Player-App die häufigste Ursache, statt eines Problems mit den XMLTV-Daten selbst. XMLTV-Zeitstempel enthalten typischerweise Zeitzonenversatz-Informationen, aber Player-Apps interpretieren diese manchmal falsch oder überschreiben sie basierend auf Geräteeinstellungen – die Überprüfung der spezifischen Zeitzonenkonfiguration Ihrer App ist normalerweise die schnellste Lösung.

Tipp

Wenn Ihr Leitfaden konsequent Programme zeigt, die um eine feste Anzahl von Stunden verschoben sind, prüfen Sie zuerst die Zeitzoneneinstellung Ihres Geräts – diese einzelne Fehlkonfiguration erklärt die überwiegende Mehrheit der Beschwerden über „falschen Zeitplan".

Vor- und Nachteile des XMLTV-Formats

VorteileNachteile
Offener, gut dokumentierter, weit unterstützter StandardDatenqualität hängt vollständig vom spezifischen Quell-Feed ab
Menschenlesbare Struktur, nützlich für FehlerbehebungErfordert exakte Kanal-ID-Übereinstimmung mit Ihrer Playlist
Unterstützt reichhaltige Metadaten wie Beschreibungen und KategorienAktualisierungshäufigkeit variiert erheblich zwischen Quellen

Best Practices für eine zuverlässige XMLTV-Einrichtung

  • Bestätigen Sie die Kanal-ID-Übereinstimmung zwischen den tvg-id-Tags Ihrer M3U-Playlist und den Kanaldefinitionen Ihrer XMLTV-Quelle.
  • Prüfen Sie die Zeitzoneneinstellung Ihres Geräts, bevor Sie ein XMLTV-Datenproblem annehmen.
  • Aktualisieren Sie Ihre Leitfadendaten regelmäßig, gemäß dem spezifischen Aktualisierungsmechanismus Ihrer Player-App.
  • Verwenden Sie eine seriöse, gut gepflegte XMLTV-Quelle für die konsistentesten, aktuellsten Listen.

Häufige Fehler bei XMLTV-Leitfadendaten

  • Annehmen, dass eine fehlende Programmauflistung bedeutet, dass der Kanal defekt ist, wenn sie öfter einfach in dieser spezifischen Leitfadendatenquelle fehlt.
  • Die Kanal-ID-Übereinstimmung nicht prüfen, wenn ein Leitfaden lädt, aber für bestimmte Kanäle keine Daten zeigt.
  • XMLTV-Dateien manuell bearbeiten in Erwartung dauerhafter Änderungen, obwohl die meisten Quellen automatisch aktualisiert und überschrieben werden.
  • Ihren Anbieter für ein Zeitzonen-Anzeigeproblem verantwortlich machen, das tatsächlich eine geräteseitige Einstellung ist.

Fehlerbehebung bei XMLTV- und EPG-Problemen, Schritt für Schritt

  1. Bestätigen Sie, dass die Zeitzoneneinstellung Ihres Geräts Ihrem tatsächlichen Standort entspricht.
  2. Prüfen Sie, dass die Kanal-IDs Ihrer M3U-Playlist genau den Kanaldefinitionen Ihrer XMLTV-Quelle entsprechen.
  3. Erzwingen Sie eine manuelle Leitfadenaktualisierung, wenn Ihre Player-App eine unterstützt.
  4. Testen Sie, ob das Problem alle Kanäle oder nur bestimmte betrifft – ein quellenweites Problem deutet auf den XMLTV-Feed selbst hin, während isolierte Lücken auf Übereinstimmungsprobleme für diese spezifischen Kanäle hindeuten.
  5. Wenn das Problem bestehen bleibt, kontaktieren Sie Ihren Anbieter mit Details dazu, welche Kanäle und Zeiträume betroffen sind.

Häufiger Fehler

Ein Leitfadenproblem beheben, ohne zuerst die Kanal-ID-Übereinstimmung zu prüfen. Eine Diskrepanz zwischen den tvg-id-Werten Ihrer Playlist und den Kanal-IDs der XMLTV-Quelle ist eine der häufigsten – und am meisten übersehenen – Ursachen für fehlende Leitfadendaten.

Warum XMLTV XML als zugrunde liegende Struktur wählte

XML war eine natürliche Wahl, als XMLTV ursprünglich entwickelt wurde, da es eine gut definierte, selbstbeschreibende Struktur bietet, die sowohl maschinell parsbar als auch menschenlesbar ist – ein echter Vorteil bei der Fehlerbehebung, da Sie eine rohe XMLTV-Datei in jedem Texteditor öffnen und deren Inhalt sofort ohne Spezialwerkzeuge verstehen können. XMLs hierarchische, tag-basierte Struktur macht es auch einfach, sie mit zusätzlichen optionalen Feldern zu erweitern – Kategorien, Episodennummern, Bewertungen, Symbole – ohne die Kompatibilität mit älteren Parsern zu brechen, die einfach Tags ignorieren, die sie nicht erkennen. Diese Erweiterbarkeit ist Teil des Grundes, warum XMLTV so lange das dominierende EPG-Datenformat geblieben ist, obwohl neuere, kompaktere Datenformate für andere Zwecke existieren – seine Kombination aus Lesbarkeit, Erweiterbarkeit, und breiter Tool-Unterstützung hat sich über zwei Jahrzehnte der Nutzung als dauerhaft erwiesen.

Wie die XMLTV-Datenaggregation tatsächlich hinter den Kulissen funktioniert

Zu verstehen, woher XMLTV-Daten kommen, klärt, warum Qualität und Abdeckung variieren. Statt dass jeder einzelne IPTV-Anbieter selbst detaillierte Listen für jeden Kanal generiert, verlassen sich die meisten auf spezialisierte Drittanbieter-Aggregationsdienste, die Programmpläne von vielen Sendern und Regionen zu einheitlichen XMLTV-Feeds zusammenstellen. Diese Aggregationsdienste kombinieren oft Daten aus offiziellen Sender-Quellen, lizenzierten Listenanbietern, und in manchen Fällen von der Gemeinschaft gepflegten Projekten, und normalisieren dann alles zu einer konsistenten XMLTV-Struktur. Diese Aggregationsschicht ist für Sie als Abonnent unsichtbar, aber sie erklärt, warum sich die Leitfadendatenqualität zwischen Kanälen innerhalb der Auswahl desselben Anbieters wirklich unterscheiden kann – ein gut abgedeckter großer nationaler Kanal hat typischerweise detailliertere, zuverlässigere Listen als ein kleinerer regionaler oder internationaler Kanal, den ein bestimmter Aggregationsdienst weniger gründlich abdeckt.

Ein Praxisbeispiel: einen Leitfaden diagnostizieren, dem mehrere Kanäle fehlen

Betrachten Sie einen Abonnenten, der bemerkt, dass etwa ein Drittel seiner Kanäle überhaupt keine Programmführer-Daten zeigt, während der Rest gut funktioniert. Eine methodische Diagnose:

  1. Er öffnet seine rohe M3U-Playlist in einem Texteditor und notiert den tvg-id-Wert für einen der betroffenen Kanäle.
  2. Er öffnet seine XMLTV-Quell-URL in einem Browser und sucht nach derselben Kennung innerhalb der Kanaldefinitionen.
  3. Er entdeckt, dass die Kennung in der XMLTV-Quelle überhaupt nicht vorhanden ist – dieser bestimmte Kanal wird von seinem Leitfadendatenanbieter einfach nicht abgedeckt.
  4. Er prüft einen zweiten betroffenen Kanal und findet dasselbe Muster – eine echte, konsistente Lücke in der Kanalabdeckung dieser bestimmten XMLTV-Quelle, kein zufälliger technischer Fehler.
  5. Ausgestattet mit diesem spezifischen Befund meldet er die genauen fehlenden Kanal-IDs seinem Anbieter, der entweder erweiterte Abdeckung von seiner Aggregationsquelle anfordern oder erklären kann, dass derzeit keine Leitfadendatenquelle diese bestimmten Kanäle abdeckt.

Diese Art spezifischer, evidenzbasierter Diagnose – direktes Prüfen von roher Playlist- und XMLTV-Daten statt Raten – verwandelt eine vage Beschwerde „Leitfaden ist kaputt" in einen präzisen, umsetzbaren Bericht, den ein Anbieter tatsächlich untersuchen und angehen kann.

Wissenswerte Fachbegriffe

Einige verwandte Begriffe sind hier nützlich: Element (ein einzelnes XML-Tag und sein Inhalt, wie ein einzelner <programme>-Eintrag), Attribut (eine an ein XML-Element angehängte Eigenschaft, wie die start-Zeit auf einem Programm-Tag), Aggregationsdienst (ein Dritter, der TV-Listendaten aus mehreren Quellen zusammenstellt und normalisiert), und Schema (die formale Regelmenge, die definiert, welcher Struktur eine gültige XMLTV-Datei folgen muss).

Wichtige Erkenntnisse

  • XMLTV ist ein offener, XML-basierter Standard, der TV-Listen durch Kanal- und Programmelemente beschreibt.
  • Die Kanal-ID-Übereinstimmung zwischen Ihrer Playlist und XMLTV-Quelle ist essenziell, damit Leitfadendaten korrekt angezeigt werden.
  • Zeitzonenfehlkonfiguration, nicht schlechte Daten, ist die häufigste Ursache für Zeitplan-Fehlausrichtung.
  • Leitfadendatenqualität und -aktualität variieren je nach Quelle, da sie oft separat von Ihrer persönlichen Playlist aggregiert werden.
  • Ihre Player-App handhabt das XMLTV-Parsing automatisch – keine manuelle Dateibearbeitung ist bei normaler Nutzung nötig.

Fazit

XMLTV ist ein etablierter, offener Standard, der still den Programmführer antreibt, auf den sich die meisten IPTV-Abonnenten täglich verlassen, ohne je über das zugrunde liegende Format nachzudenken. Das Verständnis seiner Kanal-ID-Übereinstimmungsanforderung und wie Zeitzoneneinstellungen damit interagieren, verwandelt verwirrende Leitfadenprobleme in schnelle, systematische Lösungen statt mysteriöser, unerklärter Störungen.

Das nächste Mal, wenn Ihr Leitfaden eine unerwartete Lücke oder einen fehlausgerichteten Zeitplan zeigt, wissen Sie jetzt genau, wo Sie zuerst nachsehen müssen – Kanal-ID-Übereinstimmung und Zeitzoneneinstellungen lösen die überwältigende Mehrheit der realen XMLTV-Probleme, weit bevor irgendetwas, das einem echten Datenproblem ähnelt, stromaufwärts gemeldet werden muss.

Wie sich das in Ihr umfassenderes EPG-Erlebnis einfügt

XMLTV ist das Datenformat; die tatsächliche Programmführer-Oberfläche, mit der Sie interagieren – durchsuchen, suchen, Erinnerungen einstellen – ist ein separates Anliegen, das in unserem dedizierten EPG-Erklärer behandelt wird. Zusammen bilden sie das vollständige Bild: XMLTV beschreibt, was wann läuft, während die EPG-Oberfläche in Ihrer Player-App diese Daten durchsuchbar und nützlich präsentiert. Das Verständnis beider Hälften dieser Paarung gibt Ihnen ein vollständiges mentales Modell zur Fehlerbehebung bei fast jedem programmführerbezogenen Problem, dem Sie begegnen könnten.

Tipp

Bewahren Sie Ihre Playlist- und XMLTV-URLs zusammen in einer sicheren Notiz auf – da beide für einen vollständig funktionierenden Leitfaden benötigt werden, spart es Zeit, beide griffbereit zu haben, falls Sie jemals ein Gerät neu konfigurieren oder eine Diskrepanz beheben müssen.

Häufig gestellte Fragen

EV
Elena Voss

Elena leads streaming infrastructure at IPTVLinux, writing about device setup, performance tuning, and getting the most out of your connection.

Bereit zum Streamen?

In wenigen Minuten eingerichtet — schreiben Sie uns auf WhatsApp und wir führen Sie durch den Prozess.