Das TV-Programm im XMLTV-Format: was es ist, wie es zugeordnet wird und wie du es importierst

5 Min. Lesezeit

Ein TV-Programm (EPG, nach der englischen Abkürzung für elektronischer Programmführer) zeigt dir, was gerade auf jedem Sender läuft und was danach kommt. Für M3U-Listen wird es meist im XMLTV-Format verbreitet, einem offenen XML-Format, das es schon seit vielen Jahren gibt und das fast alle Player verstehen. Hier siehst du, wie es aufgebaut ist, wie es mit deinen Sendern verbunden wird und was du tun kannst, wenn es nicht erscheint oder die Uhrzeiten verschoben sind.

So ist eine XMLTV-Datei aufgebaut

Sie hat zwei Teile: die Liste der Sender und die Liste der Sendungen. Ein verkürztes Beispiel:

<?xml version="1.0" encoding="UTF-8"?>
<tv>
<channel id="CanalUno.es">
<display-name>Canal Uno</display-name>
<icon src="https://example.com/logos/canal-uno.png"/>
</channel>
<programme start="20261106210000 +0100" stop="20261106220000 +0100" channel="CanalUno.es">
<title>Informativo de la noche</title>
<desc>Resumen de la actualidad del día.</desc>
<category>Noticias</category>
</programme>
</tv>

channel id ist die Kennung des Senders. Sie hat kein festes Format, üblich ist aber etwas wie NombreDelCanal.es.
display-name ist sein lesbarer Name; es kann mehrere geben.
programme enthält den Sender, zu dem die Sendung gehört, sowie Beginn und Ende im Format AAAAMMDDhhmmss, gefolgt von der Abweichung zur Weltzeit: +0100 ist die Uhrzeit auf dem spanischen Festland im Winter, +0200 die im Sommer.
Darin stehen der Titel und, falls vorhanden, der Untertitel der Sendung, die Beschreibung, die Kategorie und ein Bild.

Vollständige Programme können Hunderte Megabyte groß sein, deshalb werden sie meist komprimiert veröffentlicht, als .xml.gz oder .zip.

Wie das Programm deinen Sendern zugeordnet wird

Programm und Liste sind getrennte Dateien, oft aus unterschiedlichen Quellen. Um zu wissen, welches Programm zu welchem Sender gehört, sucht der Player nach Übereinstimmungen. Whatplay geht dabei in dieser Reihenfolge vor:

Nach der tvg-id des Senders in der M3U (oder der epgId in W3U), verglichen mit der channel id im Programm.
Nach dem Namen, wenn es keine Kennung gibt oder sie nicht passt: der Name des Senders in deiner Liste gegenüber dem display-name im Programm.

Sie müssen nicht Buchstabe für Buchstabe übereinstimmen. Whatplay vergleicht ohne Rücksicht auf Groß- und Kleinschreibung, ohne Akzente und ohne Leer- und Satzzeichen; es entfernt Qualitätskennzeichen am Ende (HD, FHD, UHD, 4K) und bei den Kennungen das Länderkürzel, etwa .es. So findet „Canal Uno HD“ in deiner Liste „Canal Uno“ im Programm. Aber „C1“ und „Canal Uno“ haben nichts gemeinsam: Dafür gibt es die tvg-id.

Ein gut für das Programm vorbereiteter Sender sieht in der M3U so aus:

#EXTINF:-1 tvg-id="CanalUno.es" tvg-logo="https://example.com/logos/canal-uno.png",Canal Uno
https://example.com/emision/canal-uno.m3u8

So importierst du es in Whatplay

Wenn deine Liste es schon angibt (in der M3U mit url-tvg oder x-tvg-url in der Zeile #EXTM3U; in W3U mit epg), meldet dir das TV-Programm das mit dem Hinweis „Die Liste ‚…‘ bringt ihr eigenes TV-Programm mit“ und einer Schaltfläche zum Importieren.
Wenn nicht, geh zum TV-Programm und tippe auf „TV-Programm importieren“. Füge die Adresse eines XMLTV-Programms (.xml, .xml.gz oder .zip) ein oder tippe auf „Aus Datei“, um eines vom Gerät zu wählen.

Das Programm wird im Hintergrund heruntergeladen und erscheint nach und nach. Unter „Importierte TV-Programme“ siehst du, wie viele Sender und Sendungen es enthält, und kannst es dort auch entfernen. Das TV-Programm hat zwei Ansichten: „Jetzt“, mit dem, was gerade auf jedem Sender läuft, und „Raster“, mit dem ganzen Tag und einer Tagesauswahl. Im Player erscheinen unter dem Sendernamen „Jetzt“ und „Danach“. Whatplay aktualisiert die Programme von Zeit zu Zeit und lädt sie nicht erneut herunter, wenn sie sich nicht geändert haben. Die Hilfe fasst es unter Wie richte ich das TV-Programm ein? zusammen.

Typische Probleme

„Keiner der Sender deiner Listen ist in den importierten TV-Programmen“

Das Programm wurde importiert, aber weder eine Kennung noch ein Name passt. Öffne das Programm in einem Texteditor, such heraus, wie dein Sender in den channel id heißt, und trag diesen Wert in die tvg-id deiner Liste ein. Prüfe auch, ob das Programm aus demselben Land oder derselben Region stammt wie deine Sender.

Die Sendungen sind um eine Stunde verschoben

Meistens gibt das Programm seine Zeitzone falsch an: Ortszeiten, die als +0000 markiert sind, oder eine Abweichung, die sich mit der Sommerzeit nicht ändert. Whatplay hält sich an das, was bei jeder Sendung steht, und rechnet es in deine Uhrzeit um; ist das Programm also falsch, muss es im Programm selbst korrigiert werden.

„Das ist kein TV-Programm im XMLTV-Format, oder es enthält keine Sendungen für diese Tage“

Entweder führt die Adresse nicht zu einer XMLTV-Datei (sie öffnet zum Beispiel eine Webseite), oder das Programm ist veraltet und enthält nur vergangene Sendungen. Programme werden oft neu erzeugt: Eine alte Kopie ist schnell unbrauchbar.

Du hast das Programm unter „Liste hinzufügen“ eingefügt

Whatplay erkennt das, sagt dir, dass es ein TV-Programm und keine Liste ist, und zeigt dir, wo du es mit derselben Adresse importierst.

Es lädt sehr lange

Große Programme brauchen Zeit zum Herunterladen und Einlesen. Nimm die komprimierte Version, wenn es eine gibt, und, wenn die Quelle es erlaubt, ein Programm nur mit den Sendern, die du nutzt.

Das Programm liegt in deinem Heimnetz

Ab Android 17 braucht Whatplay die Berechtigung „Geräte in der Nähe“, um ein Programm von einem Computer oder NAS in deinem Netzwerk herunterzuladen. Die App bittet dich mit einem Hinweis darum.

Ein eigenes Programm erstellen

Wenn du selbst etwas mit festem Sendeplan überträgst, etwa das Radio eines Vereins oder den Kanal einer Schule, kannst du eine XMLTV-Datei von Hand schreiben: Ein channel und seine programme genügen, mit korrekt gesetzter Zeitzone und der Datei in UTF-8. Um sie mit deinem Sender zu verbinden, verwende dieselbe Kennung in der tvg-id deiner M3U-Liste oder in der epgId deiner W3U; beide Formate werden unter M3U, M3U8 und W3U erklärt.