Xmltv2vdr-plugin
Aus VDR Wiki
Inhaltsverzeichnis |
Beschreibung
Das xmltv2vdr Plugin importiert EPG-Daten im xmltv-Format in den VDR.
Status
Letztes Update 05/2012
Softwareanforderungen
- libxml2
- libsqlite3
- libpcre
Konfiguration
OSD
Die Konfiguration erfolgt ausschließlich 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)
<?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.
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