man epgsearch (1): Suchtimer und Ersatz fu.r VDR's Standard-Programm-Menu.

BESCHREIBUNG

EPG-Search kann als Ersatz fu.r VDR's Standard-Programm-Menu. verwendet werden. Es sieht genauso aus, erweitert es aber um einige zusa.tzliche Funktionen.

Ein weiterer Punkt sind die sog. Suchtimer die dafu.r sorgen, dass Timer automatisch programmiert werden.

 - Befehle fu.r EPG-Eintra.ge mit verschiedenen integrierten Befehlen wie
   z.B. 'Wiederholungen anzeigen', 'Suche anlegen'. Man kann eigene
   Befehle hinzufu.gen, um z.B. einen VDRAdmin Autotimer anzulegen.
 - Bis zu 4 weitere Zeitpunkte im Menu. 'Was la.uft jetzt?' neben 'Jetzt'
   und 'Na.chste', sowie ein optionales Favoritenmenu..
 - Suche im EPG: Anlegen von wiederverwendbaren Abfragen, die auch als
   'Suchtimer' verwendet werden ko.nnen.
 - Suchtimer: Sucht im Hintergrund nach Sendungen und erzeugt einen
   Timer bei passenden EPG-Eintra.gen (a.hnlich zu VDRAdmins Autotimern)
   oder informiert u.ber die Sendung via OSD.
 - Vermeidung von doppelten Aufnahmen der gleichen Sendung
   * Timer-Vorschau
   * Erkennung abgebrochener Aufnahmen
   * Fuzzy-Vergleich von Sendungen
 - Fortschrittsbalken in 'Jetzt' und 'Na.chste'
 - Zeit im Menu. 'Jetzt', 'Na.chste' kann per Tastendruck verschoben
   werden,  z.B. was la.uft 'Jetzt' + 30 Minuten
 - Startmenu. 'Programm' oder 'Jetzt' einstellbar.
 - das Menu. zur detaillierten EPG-Anzeige (Zusammenfassung) erlaubt den
   Sprung zur vorherigen/na.chsten Sendung
 - Unterstu.tzung erweiterter EPG-Infos in Suchtimern
 - Erweiterung des Timer-Edit-Menu.s um Verzeichnisse,
   benutzerdefinierte Wochentage und Untertitel-Auswahl
 - Timer Konfliktcheck, informiert u.ber OSD-Meldung
 - Timer Konfliktmenu., zeigt die Konflikte an und erleichtert die
   Konfliktlo.sung
 - Email-Benachrichtigungen u.ber Suchtimer-Updates und Timer-Konflikte

Teile der Quelltexte basieren auf dem repeating-epg-patch von Gerhard Steiner, der mir die Erlaubnis gab, diese zu verwenden. Danke fu.r seine Arbeit!

OPTIONEN

-f file, --svdrpsendcmd=file: Pfad zu svdrpsend fu.r externe SVDRP-Kommunikation (Standard ist interne Kommunikation, deshalb ist dieser Paramter normalerweise nicht notwendig)
-c path, --config=path: zur Angabe eines eigenen Konfigurationsverzeichnisses fu.r alle epgsearch-Dateien, Standard ist '<Plugin-Konfig-Verzeichnis>/epgsearch'
-l file, --logfile=file: zur Angabe eines abweichenden Dateipfades fu.r epgsearch's Log-File (Standard ist epgsearch.log in epgsearch's Konfig-Verzeichnis)
-v n, --verbose=n: verbose level fu.r das Log-File. Wert 0 bedeutet kein Logging. Weiter Werte sind 1 (allgemeine Meldungen), 2 (detaillierte Meldungen), 3 (fu.r Debug-Zwecke)
-r, --reloadmenuconf: bewirkt ein Neuladen der epgsearchmenu.conf bei jedem Plugin-Aufruf am OSD. Kann fu.r das Testen eines selbst angepaβten Menu.-Layouts praktisch sein.
-m file, --mailcmd=file: das externe Kommando fu.r den Emailversand. Als Standard wird 'sendEmail.pl' benutzt. Wenn ein abweichendes Kommando oder Skript verwendet wird, muss sichergestellt sein, dass das gleiche Paramter-Interface verwendet wird, wie bei sendEmail.pl.

Inhalt

 1.    Beschreibung
 1.1     Menu. Befehle
 1.2     Menu. Suche
 1.2.1     Menu. Suche editieren
 1.2.2     Menu. Suchergebnisse
 1.3     Erweitertes 'Jetzt' und 'Na.chste'
 1.4     Menu. Setup
 23.    Suchtimer
 2.1     'Wiederholungen vermeiden' - Im Detail
 2.2     Wie funktioniert der Vergleichstest zwischen 2 Sendungen?
 2.3     Wie und wo wird der Vergleichstest eingesetzt?
 3.    Verwendung der Suche durch andere Plugins oder Skripte
 4.    Verwendung erweiterter EPG Infos
 5.    Ersetzen des Standardmenu.
 6.    Addons

1. Beschreibung

Auf den ersten Blick sieht EPG-Search wie der Programm-Menu.-Punkt des VDR aus. Ein Tastendruck auf '0' schaltet die Farbtasten um, so dass weitere Funktionen erreicht werden ko.nnen (die vorgegebene Zuweisung kann per Setup angepasst werden):

1.1 Menu. Befehle

Dieses Menu. zeigt Befehle an, die auf den ausgewa.hlten Menu.eintrag angewandt werden ko.nnen. Es gibt 8 vorgegebene Befehle:

 - Wiederholung: Zeigt Wiederholungen an
 - Aufnehmen
 - Umschalten
 - Suche anlegen: schaltet zum Suchmenu. und erzeugt eine Suche mit dem
   Namen der aktuellen Sendung als Suchbegriff (um die manuelle Erfassung
   zu vermeiden
 - Suche in Aufnahmen: durchsucht die Aufnahmen nach einer Sendung mit
   diesem Namen
 - Als 'bereits aufgezeichnet' markieren:
   Hiermit wird die ausgewa.hlte Sendung in die Datei epgsearchdone.data
   u.bernommen und epgsearch angewiesen, diese Sendung nicht aufzunehmen, falls
   der zugeho.rige Suchtimer mit "Wiederholung vermeiden" geschaltet ist. Ein
   bereits erzeugter Timer wird beim na.chsten Suchtimer-Update automatisch
   gelo.scht.
 - In/Aus Umschaltliste?:
   Zum Bearbeiten der Umschaltliste. Wenn eine Sendung in der Umschaltliste
   enthalten ist, wird kurz vor Beginn eine Anku.ndigung eingeblendet und dann
   umgeschaltet. Um die gesamte Umschaltliste einzusehen, bitte
   'Suche/Aktionen/Zeige Umschaltliste' aufrufen.
 - Erzeuge Ausschlussliste:
   Eine Ausschlussliste wird verwendet um bestimmte Sendungen bei der
   Verwendung von Suchtimern zu ignorieren. Ein Suchtimer kann beliebige
   Ausschlusslisten verwenden.

Man kann eigene Befehle hinzufu.gen, indem man die Datei epgsearchcmds.conf im epgsearch-Konfig-Verzeichnis editiert. Eine Beispiel-Datei mit Bespielscripts liegt dem Plugin bei (s. Unterverzeichnis 'scripts', stammt von vdr-wiki.de. Danke an die Autoren).

Das Format der Datei ist identisch zu VDRs commands.conf oder reccmds.conf. Wenn ein Befehl ausgefu.hrt wird, werden folgende Parameter u.bergeben:

 $1: Titel des Programmeintrags
 $2: Startzeit als time_t-Wert (wie im Shutdown-Skript)
 $3: Endzeit
 $4: Programmplatz
 $5: langer Kanalname
 $6: Untertitel des Programmeintrags, "" falls nicht vorhanden

Zum Ausfu.hren eines Befehls aus dem Hauptmenu. ohne O.ffnen des Befehlsmenu.s genu.gt es, die zugeho.rige Nummer des Befehls zu dru.cken.

1.2 Menu. Suche

Hier kann man eine Suche im EPG erzeugen, editieren, lo.schen und ausfu.hren. Bedienung und Verhalten ist a.hnlich zu VDR's Timer-Menu..

1.2.1 Menu. Suche editieren

Das meiste in diesem Menu. ist selbsterkla.rend, deshalb nur einige Anmerkungen zu:

- Suche:

Suchbegriff. Will man nach mehreren Worten suchen, dann bitte mit Leerzeichen trennen. La.sst man den Suchbegriff leer (in Verbindung mit Suchmodus 'Ausdruck') wird alles akzeptiert. Das kann praktisch sein, um z.B. alles zu suchen, was zu einer bestimmten Zeit auf einem bestimmten Sender kommt.

Mit 'Blau' kann man auch eine Vorlage fu.r eine Suche u.bernehmen. Falls eine Vorlage als Standard definiert wurde, wird bei einer neuen Suche automatisch der Inhalt der Standard-Vorlage verwendet.

Hinweis: Die unscharfe Suche ist auf 32 Zeichen begrenzt!

- Suchmodus:

'Ausdruck' sucht nach diesem Ausdruck innerhalb eines EPG-Eintrags. 'alle Worte' erfordert, dass jedes Wort im EPG-Eintrag vorkommt, 'ein Wort' dagegen nur, dass zumindest ein Wort auftaucht. 'exakt' vergleicht den gesamten Suchbegriff mit dem EPG-Eintrag (praktisch bei kurzen Titeln wie z.B. ``Alf''). 'regula.rer Ausdruck' erlaubt die Angabe eines regula.ren Ausdrucks zur Suche. Ein fu.hrender und abschlieβender '/' ist nicht notwendig. Als Standard werden POSIX extended regular expressions verwendet. Wer lieber mit Perl kompatiblen regula.ren Ausdru.cken arbeitet, muss lediglich im Makefile des Plugins #HAVE_PCREPOSIX=1 in HAVE_PCREPOSIX=1 a.ndern und neu kompilieren. (Dafu.r ist pcreposix notwendig, das mit libpcre von www.pcre.org installiert wird, aber auf den meisten Distributionen bereits vorhanden sein sollte).

Eine Beschreibung des Suchprozesses gibt es im MANUAL.

- Verw. Kennung fu.r Inhalt

Einige Provider liefern Kennungen fu.r den Inhalt einer Sendung, z.B. ``Film/Drama'', ``Dokumentation'',...(erst ab vdr-1.7.11 verfu.gbar) Hiermit ko.nnen diesen Kennungen ausgewa.hlt werden. Es ist auch eine Mehrfachauswahl mo.glich, die dann in allen Kennungen u.bereinstimmen muss (UND-Verknu.pfung).

- Verw. erweiterte EPG Info

(nur verfu.gbar, wenn konfiguriert. Siehe weiter unten 'Verwendung erweiterter EPG Infos')

- Ignoriere fehlende Kategorien

Wenn 'Ja' gewa.hlt ist, verhindert das, dass eine Sendung aus dem Suchergebnis ausgeschlossen wird, falls die entsprechende Kategorie nicht im EPG vorhanden ist. Vorsicht: Ohne weitere Suchkriterien kann das zu einer Flut von Timern fu.hren.

- Verw. Kanal:

sucht nur im angegebenen Kanalbereich, der hinterlegten Kanalgruppe, z.B. 'O.ffentl. Rechtl.' oder 'Sportsender'... oder in FTA-Sendern.

ACHTUNG: Nach einer A.nderung der Kanal-Reihenfolge sollten unbedingt diese Einstellungen der Suchtimer kontrolliert werden!

- Verwende Wochentag:

Neben den Wochentagen kann auch eine benutzerdefinierte Auswahl getroffen werden, um z.B. nur Montags und Freitags zu suchen.

Die benutzerdefinierte Auswahl findet sich am Ende der Liste Son, Mon, ..., Sam, benutzerdefiniert

- Verwende Ausschlusslisten:

Ausschlusslisten ko.nnen benutzt werden, um unerwu.nschte Sendungen auszuschlieβen. Hier ko.nnen nur globale, eine oder mehrere oder alle Ausschlusslisten selektiert werden. Falls ein Suchergebnis auch in einer der gewa.hlten Ausschlusslisten erscheint, wird es verworfen.

- In Favoritenmenu. verw.:

Nur verfu.gbar, wenn im Setup aktiviert. Mit dieser Option kann eine Suche zur Verwendung im Favoritenmenu. markiert werden. Dieses Menu. listet alle Suchergebnisse von Suchen mit dieser Option.

- Layout des Ergebnismenu.s:

Nur verfu.gbar, wenn mehr als eine Menu.vorlage fu.r Suchergebnisse in epgsearchmenu.conf angegeben wurde. Mit dieser Option kann ein anderes Layout fu.r die Suchergebnisse dieser Suche gewa.hlt werden.

- Verwende als Suchtimer:

falls ja, sucht das Plugin im Hintergrund nach passenden Sendungen und erzeugt dafu.r einen Timer (im Setup muss dazu die Verwendung von Suchtimern aktiv sein). Bei der Einstellung <benutzerdefiniert> la.βt sich u.ber die Taste 'Blau' ein Zeitfenster einstellen, in dem der Suchtimer aktiv sein soll.

- Aktion:

Standard ist 'Aufnehmen', also das Erzeugen eines Timers fu.r das Suchergebnis. Man kann aber auch wa.hlen, dass nur eine Anku.ndigung der Sendung per OSD vorgenommen werden soll, sobald diese gefunden wird. Eine weitere Mo.glichkeit ist 'nur umschalten'. Dadurch wird automatisch eine Minute vor Beginn der Sendung auf deren Kanal gewechselt. Ebenso kann mit 'Anku.ndigen und Umschalten' die Sendung vor ihrem Beginn angeku.ndigt werden und mit 'Ok' zum entsprechenden Kanal gewechselt werden.

- Serienaufnahme:

falls ja, wird die Aufnahme in einem Ordner mit dem Seriennamen gespeichert. Die Aufnahme selbst erha.lt den Episondennamen. Falls es keinen gibt, wird Datum und Uhrzeit als Episondenname verwendet.

- Verzeichnis:

hier kann man ein Verzeichnis angeben, in dem die Aufnahme gespeichert wird, z.B. 'SciFi'. Mit der Taste 'Blau' kann ein Verzeichnis gewa.hlt werden, das bereits bei anderen Sucheintra.gen verwendet wird. Die Liste kann auβerdem durch Eintra.ge in der Datei epgsearchdirs.conf erweitert werden (pro Zeile ein Verzeichnis, ohne das fu.hrende video-Verzeichnis, s. auch MANUAL).

Wenn man erweiterte EPG-Infos von einem Provider erha.lt, ko.nnen im Verzeichnis-Eintrag auch Variablen wie ``%Genre%'' oder ``%Category%'' verwendet werden. Diese werden durch die aktuellen erw. EPG-Infos ersetzt, sobald ein Timer erzeugt wird.

Siehe MANUAL 'Using variables in the directory entry of a search timer')

- Aufn. nach ... Tagen lo.schen

Manchen Aufnahmen sollen nur ein paar Tage existieren, z.B. Tagesschau. Mit diesem Feature kann man epgsearch sagen, dass es die Aufnahme automatisch nach ... Tagen lo.schen soll

- Pause, wenn ... Aufnahmen existieren

Wenn die angegebene Anzahl von Aufnahmen existiert, dann pausiert epgsearch mit dem Erzeugen neuer Timer. Erst nach dem Lo.schen einer oder mehrerer Aufnahmen, wird wieder nach neuen Sendungen gesucht.

- Wiederholung vermeiden

Wenn man keine Wiederholungen aufnehmen will, versucht dieses Feature festzustellen, ob eine Sendung bereits aufgenommen/programmiert wurde und u.berspringt diese dann. Bitte vor Verwendung den Abschnitt 'Wiederholungen vermeiden - Im Detail' weiter unten lesen.

- erlaubte Wiederholungen

Will man eine gewisse Anzahl von Wiederholungen einer Sendung erlauben, kann dies hier hinterlegt werden.

- Nur Wiederh. innerhalb ... Tagen

Falls Wiederholungen nur innerhalb einer anzugebenden Anzahl Tage erlaubt werden sollen, kann dies hier eingestellt werden. 0 entspricht unbegrenzt.

- Vergleiche Titel

Einstellung, ob beim Test, ob eine Sendung identisch ist, auch der Titel verglichen werden soll.

- Vergleiche Untertitel

Einstellung, ob beim Test, ob eine Sendung identisch ist, auch der Untertitel verglichen werden soll. Bei 'falls vorhanden' stuft epgsearch zwei Sendungen nur dann als identisch ein, wenn die Episodennamen gleich sind und nicht leer.

- Vergleiche Beschreibung

Einstellung, ob beim Test, ob eine Sendung identisch ist, auch die Inhaltsbeschreibung verglichen werden soll. Dabei wird zuna.chst alles aus dem Inhalt entfernt, das einer Kategorienangabe gleicht. Der verbleibende Text wird dann verglichen. Ist dieser zum Prozentsatz der folgenden Option a.hnlich (im Sinne des Levinshtein-Distance-Algorithmus) wird er als gleich behandelt.

- "Min. U.bereinstimmung in %"

Die notwendige U.bereinstimmung zweier Beschreibung in %.

- Vergl. Zeitpunkt

Manchmal wird eine Sendung ha.ufig innerhalb einer gewissen Zeitspanne (Tag, Woche, Monat,...) wiederholt, die einzelnen Sendungen lassen sich aber anhand des EPG Inhalts nicht unterscheiden. Somit ist der Zeitpunkt also die einzige Information. Um damit zu vergelichen, kann man hier die entsprechende Zeitspanne auswa.hlen, um die Wiederholungen zu ignorieren.

- Vergl. Kategorien

U.ber die Schaltfla.che 'Einstellungen' kann angegeben werden welche Kategorien ebenfalls miteinander verglichen werden sollen.

- Priorita.t, Lebensdauer, Zeitpuffer Anfang und Ende:

Jeder Suchtimer kann fu.r diese Parameter eigene Einstellungen haben. Die Voreinstellung wird im Setup vorgenommen.

- VPS:

aktiviert VPS, falls im VDR-Setup aktiv und fu.r die gefundene Sendung auch VPS-Informationen vorhanden sind.

- automatisch lo.schen:

zum automatischen Lo.schen eines Suchttimers bei folgenden Bedingungen:

 * nach x Aufnahmen, oder
 * nach x Tagen nach erster Aufnahme

Geza.hlt werden dabei nur erfolgreiche Aufnahmen. Das Lo.schen erfolgt direkt nach dem Ende der entsprechenden Aufnahme.

Um den Status 'Als Suchtimer verw.' zu a.ndern, ohne das Menu. zu o.ffnen, kann die Taste '2' verwendet werden. Dies ruft direkt den 2. Befehl im Befehlsmenu. auf.

1.2.2 Menu. Suchergebnisse

Dieses Menu. zeigt die Suchergebnisse an. Ein 'T' sagt aus, dass es zu diesem Eintrag bereits einen Timer gibt, ein 't', dass es nur teilweise aufgenommen wird, also wie im Standard-Programm-Menu..

1.3 Erweitertes 'Jetzt' and 'Na.chste'

Im Setup ko.nnen bis zu 4 zusa.tzliche Zeiten, als Erweiterung zu 'Jetzt' und 'Na.chste', angegeben werden um die Taste Gru.n zu erweitern. Z.B. 'nachmittags', 'abends', 'spa.tabends'. Zeiten, die bereits verstrichen sind, werden u.bersprungen, man erha.lt abends also kein 'nachmittags'. Ausnahme: Ist ein Zeitpunkt nicht mehr als 20 Stunden in der Zukunft wird das Menu. des na.chsten Tages angezeigt. In diesen Menu. kann die aktuell angezeigte Zeit durch Dru.cken auf FastRew und FastFwd verschoben werden um die Zeit nach hinter oder vorne zu verstellen. Falls diese Tasten auf der Fernbedienung nicht existieren, kann diese Funktion durch Umschalten mit '0' erreicht werden. Die Tasten Gru.n und Gelb wechseln dann zu '<<' und '>>'. Das Umschalten kann u.ber das Setup angepasst werden. Man kann einen Fortschrittsbalken im Menu. 'Jetzt'/'Na.chste' anzeigen lassen.

1.4 Menu. Setup

1.4.1 Allgemein

- Hauptmenu.eintrag verstecken:: Damit wird der Eintrag 'Suche' im Hauptmenu. ausgeblendet. Achtung: wenn das Plugin der Taste Gru.n zugeordnet ist, dann bewirkt das Ausblenden, dass wieder das VDR-Standardmenu. gerufen wird (um das zu vermeiden s. unten).
- Hauptmenu.-Eintrag: Falls nicht ausgeblendet, kann hier der Name des Hauptmenu.-Eintrags hinterlegt werden. Vorgabe ist 'Programmfu.hrer'. Hinweis: Wenn man den Eintrag abweichend von der Vorgabe setzt, ist der Eintrag nicht mehr abha.ngig von der gewa.hlten OSD-Sprache. Setzt man den Eintrag wieder auf den Default oder auf leer ist die Abha.ngigkeit wieder gegeben.
- Startmenu.:: Auswahl von 'Programm' oder 'Jetzt' als Startmenu..

1.4.2 EPG Menu.s

- Taste Ok:: Hier kann das Verhalten der 'Ok'-Taste bestimmt werden. Man kann damit die Inhaltsangabe anzeigen oder zum entsprechenden Sender wechseln. Hinweis: Die Funktion der Taste 'Blau' (Umschalten/Info/Suche) ha.ngt von dieser Einstellung ab.
- Taste Rot:: Auswahl, ob man den Standard ('Aufnehmen') oder 'Befehle' als Vorbelegung mo.chte.
- Taste Blau:: Auswahl, ob man den Standard ('Umschalten') oder 'Suche' als Vorbelegung mo.chte.
- Zeige Fortschrittsbalken in 'Jetzt':: Im Menu. 'Jetzt' kann ein Fortschrittsbalken angezeigt werden, der den Fortschritt der laufenden Sendung anzeigt.
- Zeige Kanalnummer:: auswa.hlen, um eine fu.hrende Programmnummer vor jedem EPG-Eintrag anzuzeigen.
- Zeige Kanal-Separatoren:: zur Anzeige einer Trennzeile zwischen Kanalgruppen im Menu. 'U.bersicht - Jetzt' ...
- Zeige Tages-Separatoren:: zur Anzeige einer Trennzeile zwischen Sendungen unterschiedlicher Tage im Menu. 'Programm'.
- Zeige Radiokana.le:: Zeigt auch Radiokana.le an.
- Limit channels from 1 to:: Bei einer sehr groβen Kanalliste la.βt sich der Menu.-Aufbau mit dieser Einstellung durch eine Einschra.nkung der angezeigten Kana.le beschleunigen. Mit '0' wird das Limit aufgehoben. Wenn der aktuelle Kanal u.ber dem Limit liegt, wird das Limit ignoriert und wieder alle Kana.le angezeigt.
- Timer mit 'Aufnehmen' sofort anlegen:: Falls 'Ja' wird ein Timer sofort erzeugt, sobald man 'Aufnehmen' dru.ckt, sonst wird das Timer-Edit-Menu. angezeigt.
- Zeige Kana.le ohne EPG:: zur Anzeige von Programmen ohne EPG, um auf diese umschalten zu ko.nnen oder einen Timer zu programmieren
- Timer mit 'Aufnehmen' sofort anlegen:: Falls 'Ja' wird nach Dru.cken von 'Aufnahme' sofort ein Timer angelegt, falls 'Nein' erscheint das Timer-Edit-Menu..
- Zeitintervall fu.r FR/FF [min]:: In den Menu.s 'Programm', 'Jetzt', 'Na.chste', 'Benutzerdef. Zeit 1', ... kann die angezeigte Zeit durch dru.cken von FastRew, FastFwd verschoben werden. Die Anzahl Minuten fu.r den Sprung kann hier angepasst werden.
- Gru.n/Gelb umschalten:: Falls die Tasten FastRew, FastFwd auf der Fernbedienung nicht vorhanden sind, dann auf 'ja' setzen. Wenn die Taste '0' gedru.ckt wird, werden somit auch die Tasten Gru.n/Gelb auf z.B. '<<' und '>>' umgeschaltet.
- Zeige Favoriten-Menu.:: Das Favoritenmenu. kann dazu verwendet werden, eine Liste von bevorzugten Sendungen anzuzeigen, die innerhalb der na.chsten 24 Stunden laufen. Je nach Einstellung erscheint dieses Menu. vor oder nach den EPG-Menu.s mit benutzerdef. Zeiten. Die Auswahl von Sendungen wird durch setzen der Option 'In Favoriten-Menu. verw.' innerhalb einer Suche geregelt.
- fu.r die na.chsten ... Stunden:: Mit diesem Wert wird die Zeitspanne eingestellt, fu.r die Favoriten angezeigt werden sollen.

1.4.3 Benutzerdef. EPG-Zeiten

- Benutzerdef. Zeit 1..4:: Bis zu 4 benutzerdefinierte Zeiten ko.nnen zu 'Jetzt' und 'Na.chste' hinzugefu.gt werden.
- Beschreibung:: Name der benutzerdef. Zeit, z.B. 'Nachmittags', 'Abends', 'Spa.tabends'.
- Zeit:: zugeho.rige Uhrzeit.

1.4.4 Timer-Programmierung

- VDR's Time-Edit-Menu. verw.: Beim normalen Programmieren eines Timers verwendet epgsearch ein erweitertes Timer-Edit-Menu., das einen Verzeichniseintrag, benutzerdefinierte Wochentage und die Vervollsta.ndigung um Untertitel anbietet. Falls man einen gepatchten VDR verwendet der ebenfalls ein erweitertes Timer-Edit-Menu. anbietet und lieber dieses verwenden will, dann einfach diese Option auf 'Ja' setzen.
- Standard Aufn. Verzeichnis:: Dieser Eintrag wird beim normalen Programmieren eines Timers verwendet. Man kann auch EPG-Variablen verwenden (z.B.. 'Meine Filme~%Category%~%Genre%'). Wird das Timer-Edit-Menu. aufgerufen versucht epgsearch alle Variablen durch die Werte in der Beschreibung der Sendung zu ersetzen. Konnten nicht alle ersetzt werden, bleibt der Verzeichniseintrag leer.
- Untertitel in manuellen Timern:: Beim manuellen Programmieren eines Timers kann epgsearch den Untertitel automatisch im Dateinamen erga.nzen, wodurch die spa.tere Aufnahme in einem Unterverzeichnis fu.r diese Episode gespeichert wird. Hier wa.hlt man wie die Erga.nzung gemacht werden soll. 'Intelligent' versucht zu pru.fen, ob es Sinn macht und pru.ft dazu die La.nge einer Sendung. Ist diese la.nger als 80min wird keine Untertitel erga.nzt.
- Standard-Timer-Pru.fmethode:: Manuell angelegte Timer ko.nnen auf A.nderungen im EPG u.berpru.ft werden. Hier kann die Standardeinstellung fu.r die Pru.fmethode je Kanal hinterlegt werden. Folgende Pru.fmethoden existieren:
   * ohne U.berwachung
   * anhand Sendungskennung: gepru.ft wird anhand einer Kennung, die durch den
     Sender vergeben wird. (Achtung: nicht jeder Sender liefert vernu.nftige
     Kennungen!)
   * anhand Sender/Uhrzeit: gepru.ft wird anhand der Sendung, die am besten zur
     Dauer der urspru.nglichen Sendung passt.
Nicht alle Sender liefern eine vernu.nftige Sendungskennung. Deshalb kann hier die Standardeinstellung fu.r jeden Kanal einzeln gesetzt werden. Bei der Programmierung eines manuellen Timers wird diese im Timer-Edit-Menu. vorgegeben, falls das epgsearch-eigene Menu. benutzt wird.

1.4.5 Suche und Suchtimer

- Verwende Suchtimer:: falls ja, untersucht das Plugin im Hintergrund die EPG-Daten und erzeugt Timer, falls passende Eintra.ge gefunden werden. Dies betrifft nur Sucheintra.ge, die mit 'Als Suchtimer verwenden' markiert sind.
- Aktualisierungsintervall:: Das Intervall in Minuten, in dem die Hintergrundsuche vorgenommen wird.
- SVDRP Port:: Falls nicht der Standard-SVDRP-Port 6419 (2001 vor vdr-1.7.15) verwendet wird, dann bitte hier anpassen, damit die Suchtimer funktionieren.
- Priorita.t, Lebensdauer und Zeitpuffer fu.r Anfang und Ende:: Voreinstellungen
- Keine Anku.ndigung bei Wiedergabe:: zum Unterdru.cken von Sendungs-Anku.ndigungen wa.hrend einer aktiven Wiedergabe.
- Timer nach Lo.schen neuprogrammieren:: epgsearch merkt sich standardma.βig welche Timer bereits durch Suchtimer angelegt wurden und programmiert diese nicht erneut, wenn sie gelo.scht wurden. Zum Abschalten dieses Verhaltens bitte 'Ja' wa.hlen.
- Pru.fe ob EPG fu.r ... [h] existiert:: Falls EPG von externen Anbietern bezogen wird, kann es vorkommenm, dass hier auch mal etwas schiefla.uft und somit wegen fehlendem EPG Aufzeichnungen verlorengehen. Hiermit kann gepru.ft werden, ob fu.r die na.chsten ... Stunden EPG bei den gewu.nschten Sendern vorhanden ist. Mit '0' wird die Pru.fung deaktiviert.
- "per OSD warnen:": falls ja, erscheint die Warnung als OSD-Einblendung
- "per Mail warnen:": falls ja, wird die Warnung per Mail versandt. Bitte das Email-Konto unter Email-Benachrichtigung konfigurieren.
- "zu pru.fende Kanalgruppe:": hier die Kanalgruppe auswa.hlen, fu.r die die Pru.fung durchgefu.hrt werden soll. Gegebenefalls zuvor unter Kanalgruppen anlegen.
- PayTV-Sender ignorieren:: Auf 'Ja' setzen, wenn man bei der Suche nach Wiederholungen keine Sendungen von PayTV-Sendern haben will.
- Such-Vorlagen:: Hier ko.nnen Suchvorlagen verwaltet werden, die beim Anlegen neuer Suchen verwendet werden ko.nnen.
- Ausschlusslisten:: Hier ko.nnen Ausschlusslisten verwalten werden. Diese ko.nnen innerhalb einer Suche verwendet werden um unerwu.nschte Sendungen zu vermeiden. Eine Ausschlussliste kann auch als global gekennzeichnet werden. Da die Standardeinstellung beim Suchtimer fu.r die Option 'Ausschlusslisten verw.' auf 'nur globale' steht, kann man somit einfach unerwu.nschte Sendungen von allen Suchtimern ausschlieβen. Ausnahme: Falls beim Suchtimer die Option 'Ausschlusslisten verw.: keine' gewa.hlt ist, hat eine globale Ausschlussliste keine Auswirkung. Ebenso werden globale Ausschlusslisten bei der Suche nach Wiederholungen u.ber das OSD ignoriert.
- Kanalgruppen:: verwaltet die Kanalgruppen, die als Suchkriterium in einer Suche verwendet werden ko.nnen. Die Verwaltung ist auch im Edit-Menu. einer Suche mo.glich.

Wichtig: wenn der EPG aus einer externen Quelle bezogen wird, sollte dafu.r gesorgt werden, dass die Suchtimer-Updates wa.hrend des EPG-Updates abgeschaltet sind. Der Grund dafu.r ist, dass epgsearch Timer lo.scht, denen keine Sendungen zugeordnet sind. Wa.hrend der neue EPG an VDR u.bermittelt wird, kann diese Situation auftreten. Am einfachsten geht das mit dem SVDRP-Befehl SETS im EPG-Update-Skript:

svdrpsend plug epgsearch SETS off

svdrpsend plug epgsearch SETS on

1.4.6 Timer-Konflikt-Pru.fung

- Ignoriere unter Priorita.t:

Falls ein Timer fehlschlagen wird, dessen Priorita.t unter dem angegebene Wert liegt, wird darauf nicht per OSD-Nachricht hingewiesen und der Konflikt wird als 'nicht relevant' in der Konflikt-U.bersicht angezeigt.

- Ignoriere Konfliktdauer unter ... Min.:

Falls ein Konflikt nicht la.nger als die angegebene Anzahl Minuten dauert, wird darauf nicht per OSD-Nachricht hingewiesen und der Konflikt wird als 'nicht relevant' in der Konflikt-U.bersicht angezeigt.

- Pru.fe nur die na.chsten ... Tage:

Hier kann der Zeitraum der Pru.fung angegeben werden.

- Nach jeder Timer-Programmierung:

Das bewirkt eine Konfliktpru.fung nach jeder manuellen Timer-Programmierung und erzeugt eine OSD-Nachricht, falls der neue/gea.nderte Timer in einen Konflikt verwickelt ist.

- Beim Beginn einer Aufnahme:

Hier auf 'Ja' setzen, wenn die Konfliktpru.fung beim Beginn jeder Aufnahme erfolgen soll. Im Falle eines Konflikts wird dann sofort eine Nachricht angezeigt. Diese erscheint nur, wenn der Konflikt innerhalb der na.chsten 2 Stunden auftritt.

- Nach jedem Suchtimer-Update:

Hier kann eingestellt werden, ob eine Konfliktpru.fung nach jedem Suchtimer-Update erfolgen soll. Falls nicht:

- nach ... Minuten:

gibt an nach wievielen Minuten im Hintergrund eine automatische Konfliktpru.fung erfolgen soll. Bei relevanten Konflikten erfolgt eine Nachricht per OSD. Mit '0' wird diese Funktion deaktiviert.

- Wenn na.chster Konflikt in ... Minuten:

Wenn na.chster Konflikt in ... Minuten eintritt, verwende folgendes Pru.fintervall.

- alle ... Minuten:: um einen Konflikt in Ku.rze nicht zu u.bersehen, kann hier ein ku.rzeres Pru.fintervall eingestellt werden.

- Vermeide Nachricht bei Wiedergabe:

Bitte auf 'Ja' setzen, wenn wa.hrend einer Wiedergabe keine OSD-Benachrichtigungen u.ber Timer-Konflikte gewu.nscht sind. Die Benachrichtigung erfolgt trotzdem, wenn der na.chste Konflikt innerhalb der na.chsten 2 Stunden auftritt.

Bitte ebenfalls den Abschnitt 'Working with the timer conflict menu' im MANUAL beru.cksichtigen.

1.4.7 Email-Benachrichtigungen

(Bitte sicherstellen, dass 'sendEmail.pl' im Pfad der ausfu.hrbaren Dateien liegt und 'epgsearchupdmail.templ' und 'epgsearchconflmail.templ' im Konfig-Verzeichnis von epgsearch existieren!)

- Suchtimer-Benachrichtigung:

Diese Option aktivieren, wenn man eine Email-Benachrichtigung wu.nscht, sobald der Suchtimer-Hintergrund-Thread

  - neue Timer angelegt hat
  - vorhandene Timer gea.ndert hat
  - Timer gelo.scht hat, weil diese wegen EPG-A.nderungen oder anderen
    Benutzeraktionen nicht mehr gu.ltig sind.

(Dazu muss ebenfalls die Option 'Verwende Suchtimer' im Suchtimer-Setup aktiv sein.)

- Zeit zwischen Mails [h]:

Fu.r Benachrichtigungen zu Suchtimern kann hier angegeben werden, welchen Mindestabstand in Stunden die Mails haben sollen. Sobald die entsprechende Zeit verstrichen ist, wird eine Mail nach dem na.chsten Suchtimer-Update versandt. Der Wert '0' bedeutet keine Verzo.gerung und bewirkt einen sofortigen Mailversand.

- Timer-Konflikt-Benachrichtigung:

Diese Option aktivieren, wenn man eine Email-Benachrichtigung bei Timer-Konflikten wu.nscht. Es werden nur Konflikte gemeldet, die laut Setup-Einstellungen 'relevant' sind. Neue Benachrichtigungen werden nur versandt, sobald sich etwas bei den Konflikten vera.ndert.

(Dazu muss ebenfalls die Option 'Nach jedem Suchtimer-Update' oder 'nach ... Minuten' im Timer-Konflikt-Setup aktiv sein.)

- Email-Adresse:

Hier bitte die volle (!) Email-Adresse hinterlegen, an die die Nachrichten verschickt werden sollen. Hinweis: Einigen Provider (z.B. Arcor) erlauben nicht die gleiche Adresse fu.r Sender und Empfa.nger.

- Mail-Methode:

Zur Auswahl stehen

  - sendEmail.pl: ein einfaches Skript, das auch auf Systemen ohne
    konfigurierten Mailserver den Versand von Emails erlaubt. Das Skript wird
    mit epgsearch ausgeliefert und sollte im $PATH liegen.
  - sendmail: setzt ein korrekt aufgesetzes Mailsystem voraus.

- Email-Adresse:

Hier bitte die volle (!) Email-Adresse hinterlegen, von der die Nachricht versandt werden soll.

- SMTP Server:

Der Name des SMTP Servers, u.ber den der Mailversand erfolgt.

- Verw. SMTP-Authentifizierung:

'Ja' wa.hlen wenn das Emailkonto eine SMTP-Authentifizierung fu.r den Emailversand beno.tigt.

- AUTH-Benutzer:

Hier bitte den Benutzernamen angeben, falls das Email-Konto mit Authentifizierung arbeitet.

- AUTH-Passwort:

Hier bitte das Passwort angeben, falls das Email-Konto mit Authentifizierung arbeitet. Achtung: Das Passwort wird im Klartext gespeichert. Man muss selber dafu.r sorgen, dass das System sicher ist und nicht authorisierten Personen kein Zugriff auf VDR-Konfigurations-Dateien mo.glich ist.

Nach Angabe der Email-Konto-Daten bitte mit 'Test' pru.fen, ob alles funktioniert. Wenn mit 'sendEmail.pl' gearbeitet wird, sollte am Ende der Test-Ausgabe etwas wie 'Email sent successfully' auftauchen. Die Testfunktion gibt es bei der Methode 'sendmail' leider nicht.

Bitte ebenfalls den Abschnitt 'Email notifications' im Manual beru.cksichtigen.

2. Suchtimer

Das ist ziemlich das gleiche wie VDRAdmin's Autotimer, beno.tigt jedoch kein externes Programm. Beim Anlegen einer Suche kann man die Option setzen, ob diese als Suchtimer verwendet werden soll. Das Plugin sucht nun im Hintergrund in bestimmten Zeitabsta.nden (->Setup->Update Intervall [min]) nach passenden Sendungen und erzeugt Timer fu.r die Ergebnisse. Gerade fu.r Serien ist dies sehr praktisch, weshalb es in der Suche die Option ``Serienaufnahme'' gibt. In diesem Fall wird ein Timer mit zusa.tzlichem Episodennamen angelegt. Die Aufnahme erscheint dann in einem Ordner mit dem Seriennamem. Falls es keinen Episodennamen gibt wird stattdessen automatisch Datum und Uhrzeit verwendet.

Die Suchtimer-Funktion muss ausserdem im Setup aktiviert werden. Falls fu.r SVDRP nicht der Standardport verwendet wird, bitte ebenfalls im Setup eintragen.

Falls man eine Hintergrund-Suche manuell anstoβen will, genu.gt ein

touch /etc/vdr/plugins/epgsearch/.epgsearchupdate

Das kann ebenfalls Teil des shutdown-Skripts sein (hier sollte man dann noch einen sleep von ein paar Sekunden anha.ngen, damit das Plugin Zeit hat, den Scan zu beenden).

Mehr Infos zu Suchtimern gibts im MANUAL unter 'Description of the search process' und 'How do Search Timers work?'.

2.1 'Wiederholungen vermeiden' - Im Detail

Hier soll erkla.rt werden wie die Option 'Wiederholungen vermeiden' eines Suchtimers funktioniert.

Nicht immer la.sst sich durch entsprechende Suchkriterien vermeiden, dass auch Timer fu.r Wiederholungen erzeugt werden.

Um das zu verhindern, versucht das Feature 'Wiederholungen vermeiden' vor dem Programmieren einer Sendung zu pru.fen, ob eine gleiche Sendung schon mal aufgenommen wurde oder ein Timer existiert, der die gleiche (nicht dieselbe!) Sendung aufzeichnet. Ist dies der Fall, wird kein Timer fu.r die zu u.berpru.fende Sendung erzeugt.

2.2 Wie funktioniert der Vergleichstest zwischen 2 Sendungen?

Fu.r den Test auf Gleichheit zwischen 2 Sendungen gibt es viele Einstellmo.glichkeiten beim Suchtimer. Man kann wa.hlen, ob Titel, Untertitel, Beschreibung und bestimmte Kategorien innerhalb der Beschreibung einer Sendung mit den jeweiligen Angaben einer anderen Sendung verglichen werden sollen.

Der Vergleich der einzelnen Angaben selbst pru.ft immer auf vollsta.ndige Identita.t. Die Beschreibung einer Sendung bildet hier aber eine Ausnahme. Hier wird zuna.chst alles aus dem Text entfernt, das einer Kategorie-Angabe gleicht, z.B. 'Bewertung: Tagestipp'. Als Kategorie-Angabe wird alles gewertet, was am Anfang einer Zeile maximal 40 Zeichen hat, von einem ':' gefolgt wird und dann maximal weitere 60 Zeichen hat. Hintergrund fu.r dieses Rausschneiden sind die oft vorhandenen Bewertungen wie 'Tagestipp', die bei der Wiederholung aber nicht mehr enthalten sind.

Der verbleibende Text wird nun zuna.chst in der La.nge verglichen. Ist der Unterschied gro.βer als 90% wird die Beschreibung als unterschiedlich gewertet. Andernfalls wird u.ber den Levinsthein-Distance-Algorithmus (LD), der einen Fuzzy-Textvergleich macht, ein Test vorgenommen. Hier wird die Beschreibung als gleich akzeptiert, wenn LD mehr als 90% Identita.t zuru.ckgibt.

Da dieser Algorithmus ziemlich laufzeitintensiv ist (O(mn)), sollte nach Mo.glichkeit nicht nur 'Vergleiche Beschreibung' als einziges Vergleichskriterium ausgewa.hlt werden, sondern am besten immer nur in Kombination mit anderen Vergleichen.

2.3 Wie und wo wird der Vergleichstest eingesetzt?

Wie zuvor erwa.hnt wird bei einem Suchtimer-Update fu.r Suchtimer mit diesem Feature zusa.tzlich gepru.ft, ob eine Sendung bereits irgendwann schon aufgezeichnet wurde, oder in der Timerliste ein Timer steht, der die gleiche Sendung aufzeichnen wu.rde. Letzteres sollte klar sein, wa.hrend fu.r ersteres das File epgsearchdone.data ins Spiel kommt.

Nach jeder Aufnahme, die durch einen Suchtimer mit 'Wiederholung vermeiden' erzeugt wurde, werden alle Angaben zu dieser Sendung im genannten File gespeichert. U.ber das Aktionenmenu. im Menu. 'Suche' kann man sich alle Sendungen, die ein solcher Timer bisher aufgenommen hat, anzeigen lassen und diese auch bearbeiten. In dieses File werden nur Aufnahmen aufgenommen, die bezu.glich der Timerangaben korrekt begonnen und auch beendet wurden. D.h. dass teilweise unvollsta.ndige Aufnahmen nicht registriert werden und somit beim na.chsten Suchtimer-Update automatisch ein neuer Timer fu.r diese Sendung erzeugt wird, falls gefunden.

Wie verwenden?

Man sieht, dass das ganze Feature stark von der Qualita.t und dem Umfang des verwendeten EPGs abha.ngt. Hat man einen entsprechenden Suchtimer angelegt, ist es sinnvoll erstmal zu pru.fen, ob er auch das richtige macht. Dazu gibt es fu.r solche Timer im Suchergebnis-Menu. auf der Taste 'Blau' die zusa.tzliche Belegung 'Timer-Vorschau'. Sendungen, die noch keinen Timer haben ('T'), aber fu.r die einer aufgrund des Features beim na.chsten Suchtimer-Update programmiert wu.rde, haben dort ein 'P' stehen.

Hinweis: Mo.chte man wegen Konflikten einen bereits programmierten Timer nicht verwenden, dann sollte dieser im Timermenu. deaktiviert werden. Beim na.chsten Suchtimer-Update wird dann einfach die na.chste mo.gliche Wiederholung programmiert, falls vorhanden.

Wenn es nicht richtig funktioniert :-)

Damit das Programmieren oder Nicht-Programmieren von Timern gerade bei Verwendung dieses Features besser nachvollziehbar ist, wurde ein Logfile fu.r epgsearch eingefu.hrt. Startet man epgsearch mit einem Loglevel >= 2 (-P'epgsearch -v 2) werden beim Suchtimer-Update in der Datei epgsearch.log hilfreiche Infos abgelegt. Siehe MANUAL fu.r 'command line options'.

3. Verwendung der Suche durch andere Plugins oder Skripte

Siehe epgsearch(4).

4. Verwendung erweiterter EPG Infos

Einige EPG Provider liefern zusa.tzliche EPG Infos wie die Art der Sendung, das Video und Audio Format, die Besetzung,... in der Beschreibung der Sendung.

Anmerkung: Dies hat nichts mit den content descriptors seit vdr-1.7.11 zu tun, die als zusa.tzliche Daten nach einem gemeinsamen Standard aufgeliefert werden. Leider liefern nicht alle Provider diese Daten oder setzen die Kennungen nicht korrekt. Deshalb gibt es den Ansatz der ``erweiterten EPG Infos'', der versucht diese Information aus der Inhaltsbeschreibung zu extrahieren.

Mit tvmovie2vdr oder epg4vdr ko.nnen diese Daten in den VDR importiert werden.

Somit kann man also z.B. einfach einen Suchtimer erzeugen, der alle Tagestipps findet, die in 16:9 ausgestrahlt werden. Um diese Informationen in Suchtimern zu verwenden, muss anhand der Datei epgsearchcats.conf im epgsearch-Konfig-Verzeichnis eine Konfiguration vorgenommen werden.

Das Format dieser Datei ist folgendes:

 ID|category name|name in menu|values separated by ','(option)|searchmode(option)
 - 'ID' sollte eine eindeutige ganze Zahl sein
    Achtung: A.ndert man spa.ter aus irgendeinem Grund diese ID mu.ssen
    die Suchtimer neu editiert werden!
 - 'category name' ist der Name der Info lt. EPG Provider, z.B. 'Genre'
 - 'name in menu' ist der Name im Menu. von epgsearch.
 - 'values' ist eine optionale Liste von Werten fu.r diese Info.
 - 'searchmode' gibt optional an, wie gesucht werden soll:
   Textvergleich:
   0 - Der gesamte Begriff muss als Substring erscheinen
   1 - Die einzelnen Worte (getrennt durch ',', ';', '|' oder
       '~') mu.ssen alle als Substring auftauchen. Diese Einstellung ist
       der Standardwert.
   2 - mindestens ein Wort (getrennt durch ',', ';', '|' oder
       '~') muss als Substring auftauchen
   3 - exakte U.bereinstimmung
   4 - als regula.rer Ausdruck
   Numerischer Vergleich:
   10 - kleiner
   11 - kleiner oder gleich
   12 - gro.βer
   13 - gro.βer oder gleich
   14 - gleich
   15 - ungleich

Beispiel-Dateien fu.r epgsearchcats.conf kommen mit dem Plugin im Verzeichnis 'conf'. Einfach die passende ins epgsearch-Konfig-Verzeichnis als epgsearchcats.conf kopieren, VDR neu starten und dann das Eingabe-Menu. eines Suchtimers aufrufen.

Weil das Aufsetzen einer neuen epgsearchcats.conf ziemlich la.stig ist, habe ich ein kleines Tool 'createcats' mitgeliefert, das den Groβteil der Arbeit erledigt. Es sollte mit dem Plugin u.bersetzt worden sein und sich im Quellverzeichnis befinden. Einfach folgendermaβen aufrufen:

createcats /pfad_zu/epg.data

Dieses Tool scannt nun die vorhandenen EPG infos und versucht daraus die erweiterten Infos zu extrahieren. Das Ergebnis ist eine neue epgsearchcats.conf, die aber noch editiert werden muss, weil sicher nicht alles genau passt. Danach ins epgsearch-Konfig-Verzeichnis kopieren. (Mehr u.ber createcats im Manual 'Using createcats')

Details: epgsearch durchsucht die Zusammenfassung einer Sendung nach dem Namen einer Kategorie gefolgt von ': '. Das geschieht fu.r alle Kategorien, fu.r die im Suchtimer ein Wert gesetzt wurde. Die Suche beru.cksichtigt die Groβ/Kleinschreibung sowohl bezu.glich des Kategorie-Namens als auch des Wertes.

5. Ersetzen des Standardmenu.

Um das Plugin als Ersatz fu.r VDR's Standard-Menu. zu verwenden, genu.gt es die Zeile

 Green   @epgsearch

in die Datei keymacros.conf zu setzen. Falls kein weiterer Menu.eintrag im Hauptmenu. erscheinen soll, dann den Eintrag des Plugins zuna.chst im Setup ausblenden. Um das Plugin trotzdem mit der Taste ``Gru.n'' aufrufen zu ko.nnen, ko.nnte man z.B. mein launcher-Plugin verwenden und die Zeile

 Green @launcher x

in die keymacros.conf schreiben, wobei x die Position von epgsearch innerhalb des launcher listings ist.

Ein weiterer Ansatz ist ein Patch gegen VDR, der das Standardmenu. 'Programm' gegen epgsearch austauscht. Hierzu VDR mit dem Patch vdr-replace-schedulemenu.diff.gz aus dem Patches-Verzeichnis patchen. Danke an den Autor Uwe/egal@vdrportal. Bei Anwendung dieses Patches sollte der Eintrag

 Green Schedule

heiβen. Dieser Patch ist bereits in manchen Patchsammlungen, z.B. Bigpatch, enthalten.

6. Addons

Mit epgsearch werden 2 weitere 'Mini'-Plugins ausgeliefert. Beide Plugins erfordern, dass epgsearch ebenfalls installiert ist (epgsearch kann aber aus dem Hauptmenu. ausgeblendet werden):

- epgsearchonly:: Wer nur die Suchfunktionen und/oder die Suchtimer von epgsearch verwenden mo.chte oder einfach einen eigenen Hauptmenu.eintrag fu.r die Suche wu.nscht, kann dies mit diesem Plugin erreichen. Es wird damit ein Hauptmenu.eintrag ``Suche'' erzeugt, der einen direkt in das Suchenmenu. fu.hrt. Aktivierung im VDR-Startskript mit ``-Pepgsearchonly''.
- conflictcheckonly:: Die Timer-Konfliktpru.fung kann ebenfalls als eigener Hauptmenu.eintrag angelegt werden. U.ber eine Setup-Option la.βt sich auch das Ergebniss der letzten Konfliktpru.fung direkt im Hauptmenu. anzeigen. Aktivierung im VDR-Startskript mit ``-Pconflictcheckonly''.

Viel Spass!

Christian Wieninger

Ausfu.hrliche Beschreibung

Die ausfu.hrliche Beschreibung der internen Funktionen des Plugins findest Du in der Datei MANUAL, die dem Plugin beigelegt sein sollten.

Ob Du diese auf deinem System hast verra.t dir

"locate epgsearch*/MANUAL"

Sollte Deine Distribution diese Dateien nicht enthalten, kannst Du sie dir online durchlesen

<http://winni.vdr-developer.org/epgsearch/README.DE>

<http://winni.vdr-developer.org/epgsearch/README>

<http://winni.vdr-developer.org/epgsearch/MANUAL>

DATEIEN

epgsearch.conf

Entha.lt die Suchtimer. Siehe "epgsearch.conf(5)".

epgsearchcats.conf

Entha.lt die Kategorien des erweiterten EPG. Siehe "epgsearchcats.conf(5)".

epgsearchcmds.conf

Entha.lt Befehle a.hnlich der commands.conf, die auf EPG-Eintra.ge angewandt werden ko.nnen. Siehe "epgsearchcmds.conf(5)".

epgsearchdirs.conf

Entha.lt Pfade die beim Bearbeiten eines Suchtimers ausgewa.hlt werden ko.nnen. Siehe "epgsearchdirs.conf(5)".

epgsearchmenu.conf

Entha.lt die vom User gewa.hlte Konfiguration der OSD Menu.darstellung. Siehe "epgsearchmenu.conf(5)".

epgsearchuservars.conf

Entha.lt die User-Variablen. Siehe "epgsearchuservars.conf(5)".

epgsearchdone.data

Entha.lt die done-Liste. Siehe "epgsearchdone.data(5)".

epgsearchswitchtimers.conf

Entha.lt die Umschalttimer. Siehe "epgsearchswitchtimer.conf(5)".

epgsearchblacklists.conf

Entha.lt die Ausschlussliste. Siehe "epgsearchblacklists.conf(5)".

epgsearchchangrps.conf

Entha.lt die Kanalgruppen. Siehe "epgsearchchangrps.conf(5)".

epgsearchtemplates.conf

Entha.lt die Vorlagen fu.r Suchtimer. Siehe "epgsearchtemplates.conf(5)".

AUTOR (man pages)

Mike Constabel <epgsearch (at) constabel (dot) net>

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

<http://projects.vdr-developer.org/projects/plg-epgsearch>

Mailinglist:

<http://www.vdr-developer.org/mailman/listinfo/epgsearch>

COPYRIGHT and LIZENZ

Dieses Programm ist freie Software. Sie ko.nnen es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation vero.ffentlicht, weitergeben und/oder modifizieren, entweder gema.β Version 2 der Lizenz oder (nach Ihrer Option) jeder spa.teren Version.

Die Vero.ffentlichung dieses Programms erfolgt in der Hoffnung, dass es Ihnen von Nutzen sein wird, aber OHNE IRGENDEINE GARANTIE, sogar ohne die implizite Garantie der MARKTREIFE oder der VERWENDBARKEIT FU.R EINEN BESTIMMTEN ZWECK. Details finden Sie in der GNU General Public License.

Sie sollten ein Exemplar der GNU General Public License zusammen mit diesem Programm erhalten haben. Falls nicht, schreiben Sie an die Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA. Oder rufen Sie in Ihrem Browser http://www.gnu.org/licenses/old-licenses/gpl-2.0.html auf.

Der Author kann u.ber [email protected] erreicht werden.

Die Projektseite ist http://winni.vdr-developer.org/epgsearch

Der MD5-Code ist abgeleitet aus dem Message-Digest Algorithm von RSA Data Security, Inc..