Programmführer (EPG)

Was die Funktion leistet

Ein Gast, der die Guide-Taste drückt, erwartet zu sehen, was jetzt läuft, was als Nächstes kommt und was heute Abend läuft. Ohne Programminformationen zeigt das Fernsehgerät ein leeres Raster — und das fällt auf eine Weise auf, wie es die meisten Fehler einer Kopfstation nicht tun.

Castmux füllt ihn aus XMLTV, dem gängigen Austauschformat für Programmdaten. Sie fügen eine oder mehrere XMLTV-Quellen hinzu und ordnen jeden Sender seinem Eintrag im Guide zu. Ab dann hält das Gerät die Programmdaten aktuell und sendet sie als DVB Event Information Tables (EIT) an die Fernsehgeräte, genau wie ein Sendeunternehmen. Eine Set-Top-Box braucht keinerlei Konfiguration, um sie anzuzeigen.

Alles wird auf der Seite EPG der Weboberfläche eingerichtet.

Eine Guide-Quelle hinzufügen

Eine Quelle ist die URL einer XMLTV-Datei, wie sie ein Anbieter von Programmdaten veröffentlicht. Komprimierte Guides (.gz) werden unverändert akzeptiert.

Beim Hinzufügen einer Quelle ruft Castmux sie ab und liest ihre Senderliste: für jeden Sender die Guide-Kennung (zum Beispiel rtl.de) und den Anzeigenamen. Die Sendungen selbst werden dabei noch nicht gespeichert. Eine XMLTV-Datei kann Hunderte Megabyte groß sein, und Sendungen für Sender, die niemand zugeordnet hat, sind den Speicherplatz nicht wert.

Eine Quelle lässt sich umbenennen, auf eine neue URL umstellen oder löschen. Beim Löschen einer Quelle werden ihre gespeicherten Programmdaten entfernt. Sender, die ihr zugeordnet sind, behalten ihre Guide-Kennung, bis Sie sie löschen. Eine Ersatzquelle mit denselben Kennungen macht also dort weiter, wo die alte aufgehört hat.

Sender zuordnen

Jeder Sender wird einer Guide-Kennung aus den importierten Listen zugeordnet. Die EPG-Seite schlägt die Kennungen während der Eingabe vor. Die Zuordnung wird am Sender selbst gespeichert, als epg_id in der Konfigurationsdatei, und wird deshalb zusammen mit den übrigen Einstellungen des Senders gesichert und wiederhergestellt.

Ein Sender ohne Zuordnung überträgt keine Programmdaten. Die Zuordnung erfolgt pro Sender; eine Installation kann also die Sender zuordnen, für die es Programmdaten gibt, und die übrigen unverändert lassen.

Den Programmführer aktuell halten

Jede Quelle wird einmal pro Stunde neu abgerufen. Bei jeder Synchronisierung werden Sendungen nur für Guide-Kennungen gespeichert, denen mindestens ein Sender zugeordnet ist. Alles andere in der Datei wird gelesen und verworfen, ohne die Festplatte zu berühren. Beendete Sendungen werden entfernt, sodass der Speicher nur enthält, was jetzt läuft und was noch kommt.

Sync now an einer Quelle ruft sie sofort ab und meldet das tatsächliche Ergebnis. Diese Schaltfläche verwenden Sie nach dem Hinzufügen einer Quelle oder dem Ändern einer Zuordnung. Bei einem großen Guide kann das einige Minuten dauern.

Die Programmdaten liegen in einer kleinen Datenbankdatei, epg.db, neben der Konfigurationsdatei.

Was die Fernsehgeräte empfangen

Für jeden zugeordneten Sender schreibt das Gerät die laufenden und kommenden Sendungen als EIT und fügt sie dem Transport Stream des Senders hinzu. Das umfasst sowohl die Jetzt-und-Danach-Information als auch das weiter vorausliegende Programm. Es funktioniert am Multicast-Ausgang und bei DVB-C: Ein Sender in einem Multiplex behält seine EIT, umnummeriert auf seinen Service in diesem Multiplex.

Die wissenswerten Details:

Die Sendezeiten richten sich nach der Uhr des Geräts. Halten Sie die Uhrzeit des Geräts korrekt, zum Beispiel per NTP. Eine falsche Systemuhr zeigt auf jedem Fernsehgerät die falsche Sendung als „jetzt“.
Aktualisierungen erreichen laufende Sender ohne Neustart. Die EIT wird neu eingelesen, sobald sich die Programmdaten ändern. Eine stündliche Synchronisierung ist so innerhalb von Sekunden auf dem Bildschirm, und kein Sender wird unterbrochen.
Ein neu zugeordneter Sender überträgt EIT ab seinem nächsten Start. Ordnen Sie den Sender zu, führen Sie Sync now aus und starten Sie den Sender dann neu: Schalten Sie ihn aus und wieder ein, oder rufen Sie POST /api/channels/{id}/restart auf.
Ein zugeordneter Sender ohne Sendungen zeigt eine beschriftete Lücke. Hat der Guide für einen Sender noch nichts oder führt ihn nicht mehr, zeigt das Fernsehgerät statt eines leeren Programmführers „No information available“ in Blöcken zu vier Stunden, und der Sender läuft weiter.
Akzentbuchstaben brauchen den richtigen Zeichensatz. Standardmäßig wird der Guide-Text im DVB-Standardzeichensatz kodiert, den manche Receiver falsch dekodieren, typischerweise als kaputte Umlaute. Stellen Sie den EPG-Zeichensatz in Settings (epg_charset unter global.dvb) auf das ein, was die Receiver der Installation erwarten. ISO-8859-15 ist für Westeuropa richtig; ein moderner Gerätebestand kann UTF-8 verwenden.

In der Weboberfläche

Auf der Seite Channels zeigt die Karte jedes zugeordneten Senders, was jetzt läuft und was als Nächstes kommt. So können Sie eine Zuordnung prüfen, ohne ein Fernsehgerät zur Hand zu haben. Ein zugeordneter Sender, bei dem gerade nichts läuft, zeigt das an — das ist kein Fehler: Guides haben Lücken.

Die EPG-Seite listet jede Quelle mit dem Zeitpunkt ihres letzten Abrufs und dessen Erfolg auf. Dort sehen Sie zuerst nach, wenn der Programmführer auf den Fernsehgeräten nicht mehr weiterläuft.