Xmltv2vdr-plugin
Dad401 (Diskussion | Beiträge) K (→Schnittstelle zu EPG-Quellen (Beschreibung für Programmierer)) |
Dad401 (Diskussion | Beiträge) K |
||
Zeile 13: | Zeile 13: | ||
==Konfiguration== | ==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. | 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=== | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | !Parameter | ||
+ | !Beschreibung | ||
+ | |- | ||
+ | | -e <episode directory> || legt das Verzeichnis für Episodendateien fest ([http://eplists.constabel.net 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)== | ==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 {{wikipedia|VG_Media}}) nicht Bestandteil des xmltv2vdr Plugins!''' | Konfiguration und Anwendung von EPG-Quellen werden hier nicht behandelt oder beschrieben! '''Diese Programme sind aus rechtlichen Gründen (siehe {{wikipedia|VG_Media}}) nicht Bestandteil des xmltv2vdr Plugins!''' |
Version vom 31. August 2012, 00:12 Uhr
Inhaltsverzeichnis |
Aktuelle Version
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