Xmltv2vdr-plugin

Aktuelle Version

Version 0.0.1

Beschreibung

Das xmltv2vdr Plugin importiert EPG-Daten im xmltv-Format in den VDR. Die EPG-Daten müssen von externen Programmen im xmltv-Format bereitgestellt werden.

Diese Programme sind aus rechtlichen Gründen (siehe VG_Media) nicht Bestandteil des xmltv2vdr Plugins!

Softwareanforderungen

libxml2

VDR >= 1.6.0

Konfiguration

Die Konfiguration erfolgt ausschliesslich per OSD (Plugin-Einstellungen). Dort können Kanäle der Quellen ausgewählt und diese an VDR-Kanäle zugewiesen werden.

Schnittstelle zu EPG-Quellen

Die nicht bei xmltv2vdr enthaltenen EPG-Quellen müssen sich an folgende Schnittstelle halten:

• Jede Quelle muss im Verzeichnis /var/lib/epgsources eine Datei ablegen, die Steueranweisungen und eine Kanalliste der von der Quelle angebotenen Kanäle enthält. Die Datei darf keine Extension haben und muss vom VDR-Benutzer gelesen und geschrieben werden können
• Soll die EPG-Quelle von xmltv2vdr aufgerufen werden, so muss die ausführbare Datei (oder das Skript) im Pfad liegen und genauso heissen wie die Datei im Verzeichnis /var/lib/epgsources
• Die per pipe oder file angelieferten EPG-Daten müssen im gültigen xmltv-Format sein (siehe auch Aufbau der xmltv-Datei)
• Die Kanalnamen in der xmltv-Datei sind fest und unabänderlich um eine Mehrfachzuweisung verschiedener Quellen zu verhindern (siehe Kanalliste). Dabei wird folgendes Schema verwendet: Sender gefolgt von einem Punkt und der Länderkennung, z.B. rtl.de oder orf.at

Aufbau der Steuerdatei

• In der ersten Zeile steht entweder file oder pipe, bei file erwartet xmltv2vdr eine Datei in /var/lib/epgsources, die den Namen der Quelle trägt mit Extension .xmltv (also z.B. epgdata -> epgdata.xmltv)
• In Zeile zwei steht die Anzahl der vom Plugin erwarteten Tage (eingestellt vom OSD), dahinter strichkommagetrennt die Anzahl der maximal von der EPG-Quelle zur Verfügung gestellten Tage. Beim erstmaligen Anlegen der Datei sollte die Anzahl Tage für das Plugin auf 1 gestellt sein.
• Es folgt eine Liste mit Kanalnamen (siehe Kanalliste), die je nach EPG-Quelle auch eine Zuweisung auf einen Kanal der EPG-Quelle enthalten kann (strichkommagetrennt vom Kanalnamen)

Beispiele für Steuerdateien:

pipe
1;16
rtl.de;004
sat1.de;005
prosieben.de;006

pipe
1;10
rtl.de
sat1.de
prosieben.de

file
1;7
rtl.de;004
sat1.de;005
nickcomedy.de;190:625

Aufbau der xmltv-Datei

• Die Eingabedatei, die per pipe oder file an das Plugin angeliefert wird, muss im gültigen Format vorliegen. Dies kann man anhand von tv_validate_file (http://wiki.xmltv.org/index.php/XmltvValidation) überprüfen.
• Es gibt für die Event-ID eine Erweiterung des Formats, die obigen Validator nicht beeinträchtigt: die rein numerische Event-ID wird einfach als weitere Kategorie angehängt (siehe Beispiel)

Beispiel einer gültigen xmltv-Datei:

<?xml version="1.0" encoding="utf-8"?>
<tv generator-info-name="tvm2xmltv">
<channel id="rtl.de">
<display-name lang="de">rtl.de</display-name>
</channel>
<programme start="20110103002500 +0000" stop="20110103015500 +0000" channel="rtl.de" showview="6-851-241">
<title lang="de">Samba in Mettmann</title>
<title>Samba in Mettmann</title>
<desc lang="de">Eine attraktive Verlobte, ein sicherer Job ...</desc>
<credits>
<director>Angelo Colagrossi</director>
<actor>Doris Kunstmann</actor>
<actor>Hape Kerkeling</actor>
<writer>Angelo Colagrossi</writer>
<writer>Hape Kerkeling</writer>
<producer>Amo Müller</producer>
<producer>Matthias Wendlandt</producer>
<composer>Darius Zahir</composer>
<editor>Sabine Brose</editor>
</credits>
<date>2003</date>
<category lang="de">Spielfilm</category>
<category lang="de">Komödie</category>
<category lang="de">16023614</category>
<country>D</country>
<video>
<aspect>16:9</aspect>
</video>
<audio>
<stereo>dolby</stereo>
</audio>
<rating system="FSK"><value>6</value></rating>
<review type="text">Schade - Hape kanns eigentlich besser!</review>
</programme>
</tv>

Verbindliche Kanalliste

Bei Erweiterung dieser Liste unbedingt folgendes Schema verwenden: Sender gefolgt von einem Punkt und der Länderkennung, z.B. rtl.de oder orf.at

rtl.de
sat1.de
prosieben.de
kabel1.de
rtl2.de
vox.de
das-vierte.de
tele5.de
superrtl.de
nickcomedy.de

Links

1. Plugin-Homepage
2. XMLTV Homepage