Xmltv2vdr-plugin

Aktuelle Version

Version 0.1.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, libsqlite3, libpcre

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.

Parameter

Parameter	Beschreibung
-e <episode directory>	legt das Verzeichnis für Episodendateien fest (eplists)
-E <epgfile>	legt die zu verwendende VDR EPG-Datei fest
-i <image directory>	legt das Verzeichnis für EPG-Bilder fest
-l <logfile>	verwendet eine Logdatei anstelle syslog

EPG-Quellen (Beschreibung für Benutzer)

Konfiguration und Anwendung von EPG-Quellen werden hier nicht behandelt oder beschrieben! Diese Programme sind aus rechtlichen Gründen (siehe VG_Media) nicht Bestandteil des xmltv2vdr Plugins!

Schnittstelle zu EPG-Quellen (Beschreibung für Programmierer)

Die 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 werden können
• Die ausführbare Datei (oder das Skript) muss im Pfad liegen und genauso heissen wie die Datei im Verzeichnis /var/lib/epgsources. Der Aufruf erfolgt mit folgenden Parametern: Anzahl Tage, PIN, Bilder holen ja/nein, Kanalnamen (um z.B. 5 Tage, ohne PIN und Bilder für ARD und ZDF zu holen gilt folgender Aufruf: 5 ‘‘ 0 ard.de zdf.de)
• 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: Sendername 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). Daran anschließend kann optional die Uhrzeit, zu welcher die EPG-Quelldaten aktualisiert werden und dahinter ein Flag stehen, ob die Quelle eine Pin benötigt oder nicht (0/1). Hinter dem Flag für die PIN wird angegeben, ob die Quelle Bilder bereitstellen kann (0/1)
• In Zeile zwei die Anzahl der maximal von der EPG-Quelle zur Verfügung gestellten Tage.
• 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 - wird vom Plugin nicht ausgewertet!)

Beispiele für Steuerdateien:

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

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

file
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

13th-street.de
3sat.de
9live.de
alpengluehen-tvx.de
animal-planet.de
animax.de
anixe.de
ard.de
arte.de
atv-avrupa.tr
atvplus.at
austria9.at
automotorsportchannel.de
axntv.de
baby-tv.de
bayern3.de
beate-uhse-tv.de
bibeltv.de
bloombergtv.de
blue-movie-1.de
blue-movie-2.de
blue-movie-3.de
boomerang-tv.de
br-alpha.de
cartoon-network.de
classica.de
cnn.de
comedy-central.de
das-vierte.de
detski-mir.ru
discovery-channel.de
discovery-geschichte.de
discovery-hd.de
disney-channel.de
disney-cinemagic.de
disney-xd.de
dk1.dk
dk2.dk
dmax.de
dsf.de
einsextra.de
einsfestival.de
einsmuxx.de
entertainment.de
espn-classic-sport.com
euro-star.tr
euronews.de
eurosport-2.de
eurosport.de
fashiontv.fr
focus-gesundheit.de
fox-channel.de
goldstar-tv.de
gotv.at
gute-laune-tv.de
heimatkanal.de
hessen3.de
hh1.de
history-channel.de
history-hd.de
hse24.de
imusic1.de
itvn.pl
junior.de
k-tv.at
kabel-eins-classics.de
kabel1.de
kanal-7-int.tr
kika.de
kinowelt-tv.de
ligtv.tr
lust-pur.de
mcm-top.fr
mdr.de
mezzotv.fr
mgm.de
motors-tv.fr
motorvision-tv.de
mtv-base.de
mtv-dance.uk
mtv-entertainment.de
mtv-hits.uk
mtv-music.de
mtv.de
muenchen-2.de
n24.de
nashe-kino.ru
national-geographic-wild.de
national-geographic.de
ndr.de
nicktoons.de
nickcomedy.de
nl1.nl
nl2.nl
nl3.nl
nrwtv.de
ntv.de
okto-tv.at
orf1.at
orf2.at
phoenix.de
planet.de
playboy.de
playhouse-disney.de
prosieben.de
puls4.at
qvc.de
rbb.de
rhein-neckar-fernsehen.de
romance-tv.de
rtl-crime.de
rtl-living.de
rtl-nitro.de
rtl-passion.de
rtl.de
rtl2.de
rtlshop.de
rtr-planeta.ru
rtvi.ru
sailing-channel.it
sat1-comedy.de
sat1-emotions.de
sat1.de
sci-fi.de
sf1.ch
sf2.ch
show-turk.tr
silverline-tv.de
sixx.de
sky-action.de
sky-atlantic-hd.de
sky-cinema-1.de
sky-cinema-24.de
sky-cinema-hits.de
sky-cinema.de
sky-comedy.de
sky-emotion.de
sky-fussball-bundesliga.de
sky-krimi.de
sky-nostalgie.de
sky-select.de
sky-sport-1.de
sky-sport-2.de
sky-sport-austria.at
sonnenklartv.de
spiegel-geschichte.de
spiegel-tv.de
sportdigitaltv.de
superrtl.de
swr.de
tele5.de
tgrt-eu.de
the-biography-channel.de
tier-tv.de
timm.de
tnt-film.de
tnt-serie.de
tracetv.fr
tuerkmax.tr
turner-classic-movies.de
tv-berlin.de
tv-gusto-premium.de
tv-muenchen.de
tv-polonia.pl
tv5.de
tvp-info.pl
tvp-kultura.pl
tw1.at
vh1-classic.eu
viva.de
vox.de
wdr.de
wetter-fernsehen.de
yavido.de
yourfamilyentertainment.de
zdfkultur.de,zdf-theaterkanal.de
zdf.de
zdfinfo.de
zdfneo.de

Links

1. Plugin-Homepage
2. XMLTV Homepage