Xmltv2vdr-plugin

Version vom 23. Februar 2013, 17:33 Uhr (Quelltext anzeigen) Keine Ahnung (Diskussion | Beiträge) K (→‎Verbindliche Kanalliste: Fehlende aus der tvm2xmltv hinzugefügt) ← Zum vorherigen Versionsunterschied		Version vom 28. März 2013, 07:00 Uhr (Quelltext anzeigen) Wyse (Diskussion | Beiträge) (→‎Verbindliche Kanalliste) Zum nächsten Versionsunterschied →
Zeile 271:		Zeile 271:
	sky-select.de		sky-select.de
	sky-sport-1.de		sky-sport-1.de
		+	sky-sport-1-hd.de
	sky-sport-2.de		sky-sport-2.de
		+	sky-sport-2-hd.de
	sky-sport-austria.at		sky-sport-austria.at
		+	sky-sport-extra-hd.de
		+	sky-sport-news-hd.de
	sonnenklartv.de		sonnenklartv.de
	spiegel-geschichte.de		spiegel-geschichte.de
	spiegel-tv.de		spiegel-tv.de
	sport1.de		sport1.de
		+	sport1plus.de
	sportdigitaltv.de		sportdigitaltv.de
	superrtl.de		superrtl.de

---

Version vom 28. März 2013, 07:00 Uhr

Inhaltsverzeichnis 1 Aktuelle Version 2 Beschreibung 3 Softwareanforderungen 4 Konfiguration 4.1 OSD 4.2 Parameter 5 EPG-Quellen (Beschreibung für Benutzer) 6 Schnittstelle zu EPG-Quellen (Beschreibung für Programmierer) 6.1 Aufbau der Steuerdatei 6.2 Aufbau der xmltv-Datei 6.3 Verbindliche Kanalliste 7 Links

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

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 getoggelt werden. Die mögliche Auswahl eines Datums ist in den aktuellen Versionen (bisher 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)

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)
• 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. 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". Dabei sollten nur 7-Bit ASCII Zeichen verwendet werden. Neue Einträge bitte Alphabetisch einsortieren.

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
bbcworld.uk
beate-uhse-tv.de
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
classica.de
cnn.de
comedy-central.de
das-vierte.de
deluxe-music.de
detski-mir.ru
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
dsf.de
e-entertainment-television.de
einsextra.de
einsfestival.de
einsmuxx.de
einsplus.de
entertainment.de
espn-america.com
espn-classic-sport.com
euro-star.tr
euronews.de
eurosport-2.de
eurosport.de
extreme-sports-channel.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
nickcomedy.de
nicktoons.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-gold.de
sat1.de
sci-fi.de
servustv.at
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-1-hd.de
sky-sport-2.de
sky-sport-2-hd.de
sky-sport-austria.at
sky-sport-extra-hd.de
sky-sport-news-hd.de
sonnenklartv.de
spiegel-geschichte.de
spiegel-tv.de
sport1.de
sport1plus.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
vh1-classic.uk
viva.de
vox.de
wdr.de
wetter-fernsehen.de
yavido.de
yourfamilyentertainment.de
zdf-theaterkanal.de
zdf.de
zdfinfo.de
zdfkultur.de
zdfneo.de

Links

1. Plugin-Homepage
2. XMLTV Homepage