Xmltv2vdr-plugin

Beschreibung

Das xmltv2vdr Plugin importiert EPG-Daten im xmltv-Format in den VDR.

Status

Letztes Update 05/2012

Hinweis

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

Konfiguration

OSD

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.

Hinweis zum Einstellen des Parameters 'Ausführung am:' im OSD: Die einzelnen Tage (MDMDFSS) können durch Drücken der Zifferntasten 1-7 umgeschaltet werden. Die mögliche Auswahl eines Datums ist in den aktuellen Versionen (bis 0.1.1) zu ignorieren.

Parameter

Parameter	Beschreibung
-e <episode directory>	legt das Verzeichnis für Episodendateien wie eplists fest (Standard: $HOME/.eplists/lists)
-E <epgfile>	legt die zu verwendende EPG-Datenbankdatei fest (Standard: $VIDEODIR/epg.db)
-i <image directory>	legt das Verzeichnis für EPG-Bilder fest (Standard: /var/cache/vdr/epgimages)
-l <logfile>	protokolliert in eine Logdatei (Standard: syslog)

Schnittstelle zu EPG-Quellen

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)
• Der Return-Code der ausführbaren Datei wird vom xmltv2vdr benutzt, um zu erfahren ob es ein Fehler im Grabber gab. Die Zahl 0 bedeutet alles in Ordnung; eine Zahl zwischen 1 und 126 bedeutet dass ein Fehler im Grabber aufgetreten ist. In letzterem Falle macht xmltv2vdr zwei weitere Versuche den Grabber aufzurufen, mit jeweils eine Minute Pause zwischen den Aufrufen.
• 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. Eine Überprüfung des Formats kann mit tv_validate_file (http://wiki.xmltv.org/index.php/XmltvValidation) erfolgen.
• 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 EPG-Senderliste

Bei Erweiterung dieser Liste unbedingt folgendes Schema verwenden:

• Sender gefolgt von einem Punkt und der Länderkennung, z.B. "rtl.de" oder "orf.at".
• Nur 7-Bit ASCII Zeichen.
• Neue Einträge bitte alphabetisch einsortieren.

Verbindliche EPG-Senderliste

13th-street.de
3plus.ch
3sat-HD.de
3sat.de
9live.de
a-and-e.de
adult-channel.com
ae-tv.de
alpengluehen-tvx.de
animal-planet.de
animax.de
anixe-HD.de
anixe.de
ard-alpha.de
ard.de
arte-HD.de
arte.de
atv-avrupa.tr
atv.at
atv2.at
atvplus.at
austria9.at
automotorsportchannel.de
axntv.de
baby-tv.de
bayern3.de
bbc-alba.uk
bbc-entertainment.dk
bbc-four.uk
bbc-news.uk
bbc-one.uk
bbc-parliament.uk
bbc-three.uk
bbc-two-scotland.uk
bbcworld.uk
beate-uhse-tv.de
belgien.be
bibeltv.de
bloombergtv.de
blue-movie-1.de
blue-movie-2.de
blue-movie-3.de
bongusto.de
boomerang-tv.de
br-alpha.de
cartoon-network.de
cartoon-network.uk
cbeebies.uk
center.tv
channel-4-HD.uk
channel-4.uk
channel-5.uk
classica.de
cnn.de
comedy-central.de
das-erste-HD.de
das-erste.de
das-neue-tv.de
das-vierte.de
deluxe-music.de
detski-mir.ru
deutsches-anleger-fernsehen.de
deutsches-wetter-fernsehen.de
discovery-channel.de
discovery-geschichte.de
discovery-hd.de
disney-channel.de
disney-cinemagic.de
disney-junior.de
disney-xd.de
dk1.dk
dk2.dk
dmax.de
dr1.dk
dsf.de
dw.de
e-entertainment-television.de
einsextra.de
einsfestival-HD.de
einsfestival.de
einsmuxx.de
einsplus.de
entertainment.de
erf-1.de
espn-america.com
espn-classic-sport.com
euro-star.tr
euronews.de
euronews.fr
eurosport-2.de
eurosport.de
extreme-sports-channel.de
family-tv.de
fashiontv.fr
focus-gesundheit.de
fox-channel.de
ftl-tv.de
geo-television.de
glitz.de
goldstar-tv.de
gotv.at
gute-laune-tv.de
hamburg-1.de
heimatkanal.de
hessen3.de
hh1.de
history-channel.de
history-hd.de
hse24.de
imusic1.de
itv-2-HD.uk
itv-3-HD.uk
itv-4-HD.uk
itvn.pl
joiz.de
jukebox.de
junior.de
k-tv.at
kabel-eins-classics.de
kabel1-HD.de
kabel1.de
kanal-7-int.tr
kika-HD.de
kika.de
kinowelt-tv.de
ligtv.tr
lust-pur.de
mcm-top.fr
mdr.de
mezzotv.fr
mgm.de
more-than-movies.uk
motors-tv.fr
motorvision-tv.de
movies-4-men.uk
mtv-base.de
mtv-dance.uk
mtv-entertainment.de
mtv-hits.uk
mtv-live.uk
mtv-music.de
mtv.de
muenchen-2.de
n24-HD.de
n24.de
nashe-kino.ru
nat-geo-people.de
national-geographic-wild.de
national-geographic.de
nautical-channel.com
ndr-HD.de
ndr.de
nick-jr.de
nickcomedy.de
nickelodeon.de
nicktoons.de
nl1.nl
nl2.nl
nl3.nl
nrwtv.de
ntv.de
okto-tv.at
orf-sport.at
orf1.at
orf2.at
orf3.at
phoenix.de
planet.de
playboy.de
playhouse-disney.de
prosieben-fun.de
prosieben-HD.de
prosieben-maxx.de
prosieben.de
puls4.at
qvc.de
radio-bremen-tv.de
rbb.de
rcktv.de
rhein-neckar-fernsehen.de
ric.de
romance-tv.de
rtl-crime.de
rtl-HD.de
rtl-living.de
rtl-nitro.de
rtl-passion.de
rtl.de
rtl2-HD.de
rtl2.de
rtlshop.de
rtr-planeta.ru
rtvi.ru
sailing-channel.it
sat1-comedy.de
sat1-emotions.de
sat1-gold.de
sat1-HD.de
sat1.de
sci-fi.de
servustv-HD.at
servustv.at
sf1.ch
sf2.ch
show-turk.tr
silverline-tv.de
sixx-HD.de
sixx.de
sky-3d.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-hd.de
sky-sport-1.de
sky-sport-2-hd.de
sky-sport-2.de
sky-sport-austria.at
sky-sport-extra-hd.de
sky-sport-news-hd.de
sonnenklartv.de
sony-entertainmen.tv
spiegel-geschichte.de
spiegel-tv-wissen.de
spiegel-tv.de
sport1-HD.de
sport1.de
sport1plus.de
sport1US.de
sportdigitaltv.de
star-tv.ch
superrtl-HD.de
superrtl.de
swr-HD.de
swr.de
tagesschau24.de
tele5-HD.de
tele5.de
tgrt-eu.de
the-biography-channel.de
tier-tv.de
timm.de
tlc.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
tv2.tr
tv5-monde.fr
tv5.de
tvp-info.pl
tvp-kultura.pl
tw1.at
universal-channel.de
vh1-classic.eu
vh1-classic.uk
viva.de
vox-HD.de
vox.de
wdr-HD.de
wdr.de
welt-der-wunder-tv.de
wetter-fernsehen.de
yavido.de
yourfamilyentertainment.de
zdf-HD.de
zdf-theaterkanal.de
zdf.de
zdfinfo-HD.de
zdfinfo.de
zdfkultur-HD.de
zdfkultur.de
zdfneo-HD.de
zdfneo.de

Aktuelle Version

Version 0.1.1

Links

1. Plugin-Homepage
2. XMLTV Homepage