IPTV auf Apple TV: EPG Einrichtung& Konfigurationsanleitung

Wenn Sie bereits Ihre Kanäle abspielen, aber der Programmführer leer, falsch oder Zeiten anzeigt, die um einige Stunden abweichen, haben Sie die häufigste Frustration nach der Einrichtung mit IPTV auf Apple TV getroffen: EPG-Konfiguration. Die gute Nachricht ist, dass es fast immer behoben werden kann, sobald Sie verstehen, was tatsächlich im Hintergrund vor sich geht.

Diese Anleitung erklärt, wie das Führersystem funktioniert, wie man es richtig einrichtet und wie man das spezifische Problem, das Sie sehen — sei es ein leerer Führer, nicht übereinstimmende Einträge oder ein Führer, der nach einem Tag verschwindet — debuggt.

Was das EPG ist und wie es mit Ihrer IPTV-Wiedergabeliste verbunden ist

Das größte Missverständnis, das ich sehe, ist, dass die Leute die Kanalliste und den Programmführer als eine Sache behandeln. Das sind sie nicht. Es sind zwei völlig separate Dateien, und Ihre Apple TV-Player-App muss sie selbst zusammenfügen.

M3U-Wiedergabeliste vs. XMLTV-Führer: Zwei separate Dateien

Ihre M3U (oder M3U8) Wiedergabeliste ist nur eine Liste von Kanalstreams — eine URL pro Kanal, mit einigen Metadaten angehängt. Sie enthält keine Zeitplandaten. Programmlisten stammen aus einer separaten XMLTV-Datei, die normalerweise eine.xml oder gzippte.xml.gz Datei ist, die an ihrer eigenen URL gehostet wird. Der Player lädt beide herunter und findet dann heraus, wie man sie verbindet.

Dieser Verbindungsschritt ist der Ort, an dem die meisten EPG-Probleme tatsächlich entstehen.

Wie tvg-id Kanäle mit Führerdaten verknüpft

Innerhalb jedes Kanaleintrags in Ihrer M3U trägt die#EXTINF Zeile Attribute wietvg-id,tvg-name,tvg-logo undgroup-title. Das relevante für die Übereinstimmung des Führers isttvg-id. Der Player nimmt diesen Wert und sucht nach einem passenden<channel id="..."> Eintrag in der XMLTV-Datei. Wenn die IDs genau übereinstimmen — einschließlich der Groß- und Kleinschreibung — wird der Programmzeitplan diesem Kanal angehängt. Wenn sie nicht übereinstimmen, erhalten Sie nichts.

Das ist die eigentliche Ursache für die meisten leeren oder nicht übereinstimmenden Führer. Der String muss eine exakte Übereinstimmung sein.CNN undcnn sind unterschiedlich.CNN.us undCNN sind unterschiedlich. Kein unscharfes Matching, kein Fallback.

Einige Playlists verwendentvg-name anstelle vontvg-id, und einige Player greifen auf namensbasiertes Matching zurück, wenn keine ID vorhanden ist. Aber das Namens-Matching ist weniger zuverlässig und hängt ganz davon ab, wie der spezifische Player damit umgeht. Wo immer möglich, möchten Sie korrektetvg-id Werte.

Woher die EPG-URL kommt

Ihr IPTV-Anbieter gibt Ihnen normalerweise eine XMLTV-URL zusammen mit Ihrem M3U-Link — beides ist Teil Ihrer Abonnementanmeldeinformationen. Manchmal enthält die M3U selbst einurl-tvg oderx-tvg-url Tag am Anfang der Datei, das auf den Guide verweist. Wenn dieses Tag vorhanden ist, erfassen einige Player es automatisch. Andere ignorieren es vollständig und erfordern, dass Sie die URL manuell eingeben. Es lohnt sich, beides zu überprüfen.

Schritt-für-Schritt: Hinzufügen und Konfigurieren des EPG in einem Apple TV IPTV-Player

Die genauen Menübezeichnungen variieren je nach App, aber tvOS IPTV-Player folgen im Wesentlichen dem gleichen Muster für IPTV auf Apple TV: EPG-Konfiguration. So sieht der Ablauf in den meisten von ihnen aus.

Eingabe der XMLTV-URL in den Player-Einstellungen

Öffnen Sie Ihre Player-App und navigieren Sie zu den Einstellungen oder dem Bildschirm zur Playlist-Konfiguration.Suchen Sie nach einem Feld mit einer Bezeichnung wie "EPG-URL", "Guide-URL" oder "XMLTV". Fügen Sie dort Ihren XMLTV-Link ein — dies ist normalerweise eine lange URL, die mit.xml oder.xml.gz endet. Speichern Sie die Einstellungen. Der Player sollte sofort einen Download der Guide-Datei anstoßen.

Eine Sache, auf die Sie achten sollten: Wenn Ihre XMLTV-URL über unverschlüsseltes HTTP anstelle von HTTPS bereitgestellt wird, blockieren einige tvOS-Versionen die Anfrage vollständig. Gleiches gilt fürtvg-logo Bild-URLs — wenn die Kanal-Logos nicht angezeigt werden, ist das oft der Grund. Stellen Sie sicher, dass beide URLs HTTPS verwenden.

Erzwingen eines Guide-Updates und Festlegen des automatischen Aktualisierungsintervalls

Nach dem Speichern haben die meisten Apps irgendwo in den Einstellungen einen Button "EPG aktualisieren" oder "Guide aktualisieren". Verwenden Sie ihn. Warten Sie nicht auf die automatische Aktualisierung — bestätigen Sie, dass der Guide jetzt korrekt geladen wird.

Für das automatische Aktualisierungsintervall erlauben die meisten Player, dies auf alle 6, 12 oder 24 Stunden einzustellen. Halten Sie sich an 12 oder 24 Stunden. Häufigeres Aktualisieren kann dazu führen, dass Ihre IP von dem XMLTV-Host eingeschränkt oder vorübergehend blockiert wird, was bedeutet, dass Ihr Guide stillschweigend nicht aktualisiert wird, ohne einen Fehler anzuzeigen.

Überprüfen, ob die Kanäle mit den Guide-Einträgen übereinstimmen

Nachdem die Aktualisierung abgeschlossen ist, gehen Sie zu einem Kanal, von dem Sie erwarten, dass er Guide-Daten hat, und überprüfen Sie den EPG. Wenn er leer ist, liegt das Problem fast sicher an einemtvg-id Mismatch. Öffnen Sie Ihre M3U-Datei in einem Texteditor auf einem anderen Gerät und finden Sie dietvg-id für diesen Kanal. Überprüfen Sie dann die XMLTV-Datei auf eine<channel id="..."> mit diesem genauen Wert. Wenn es irgendwelche Abweichungen gibt, müssen die IDs an der Quelle korrigiert werden — entweder in der M3U oder der XMLTV.

Die richtige Zeitzone und Zeitverschiebung einstellen

XMLTV-Zeitstempel sehen aus wie20260623180000 +0000 — das ist eine UTC-Zeit mit einem expliziten Offset. Der Player wandelt das in Ihre lokale Zeit um. Wenn die Umwandlung falsch ist, verschiebt sich jede Auflistung um den gleichen Betrag, typischerweise um eine ganze Anzahl von Stunden.

Überprüfen Sie zuerstEinstellungen> Allgemein> Datum& Uhrzeit auf dem Apple TV selbst und stellen Sie sicher, dass "Automatisch einstellen" aktiviert ist. Wenn die Zeitzone des Geräts falsch ist, werden alle Apps darauf verschobene Zeiten anzeigen. Zweitens haben einige IPTV-Player eine eigene separate Zeitzonen-Offset-Einstellung in der EPG-Konfiguration — suchen Sie nach einem Feld für "+0" oder "UTC-Offset" und stellen Sie es so ein, dass es mit Ihrem tatsächlichen Zeitunterschied zur UTC übereinstimmt. Die Umstellung auf Sommerzeit verschiebt die Zeiten zweimal im Jahr um eine Stunde, wenn die App oder das Gerät die Sommerzeit nicht automatisch verarbeitet, daher ist es ratsam, dies im März und November erneut zu überprüfen.

Behebung der häufigsten EPG-Probleme auf Apple TV

Zuerst das Symptom, dann die Ursache, dann die Lösung. Das ist das nützlichste Format für die tatsächliche Fehlersuche.

Guide ist völlig leer

Drei wahrscheinlichste Ursachen: die XMLTV-URL ist falsch oder abgelaufen, die Datei ist gzip-komprimiert und der Player kann sie nicht dekomprimieren, oder keiner dertvg-id Werte in Ihrem M3U stimmt mit etwas im XMLTV überein. Überprüfen Sie zuerst die URL — fügen Sie sie direkt in einen Browser auf einem anderen Gerät ein und bestätigen Sie, dass sie Daten zurückgibt. Wenn Sie eine.xml.gz Datei erhalten, die Ihr Player nicht unterstützt, müssen Sie entweder eine nicht komprimierte Version des gleichen Guides finden oder zu einem Player wechseln, der gzip nativ verarbeitet.

Programme sind um mehrere Stunden verschoben

Fast immer ein Zeitzonenproblem. Überprüfen Sie die Systemzeitzone des Apple TV unter Einstellungen> Allgemein> Datum& Uhrzeit, und überprüfen Sie dann die eigene Zeitzonen-Offset-Einstellung des Players. Wenn der Guide beispielsweise alles um genau 5 Stunden verschoben anzeigt, gibt es irgendwo eine UTC-5-Mismatches. Beheben Sie zuerst die Zeitzone des Geräts, dann den Player-Offset, wenn das eine separate Einstellung ist.

Richtiger Kanal, falsche Programmdaten

Das ist interessant. Wenn ein Kanal einen Zeitplan anzeigt, aber offensichtlich der falsche ist — ein Sportkanal, der beispielsweise einen Nachrichtenzeitplan zeigt — haben Sie wahrscheinlich einetvg-id Kollision. Zwei verschiedene Kanäle in Ihrem M3U teilen sich die gleichetvg-id, und der Player hat einen mit den Guide-Daten, die für den anderen bestimmt sind, abgeglichen. Die Lösung erfordert das Bearbeiten des M3U, um eindeutige, korrekte IDs zuzuweisen. Das können Sie nicht vom Apple TV aus tun.

Einige Kanäle haben einen Guide, andere nicht

Die Kanäle, denen die Guide-Daten fehlen, haben entweder keinetvg-id im M3U, haben eine ID, die mit nichts im XMLTV übereinstimmt, oder diese spezifischen Kanäle sind einfach nicht in der XMLTV-Quelle enthalten, die Ihr Anbieter bereitstellt. Überprüfen Sie das M3U auf die fehlenden Kanäle und vergleichen Sie dietvg-id Werte mit der Kanalliste der XMLTV-Datei. Regionale oder weniger beliebte Kanäle werden oft ganz von den Guide-Quellen ausgeschlossen.

Guide lädt und verschwindet dann nach einem Tag

Die meisten XMLTV-Dateien enthalten nur 2–7 Tage an zukünftigen Daten. Wenn die Datei nur 24–48 Stunden bereitstellt und die automatische Aktualisierung nicht funktioniert, werden Ihnen die Guide-Daten ausgehen. Überprüfen Sie, ob die automatische Aktualisierung in den Player-Einstellungen aktiviert ist, und bestätigen Sie, dass die XMLTV-URL weiterhin frische Daten zurückgibt. Einige Player löschen auch ihren Guide-Cache, wenn die App vollständig geschlossen ist; wenn das passiert, ist eine manuelle Aktualisierung beim nächsten Start die Lösung.

EPG-Datenqualität, Abdeckungsfenster und Speicher auf Apple TV

Das Verständnis der technischen Grenzen des Guide-Formats hilft, realistische Erwartungen zu setzen — und erklärt einige Verhaltensweisen, die sonst wie ein Fehler aussehen.

Wie viele Tage an Guide-Daten XMLTV-Dateien typischerweise enthalten

Standard-XMLTV-Dateien decken 2 bis 7 Tage an zukünftiger Programmierung ab. Einige Anbieter bieten 14-Tage-Guides für bestimmte Regionen an. Über das Abdeckungsfenster hinaus zeigt der Guide einfach nichts an — kein Fehler, einfach leer. Das ist erwartetes Verhalten, keine Fehlkonfiguration.

Dateigröße, Gzip-Kompression und Speicherkapazitäten auf älteren Apple TV HD

Eine Multi-Region-XMLTV-Datei, die Hunderte von Kanälen abdeckt, kann leicht 50–100 MB unkomprimiert erreichen. Das Apple TV HD (das ältere Modell mit dem A8-Chip) hat 1 GB RAM, der auf alles verteilt ist, was bedeutet, dass sehr große Guide-Dateien langsames Laden, Abstürze oder stille Fehler verursachen können. Das Apple TV 4K bewältigt dies viel besser.

Wenn Sie ein Apple TV HD verwenden, bevorzugen Sie gzip-komprimierte (.xml.gz) Guides – sie sind typischerweise 5–10x kleiner über die Leitung. Wenn Ihr Anbieter einen regionsspezifischen Guide anstelle eines globalen anbietet, verwenden Sie diesen anstelle der vollständigen Multi-Region-Datei. Es ist der einfachste Weg, sowohl die Download-Zeit als auch den Speicherbedarf zu reduzieren.

Catch-Up / Archiv-Flags und wie sie im Guide erscheinen

Einige M3U-Playlists enthalten Attribute wiecatchup="default",catchup-source, odertimeshift in den Kanaleinträgen. Wenn ein Player diese unterstützt, zeigt er im Guide-UI für vergangene Programme eine "Zurückspulen"- oder "Neu starten"-Schaltfläche an. Nicht alle tvOS-Player implementieren Catch-Up, und es erfordert sowohl die serverseitige Unterstützung als auch die richtigen M3U-Flags – das alleinige Vorhandensein des Attributs macht es nicht funktionsfähig, wenn der Stream es nicht unterstützt.

Logos, Beschreibungen und Kategoriedaten

Kanal-Logos stammen von dertvg-logo URL in der M3U. Programmbeschreibungen und Kategorien stammen aus der XMLTV-Datei selbst, typischerweise innerhalb von<desc> und<category> Tags pro Programm. Wenn Logos nicht geladen werden, bestätigen Sie, dass die URLs HTTPS sind. Wenn Beschreibungen im Guide fehlen, liegt das daran, dass der XMLTV-Anbieter sie nicht einfügt – der Player kann nur das anzeigen, was in der Datei enthalten ist.

Was nicht funktioniert (und warum)

Einige Dinge bringen die Leute konsequent durcheinander, wenn sie IPTV auf Apple TV verwalten: EPG-Konfiguration, die korrekt zu sein scheint, sich aber nicht wie erwartet verhält.

Erwartung, dass der Guide einen defekten Kanalstream repariert

Das EPG ist Metadaten. Es sagt Ihnen, was auf einem Kanal sein sollte – es hat keinen Einfluss darauf, ob der Stream tatsächlich abgespielt wird. Ein Kanal, der puffert, abbricht oder einen schwarzen Bildschirm zurückgibt, hat ein Problem auf Stream-Ebene. Das Reparieren des Guides hilft nicht. Dies sind völlig separate Systeme.

Einen Guide von einer anderen Kanalquelle verwenden

Eine generische XMLTV-Datei von einem Drittanbieter-EPG-Aggregator wird nicht mit Ihrer Playlist übereinstimmen, es sei denn, dietvg-id Werte in Ihrer M3U wurden speziell so festgelegt, dass sie mit den Kanal-IDs dieses Aggregators übereinstimmen. Die meiste Zeit war das nicht der Fall, sodass Sie einen leeren Guide erhalten, obwohl beide Dateien technisch gültig sind. Die XMLTV-Quelle muss mit den Kanal-IDs in Ihrer spezifischen M3U übereinstimmen. Es gibt keinen Workaround dafür auf der Apple TV-Seite.

Manuelles Bearbeiten des Guides auf dem Apple TV selbst

tvOS bietet Ihnen keine Möglichkeit, Guide-Einträge manuell zu bearbeiten, Kanal-IDs neu zuzuordnen oder einzelne Einträge zu überschreiben. Alles muss upstream korrigiert werden – in der M3U-Datei oder der XMLTV-Quelle. Wenn ein Kanal falsche Guide-Daten hat, muss diese Korrektur erfolgen, bevor die Dateien das Apple TV erreichen. Keine Player-App auf tvOS bietet Funktionen zum Bearbeiten des Guides; es ist keine Einschränkung einer bestimmten App, es ist einfach, wie die Plattform funktioniert.