From 2695a3f56a7748d6c2d9174661e92bc162b2a253 Mon Sep 17 00:00:00 2001 From: Christian Wieninger Date: Wed, 28 Nov 2007 19:47:36 +0100 Subject: - removed from repository as automatically created --- html/de/epgsearch.1.html | 1369 ----------------------------- html/de/epgsearch.conf.5.html | 168 ---- html/de/epgsearchblacklists.conf.5.html | 101 --- html/de/epgsearchcats.conf.5.html | 163 ---- html/de/epgsearchchangrps.conf.5.html | 100 --- html/de/epgsearchcmds.conf.5.html | 109 --- html/de/epgsearchdirs.conf.5.html | 124 --- html/de/epgsearchmenu.conf.5.html | 153 ---- html/de/epgsearchswitchtimers.conf.5.html | 102 --- html/de/epgsearchtemplates.conf.5.html | 87 -- html/de/epgsearchuservars.conf.5.html | 206 ----- html/de/noannounce.conf.5.html | 85 -- html/de/timersdone.conf.5.html | 86 -- html/en/createcats.1.html | 145 --- html/en/epgsearch.1.html | 1311 --------------------------- html/en/epgsearch.4.html | 912 ------------------- html/en/epgsearch.conf.5.html | 172 ---- html/en/epgsearchblacklists.conf.5.html | 100 --- html/en/epgsearchcats.conf.5.html | 157 ---- html/en/epgsearchchangrps.conf.5.html | 95 -- html/en/epgsearchcmds.conf.5.html | 105 --- html/en/epgsearchdirs.conf.5.html | 129 --- html/en/epgsearchmenu.conf.5.html | 162 ---- html/en/epgsearchswitchtimers.conf.5.html | 102 --- html/en/epgsearchtemplates.conf.5.html | 86 -- html/en/epgsearchuservars.conf.5.html | 201 ----- html/en/noannounce.conf.5.html | 97 -- html/en/timersdone.conf.5.html | 83 -- 28 files changed, 6710 deletions(-) delete mode 100644 html/de/epgsearch.1.html delete mode 100644 html/de/epgsearch.conf.5.html delete mode 100644 html/de/epgsearchblacklists.conf.5.html delete mode 100644 html/de/epgsearchcats.conf.5.html delete mode 100644 html/de/epgsearchchangrps.conf.5.html delete mode 100644 html/de/epgsearchcmds.conf.5.html delete mode 100644 html/de/epgsearchdirs.conf.5.html delete mode 100644 html/de/epgsearchmenu.conf.5.html delete mode 100644 html/de/epgsearchswitchtimers.conf.5.html delete mode 100644 html/de/epgsearchtemplates.conf.5.html delete mode 100644 html/de/epgsearchuservars.conf.5.html delete mode 100644 html/de/noannounce.conf.5.html delete mode 100644 html/de/timersdone.conf.5.html delete mode 100644 html/en/createcats.1.html delete mode 100644 html/en/epgsearch.1.html delete mode 100644 html/en/epgsearch.4.html delete mode 100644 html/en/epgsearch.conf.5.html delete mode 100644 html/en/epgsearchblacklists.conf.5.html delete mode 100644 html/en/epgsearchcats.conf.5.html delete mode 100644 html/en/epgsearchchangrps.conf.5.html delete mode 100644 html/en/epgsearchcmds.conf.5.html delete mode 100644 html/en/epgsearchdirs.conf.5.html delete mode 100644 html/en/epgsearchmenu.conf.5.html delete mode 100644 html/en/epgsearchswitchtimers.conf.5.html delete mode 100644 html/en/epgsearchtemplates.conf.5.html delete mode 100644 html/en/epgsearchuservars.conf.5.html delete mode 100644 html/en/noannounce.conf.5.html delete mode 100644 html/en/timersdone.conf.5.html (limited to 'html') diff --git a/html/de/epgsearch.1.html b/html/de/epgsearch.1.html deleted file mode 100644 index e52a588..0000000 --- a/html/de/epgsearch.1.html +++ /dev/null @@ -1,1369 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

1.1 Men� Befehle
1.2 Men� Suche

1.2.1 Men� Suche editieren
1.2.2 Men� Suchergebnisse

1.3 Erweitertes 'Jetzt' and 'N�chste'
1.4 Men� Setup

1.4.1 Allgemein
1.4.2 EPG Men�s
1.4.3 Benutzerdef. EPG-Zeiten
1.4.4 Timer-Programmierung
1.4.5 Suche und Suchtimer
1.4.6 Timer-Konflikt-Pr�fung
1.4.7 Email-Benachrichtigungen

2. 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 Standardmen�
6. Addons
Ausf�hrliche Beschreibung
SIEHE AUCH
DATEIEN
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearch - Suchtimer und Ersatz f�r VDR's Standard-Programm-Men�

BESCHREIBUNG

EPG-Search kann als Ersatz f�r VDR's Standard-Programm-Men� verwendet -werden. Es sieht genauso aus, erweitert es aber um einige zus�tzliche -Funktionen.

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

- - Befehle f�r EPG-Eintr�ge mit verschiedenen integrierten Befehlen wie
-   z.B. 'Wiederholungen anzeigen', 'Suche anlegen'. Man kann eigene   
-   Befehle hinzuf�gen, um z.B. einen VDRAdmin Autotimer anzulegen.

- - Bis zu 4 weitere Zeitpunkte im Men� 'Was l�uft jetzt?' neben 'Jetzt'
-   und 'N�chste', sowie ein optionales Favoritenmen�.

- - Suche im EPG: Anlegen von wiederverwendbaren Abfragen, die auch als
-   'Suchtimer' verwendet werden k�nnen.

- - Suchtimer: Sucht im Hintergrund nach Sendungen und erzeugt einen
-   Timer bei passenden EPG-Eintr�gen (�hnlich zu VDRAdmins Autotimern)
-   oder informiert �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 'N�chste'

- - Zeit im Men� 'Jetzt', 'N�chste' kann per Tastendruck verschoben
-   werden,  z.B. was l�uft 'Jetzt' + 30 Minuten

- - Startmen� 'Programm' oder 'Jetzt' einstellbar.

- - das Men� zur detaillierten EPG-Anzeige (Zusammenfassung) erlaubt den
-   Sprung zur vorherigen/n�chsten Sendung

- - Unterst�tzung erweiterter EPG-Infos in Suchtimern

- - Erweiterung des Timer-Edit-Men�s um Verzeichnisse,
-   benutzerdefinierte Wochentage und Untertitel-Auswahl

- - Timer Konfliktcheck, informiert �ber OSD-Meldung

- - Timer Konfliktmen�, zeigt die Konflikte an und erleichtert die
-   Konfliktl�sung

- - Email-Benachrichtigungen �ber Suchtimer-Updates und Timer-Konflikte

Funktioniert nur mit >= vdr-1.3.46.

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

OPTIONEN

-f file, --svdrpsendcmd=file - -: -
Pfad zu svdrpsend.pl f�r externe SVDRP-Kommunikation (Standard ist interne -Kommunikation, deshalb ist dieser Paramter normalerweise nicht notwendig)
-
-c path, --config=path - -: -
zur Angabe eines eigenen Konfigurationsverzeichnisses f�r alle -epgsearch-Dateien, Standard ist '<Plugin-Konfig-Verzeichnis>/epgsearch'
-
-l file, --logfile=file - -: -
zur Angabe eines abweichenden Dateipfades f�r epgsearch's Log-File (Standard -ist epgsearch.log in epgsearch's Konfig-Verzeichnis)
-
-v n, --verbose=n - -: -
verbose level f�r das Log-File. Wert 0 bedeutet kein Logging. Weiter Werte sind -1 (allgemeine Meldungen), 2 (detaillierte Meldungen), 3 (f�r Debug-Zwecke)
-
-r, --reloadmenuconf - -: -
bewirkt ein Neuladen der epgsearchmenu.conf bei jedem Plugin-Aufruf am -OSD. Kann f�r das Testen eines selbst angepa�ten Men�-Layouts praktisch sein.
-
-m file, --mailcmd=file - -: -
das externe Kommando f�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     Men� Befehle
- 1.2     Men� Suche
- 1.2.1     Men� Suche editieren
- 1.2.2     Men� Suchergebnisse
- 1.3     Erweitertes 'Jetzt' und 'N�chste'
- 1.4     Men� 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 Standardmen�
- 6.    Addons

1. Beschreibung

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

1.1 Men� Befehle

Dieses Men� zeigt Befehle an, die auf den ausgew�hlten Men�eintrag -angewandt werden k�nnen. Es gibt 8 vorgegebene Befehle:

- - Wiederholung: Zeigt Wiederholungen an
- - Aufnehmen
- - Umschalten
- - Suche anlegen: schaltet zum Suchmen� 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 ausgew�hlte Sendung in die Datei epgsearchdone.data
-   �bernommen und epgsearch angewiesen, diese Sendung nicht aufzunehmen, falls
-   der zugeh�rige Suchtimer mit "Wiederholung vermeiden" geschaltet ist. Ein
-   bereits erzeugter Timer wird beim n�chsten Suchtimer-Update automatisch
-   gel�scht.
- - In/Aus Umschaltliste?:
-   Zum Bearbeiten der Umschaltliste. Wenn eine Sendung in der Umschaltliste
-   enthalten ist, wird kurz vor Beginn eine Ank�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 hinzuf�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 ausgef�hrt wird, werden folgende Parameter �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 Ausf�hren eines Befehls aus dem Hauptmen� ohne �ffnen des -Befehlsmen�s gen�gt es, die zugeh�rige Nummer des Befehls zu dr�cken.

1.2 Men� Suche

Hier kann man eine Suche im EPG erzeugen, editieren, l�schen und -ausf�hren. Bedienung und Verhalten ist �hnlich zu VDR's Timer-Men�.

1.2.1 Men� Suche editieren

Das meiste in diesem Men� ist selbsterkl�rend, deshalb nur einige -Anmerkungen zu:

- Suche: - -

Suchbegriff. Will man nach mehreren Worten suchen, dann bitte mit -Leerzeichen trennen. L�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 f�r eine Suche -�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''). 'regul�rer -Ausdruck' erlaubt die Angabe eines regul�ren Ausdrucks zur -Suche. Ein f�hrender und abschlie�ender '/' ist nicht notwendig. Als -Standard werden POSIX extended regular expressions verwendet. Wer -lieber mit Perl kompatiblen regul�ren Ausdr�cken arbeitet, muss -lediglich im Makefile des Plugins #HAVE_PCREPOSIX=1 in -HAVE_PCREPOSIX=1 �ndern und neu kompilieren. (Daf�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. erweiterte EPG Info - -

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

- Ignoriere fehlende Kategorien - -

Wenn 'Ja' gew�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 f�hren.

- Verw. Kanal: - -

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

ACHTUNG: Nach einer �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: - -

Hier k�nnen eine oder mehrere oder alle Ausschlusslisten selektiert werden. -Falls ein Suchergebnis auch in einer der gew�hlten Ausschlusslisten -erscheint, wird es verworfen.

- In Favoritenmen� verw.: - -

Nur verf�gbar, wenn im Setup aktiviert. Mit dieser Option kann eine Suche zur -Verwendung im Favoritenmen� markiert werden. Dieses Men� listet alle -Suchergebnisse von Suchen mit dieser Option.

- Layout des Ergebnismen�s: - -

Nur verf�gbar, wenn mehr als eine Men�vorlage f�r Suchergebnisse in -epgsearchmenu.conf angegeben wurde. Mit dieser Option kann ein anderes Layout -f�r die Suchergebnisse dieser Suche gew�hlt werden.

- Verwende als Suchtimer: - -

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

- Aktion: - -

Standard ist 'Aufnehmen', also das Erzeugen eines Timers f�r das -Suchergebnis. Man kann aber auch w�hlen, dass nur eine Ank�ndigung -der Sendung per OSD vorgenommen werden soll. Eine weitere -M�glichkeit ist 'nur umschalten'. Dadurch wird automatisch eine -Minute vor Beginn der Sendung auf deren Kanal gewechselt.

- Serienaufnahme: - -

falls ja, wird die Aufnahme in einem Ordner mit dem Seriennamen -gespeichert. Die Aufnahme selbst erh�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 gew�hlt werden, das bereits bei anderen Sucheintr�gen -verwendet wird. Die Liste kann au�erdem durch Eintr�ge in der Datei -epgsearchdirs.conf erweitert werden (pro Zeile ein Verzeichnis, ohne -das f�hrende video-Verzeichnis, s. auch MANUAL).

Wenn man erweiterte EPG-Infos von einem Provider erh�lt, k�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 l�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 l�schen soll

- Pause, wenn ... Aufnahmen existieren - -

Wenn die angegebene Anzahl von Aufnahmen existiert, dann pausiert -epgsearch mit dem Erzeugen neuer Timer. Erst nach dem L�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 �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. Hat eine Sendung keinen -Untertitel wird sie als abweichend gewertet und ist damit nicht -gleich einer anderen Sendung mit oder ohne Untertitel.

- Vergleiche Beschreibung - -

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

- Vergl. Kategorien - -

�ber die Schaltfl�che 'Einstellungen' kann angegeben werden welche -Kategorien ebenfalls miteinander verglichen werden sollen.

- Priorit�t, Lebensdauer, Zeitpuffer Anfang und Ende: - -

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

- VPS: - -

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

- automatisch l�schen: - -

zum automatischen L�schen eines Suchttimers bei folgenden Bedingungen:

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

Gez�hlt werden dabei nur erfolgreiche Aufnahmen. Das L�schen erfolgt -direkt nach dem Ende der entsprechenden Aufnahme.

Um den Status 'Als Suchtimer verw.' zu �ndern, ohne das Men� zu -�ffnen, kann die Taste '2' verwendet werden. Dies ruft direkt den -2. Befehl im Befehlsmen� auf.

1.2.2 Men� Suchergebnisse

Dieses Men� 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-Men�.

1.3 Erweitertes 'Jetzt' and 'N�chste'

Im Setup k�nnen bis zu 4 zus�tzliche Zeiten, als Erweiterung zu 'Jetzt' -und 'N�chste', angegeben werden um die Taste Gr�n zu erweitern. -Z.B. 'nachmittags', 'abends', 'sp�tabends'. Zeiten, die bereits -verstrichen sind, werden �bersprungen, man erh�lt abends also kein -'nachmittags'. Ausnahme: Ist ein Zeitpunkt nicht mehr als 20 Stunden in der -Zukunft wird das Men� des n�chsten Tages angezeigt. -In diesen Men� kann die aktuell angezeigte Zeit durch Dr�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 Gr�n und Gelb wechseln dann zu '<<' und '>>'. Das -Umschalten kann �ber das Setup angepasst werden. -Man kann einen Fortschrittsbalken im Men� 'Jetzt'/'N�chste' anzeigen lassen. -Falls text2skin verwendet wird, sollte die Option ``text2skin'' in den -Setup-Optionen ``Zeige Fortschrittsbalken in 'Jetzt'''/``Zeige Fortschrittsbalken -in 'N�chste''' verwendet werden (Die Option 'graphisch' kann ebenfalls mit -text2skin funktionieren, das ist aber abh�ngig vom gew�hlten skin)

1.4 Men� Setup

1.4.1 Allgemein

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

1.4.2 EPG Men�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) -h�ngt von dieser Einstellung ab.
-
- Taste Rot: - -: -
Auswahl, ob man den Standard ('Aufnehmen') oder 'Befehle' als -Vorbelegung m�chte.
-
- Taste Blau: - -: -
Auswahl, ob man den Standard ('Umschalten') oder 'Suche' als -Vorbelegung m�chte.
-
- Zeige Fortschrittsbalken in 'Jetzt': - -: -
Im Men� 'Jetzt' kann ein Fortschrittsbalken angezeigt werden, der -den Fortschritt der laufenden Sendung anzeigt. Falls text2skin verwendet -wird, sollte die Option ``pipes'' verwendet werden (Die Option 'graphisch' -kann ebenfalls mit text2skin funktionieren, das ist aber abh�ngig vom -gew�hlten skin)
-
- Zeige Kanalnummer: - -: -
ausw�hlen, um eine f�hrende Programmnummer vor jedem EPG-Eintrag -anzuzeigen.
-
- Zeige Kanal-Separatoren: - -: -
zur Anzeige einer Trennzeile zwischen Kanalgruppen im Men� -'�bersicht - Jetzt' ...
-
- Zeige Tages-Separatoren: - -: -
zur Anzeige einer Trennzeile zwischen Sendungen unterschiedlicher -Tage im Men� 'Programm'.
-
- Zeige Radiokan�le: - -: -
Zeigt auch Radiokan�le an.
-
- Limit channels from 1 to: - -: -
Bei einer sehr gro�en Kanalliste l��t sich der Men�-Aufbau mit dieser -Einstellung durch eine Einschr�nkung der angezeigten Kan�le beschleunigen. Mit -'0' wird das Limit aufgehoben. Wenn der aktuelle Kanal �ber dem Limit liegt, -wird das Limit ignoriert und wieder alle Kan�le angezeigt.
-
- Timer mit 'Aufnehmen' sofort anlegen: - -: -
Falls 'Ja' wird ein Timer sofort erzeugt, sobald man 'Aufnehmen' dr�ckt, wie -in vdr-1.3.38 eingef�hrt, sonst wird das Timer-Edit-Men� angezeigt.
-
- Zeige Kan�le ohne EPG: - -: -
zur Anzeige von Programmen ohne EPG, um auf diese umschalten zu -k�nnen oder einen Timer zu programmieren
-
- Timer mit 'Aufnehmen' sofort anlegen: - -: -
Falls 'Ja' wird nach Dr�cken von 'Aufnahme' sofort ein Timer angelegt, wie -in vdr-1.3.38 eingef�hrt, falls 'Nein' erscheint das Timer-Edit-Men�.
-
- Zeitintervall f�r FR/FF [min]: - -: -
In den Men�s 'Programm', 'Jetzt', 'N�chste', 'Benutzerdef. Zeit 1', -... kann die angezeigte Zeit durch dr�cken von FastRew, FastFwd -verschoben werden. Die Anzahl Minuten f�r den Sprung kann hier -angepasst werden.
-
- Gr�n/Gelb umschalten: - -: -
Falls die Tasten FastRew, FastFwd auf der Fernbedienung nicht -vorhanden sind, dann auf 'ja' setzen. Wenn die Taste '0' gedr�ckt -wird, werden somit auch die Tasten Gr�n/Gelb auf z.B. '<<' und '>>' -umgeschaltet.
-
- Zeige Favoriten-Men�: - -: -
Das Favoritenmen� kann dazu verwendet werden, eine Liste von bevorzugten -Sendungen anzuzeigen, die innerhalb der n�chsten 24 Stunden laufen. Je nach -Einstellung erscheint dieses Men� vor oder nach den EPG-Men�s mit -benutzerdef. Zeiten. Die Auswahl von Sendungen wird durch setzen der Option -'In Favoriten-Men� verw.' innerhalb einer Suche geregelt.
-
- f�r die n�chsten ... Stunden: - -: -
Mit diesem Wert wird die Zeitspanne eingestellt, f�r die Favoriten angezeigt -werden sollen.
-

1.4.3 Benutzerdef. EPG-Zeiten

- Benutzerdef. Zeit 1..4: - -: -
Bis zu 4 benutzerdefinierte Zeiten k�nnen zu 'Jetzt' und 'N�chste' -hinzugef�gt werden.
-
- Beschreibung: - -: -
Name der benutzerdef. Zeit, z.B. 'Nachmittags', 'Abends', -'Sp�tabends'.
-
- Zeit: - -: -
zugeh�rige Uhrzeit.
-

1.4.4 Timer-Programmierung

- VDR's Time-Edit-Men� verw. - -: -
Beim normalen Programmieren eines Timers verwendet epgsearch ein -erweitertes Timer-Edit-Men�, das einen Verzeichniseintrag, -benutzerdefinierte Wochentage und die Vervollst�ndigung um -Untertitel anbietet. Falls man einen gepatchten VDR verwendet der -ebenfalls ein erweitertes Timer-Edit-Men� 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-Men� 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 erg�nzen, wodurch die sp�tere -Aufnahme in einem Unterverzeichnis f�r diese Episode gespeichert -wird. Hier w�hlt man wie die Erg�nzung gemacht werden -soll. 'Intelligent' versucht zu pr�fen, ob es Sinn macht und pr�ft -dazu die L�nge einer Sendung. Ist diese l�nger als 80min wird keine -Untertitel erg�nzt.
-
- Standard-Timer-Pr�fmethode: - -: -
Manuell angelegte Timer k�nnen auf �nderungen im EPG �berpr�ft werden. Hier -kann die Standardeinstellung f�r die Pr�fmethode je Kanal hinterlegt -werden. Folgende Pr�fmethoden existieren: - * ohne �berwachung - * anhand Sendungskennung: gepr�ft wird anhand einer Kennung, die durch den - Sender vergeben wird. (Achtung: nicht jeder Sender liefert vern�nftige - Kennungen!) - * anhand Sender/Uhrzeit: gepr�ft wird anhand der Sendung, die am besten zur - Dauer der urspr�nglichen Sendung passt.
-; -
Nicht alle Sender liefern eine vern�nftige Sendungskennung. Deshalb kann hier -die Standardeinstellung f�r jeden Kanal einzeln gesetzt werden. Bei der -Programmierung eines manuellen Timers wird diese im Timer-Edit-Men� -vorgegeben, falls das epgsearch-eigene Men� 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 Eintr�ge gefunden werden. Dies -betrifft nur Sucheintr�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 2001 verwendet wird, dann bitte -hier anpassen, damit die Suchtimer funktionieren.
-
- Priorit�t, Lebensdauer und Zeitpuffer f�r Anfang und Ende: - -: -
Voreinstellungen
-
- Keine Ank�ndigung bei Wiedergabe: - -: -
zum Unterdr�cken von Sendungs-Ank�ndigungen w�hrend einer aktiven Wiedergabe.
-
- Timer nach L�schen neuprogrammieren: - -: -
epgsearch merkt sich standardm��ig welche Timer bereits durch Suchtimer -angelegt wurden und programmiert diese nicht erneut, wenn sie gel�scht -wurden. Zum Abschalten dieses Verhaltens bitte 'Ja' w�hlen.
-
- PayTV-Sender ignorieren: - -: -
Auf 'Ja' setzen, wenn man bei der Suche nach Wiederholungen keine Sendungen -von PayTV-Sendern haben will.
-
- Such-Vorlagen: - -: -
Hier k�nnen Suchvorlagen verwaltet werden, die beim Anlegen neuer Suchen -verwendet werden k�nnen.
-
- Ausschlusslisten: - -: -
Hier k�nnen Ausschlusslisten verwalten werden. Diese k�nnen innerhalb einer -Suche verwendet werden um unerw�nschte Sendungen zu vermeiden.
-
- Kanalgruppen: - -: -
verwaltet die Kanalgruppen, die als Suchkriterium in einer Suche -verwendet werden k�nnen. Die Verwaltung ist auch im Edit-Men� einer -Suche m�glich.
-

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

svdrpsend.pl plug epgsearch SETS off

svdrpsend.pl plug epgsearch SETS on

1.4.6 Timer-Konflikt-Pr�fung

- Ignoriere unter Priorit�t: - -: -
Falls ein Timer fehlschlagen wird, dessen Priorit�t unter dem angegebene -Wert liegt, wird darauf nicht per OSD-Nachricht hingewiesen und der Konflikt -wird als 'nicht relevant' in der Konflikt-�bersicht angezeigt.
-
- Ignoriere Konfliktdauer unter ... Min.: - -: -
Falls ein Konflikt nicht l�nger als die angegebene Anzahl Minuten dauert, -wird darauf nicht per OSD-Nachricht hingewiesen und der Konflikt wird als -'nicht relevant' in der Konflikt-�bersicht angezeigt.
-
- Pr�fe nur die n�chsten ... Tage: - -: -
Hier kann der Zeitraum der Pr�fung angegeben werden.
-
- Nach jeder Timer-Programmierung: - -: -
Das bewirkt eine Konfliktpr�fung nach jeder manuellen Timer-Programmierung -und erzeugt eine OSD-Nachricht, falls der neue/ge�nderte Timer in einen -Konflikt verwickelt ist.
-
- Beim Beginn einer Aufnahme: - -: -
Hier auf 'Ja' setzen, wenn die Konfliktpr�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 n�chsten 2 Stunden auftritt.
-
- Nach jedem Suchtimer-Update: - -: -
Hier kann eingestellt werden, ob eine Konfliktpr�fung nach jedem -Suchtimer-Update erfolgen soll. Falls nicht:
-
- nach ... Minuten: - -: -
gibt an nach wievielen Minuten im Hintergrund eine automatische -Konfliktpr�fung erfolgen soll. Bei relevanten Konflikten erfolgt eine -Nachricht per OSD. Mit '0' wird diese Funktion deaktiviert.
-
- Wenn n�chster Konflikt in ... Minuten: - -: -
Wenn n�chster Konflikt in ... Minuten eintritt, verwende folgendes -Pr�fintervall.
-
- Vermeide Nachricht bei Wiedergabe: - -: -
Bitte auf 'Ja' setzen, wenn w�hrend einer Wiedergabe keine OSD-Benachrichtigungen -�ber Timer-Konflikte gew�nscht sind. Die Benachrichtigung erfolgt trotzdem, -wenn der n�chste Konflikt innerhalb der n�chsten 2 Stunden auftritt.
-

Bitte ebenfalls den Abschnitt 'Working with the timer conflict menu' im MANUAL -ber�cksichtigen.

1.4.7 Email-Benachrichtigungen

(Bitte sicherstellen, dass 'sendEmail.pl' im Pfad der ausf�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 w�nscht, sobald -der Suchtimer-Hintergrund-Thread

-  - neue Timer angelegt hat
-  - vorhandene Timer ge�ndert hat
-  - Timer gel�scht hat, weil diese wegen EPG-�nderungen oder anderen
-    Benutzeraktionen nicht mehr g�ltig sind.

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

- Timer-Konflikt-Benachrichtigung: - -

Diese Option aktivieren, wenn man eine Email-Benachrichtigung bei -Timer-Konflikten w�nscht. Es werden nur Konflikte gemeldet, die laut -Setup-Einstellungen 'relevant' sind. Neue Benachrichtigungen werden nur -versandt, sobald sich etwas bei den Konflikten ver�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 f�r Sender und Empf�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, �ber den der Mailversand erfolgt.

- Verw. SMTP-Authentifizierung: - -

'Ja' w�hlen wenn das Emailkonto eine SMTP-Authentifizierung f�r den -Emailversand ben�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 daf�r -sorgen, dass das System sicher ist und nicht authorisierten Personen kein -Zugriff auf VDR-Konfigurations-Dateien m�glich ist.

Nach Angabe der Email-Konto-Daten bitte mit 'Test' pr�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 ber�cksichtigen.

2. Suchtimer

Das ist ziemlich das gleiche wie VDRAdmin's Autotimer, ben�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 Zeitabst�nden (->Setup->Update -Intervall [min]) nach passenden Sendungen und erzeugt Timer f�r die -Ergebnisse. Gerade f�r Serien ist dies sehr praktisch, weshalb es in -der Suche die Option ``Serienaufnahme'' gibt. In diesem Fall wird ein -Timer mit zus�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 f�r SVDRP nicht der Standardport 2001 verwendet wird, bitte -ebenfalls im Setup eintragen.

Falls man eine Hintergrund-Suche manuell ansto�en will, gen�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 anh�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 erkl�rt werden wie die Option 'Wiederholungen vermeiden' -eines Suchtimers funktioniert.

Nicht immer l�sst sich durch entsprechende Suchkriterien vermeiden, -dass auch Timer f�r Wiederholungen erzeugt werden.

Um das zu verhindern, versucht das Feature 'Wiederholungen vermeiden' -vor dem Programmieren einer Sendung zu pr�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 f�r die zu �berpr�fende Sendung erzeugt.

2.2 Wie funktioniert der Vergleichstest zwischen 2 Sendungen?

F�r den Test auf Gleichheit zwischen 2 Sendungen gibt es viele -Einstellm�glichkeiten beim Suchtimer. Man kann w�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 pr�ft immer auf -vollst�ndige Identit�t. Die Beschreibung einer Sendung bildet hier -aber eine Ausnahme. Hier wird zun�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 f�r dieses Rausschneiden sind die -oft vorhandenen Bewertungen wie 'Tagestipp', die bei der Wiederholung -aber nicht mehr enthalten sind.

Der verbleibende Text wird nun zun�chst in der L�nge verglichen. Ist -der Unterschied gr��er als 90% wird die Beschreibung als -unterschiedlich gewertet. Andernfalls wird �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% Identit�t zur�ckgibt.

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

2.3 Wie und wo wird der Vergleichstest eingesetzt?

Wie zuvor erw�hnt wird bei einem Suchtimer-Update f�r Suchtimer mit -diesem Feature zus�tzlich gepr�ft, ob eine Sendung bereits irgendwann -schon aufgezeichnet wurde, oder in der Timerliste ein Timer steht, der -die gleiche Sendung aufzeichnen w�rde. Letzteres sollte klar sein, -w�hrend f�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. �ber das Aktionenmen� im Men� '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 bez�glich der Timerangaben korrekt begonnen und auch -beendet wurden. D.h. dass teilweise unvollst�ndige Aufnahmen nicht -registriert werden und somit beim n�chsten Suchtimer-Update -automatisch ein neuer Timer f�r diese Sendung erzeugt wird, falls -gefunden.

Wie verwenden?

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

Hinweis: M�chte man wegen Konflikten einen bereits programmierten -Timer nicht verwenden, dann sollte dieser im Timermen� deaktiviert -werden. Beim n�chsten Suchtimer-Update wird dann einfach die n�chste -m�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 f�r epgsearch eingef�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 f�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 zus�tzliche EPG Infos wie die Art der -Sendung, das Video und Audio Format, die Besetzung,... -Mit tvmovie2vdr oder epg4vdr k�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: �ndert man sp�ter aus irgendeinem Grund diese ID m�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 Men� von epgsearch.
- - 'values' ist eine optionale Liste von Werten f�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
-       '~') m�ssen alle als Substring auftauchen. Diese Einstellung ist
-       der Standardwert.
-   2 - mindestens ein Wort (getrennt durch ',', ';', '|' oder
-       '~') muss als Substring auftauchen
-   3 - exakte �bereinstimmung
-   4 - als regul�rer Ausdruck
-   Numerischer Vergleich:
-   10 - kleiner
-   11 - kleiner oder gleich
-   12 - gr��er
-   13 - gr��er oder gleich
-   14 - gleich
-   15 - ungleich

Beispiel-Dateien f�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-Men� eines Suchtimers aufrufen.

Weil das Aufsetzen einer neuen epgsearchcats.conf ziemlich l�stig ist, -habe ich ein kleines Tool 'createcats' mitgeliefert, das den Gro�teil -der Arbeit erledigt. Es sollte mit dem Plugin �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 �ber createcats im Manual 'Using createcats')

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

5. Ersetzen des Standardmen�

Um das Plugin als Ersatz f�r VDR's Standard-Men� zu verwenden, gen�gt -es die Zeile

- Green   @epgsearch

in die Datei keymacros.conf zu setzen. Falls kein weiterer Men�eintrag -im Hauptmen� erscheinen soll, dann den Eintrag des Plugins zun�chst im -Setup ausblenden. Um das Plugin trotzdem mit der Taste ``Gr�n'' aufrufen -zu k�nnen, k�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.

Achtung: Versteckt man das Plugin ohne die Verwendung des launcher -plugins oder anderer Patches, die das Aufrufen versteckter Plugins -erlauben, erh�lt man das VDR-Standard-Men� beim Dr�cken von Gr�n. Ab -VDR 1.3.32 sind dazu keine Patches oder Plugins mehr notwendig.

Ein weiterer Ansatz ist ein Patch gegen VDR, der das Standardmen� -'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 Hauptmen� ausgeblendet werden):

- epgsearchonly: - -: -
Wer nur die Suchfunktionen und/oder die Suchtimer von -epgsearch verwenden m�chte oder einfach einen eigenen Hauptmen�eintrag f�r die -Suche w�nscht, kann dies mit diesem Plugin erreichen. Es wird damit ein -Hauptmen�eintrag ``Suche'' erzeugt, der einen direkt in das Suchenmen� f�hrt. -Aktivierung im VDR-Startskript mit ``-Pepgsearchonly''.
-
- conflictcheckonly: - -: -
Die Timer-Konfliktpr�fung kann ebenfalls als eigener -Hauptmen�eintrag angelegt werden. �ber eine Setup-Option l��t sich auch -das Ergebniss der letzten Konfliktpr�fung direkt im Hauptmen� anzeigen. -Aktivierung im VDR-Startskript mit ``-Pconflictcheckonly''.
-

Viel Spass!

Christian Wieninger

Ausf�hrliche Beschreibung

Die ausf�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 verr�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

SIEHE AUCH

epgsearch.conf(5), epgsearchcats.conf(5), epgsearchcmds.conf(5), epgsearchdirs.conf(5), epgsearchmenu.conf(5), epgsearchuservars.conf(5), epgsearchdone.data(5), epgsearchswitchtimer.conf(5), epgsearchblacklists.conf(5), epgsearchchangrps.conf(5)

DATEIEN

epgsearch.conf

Enth�lt die Suchtimer. Siehe epgsearch.conf(5).

epgsearchcats.conf

Enth�lt die Kategorien des erweiterten EPG. Siehe epgsearchcats.conf(5).

epgsearchcmds.conf

Enth�lt Befehle �hnlich der commands.conf, die auf EPG-Eintr�ge angewandt werden k�nnen. Siehe epgsearchcmds.conf(5).

epgsearchdirs.conf

Enth�lt Pfade die beim Bearbeiten eines Suchtimers ausgew�hlt werden k�nnen. Siehe epgsearchdirs.conf(5).

epgsearchmenu.conf

Enth�lt die vom User gew�hlte Konfiguration der OSD Men�darstellung. Siehe epgsearchmenu.conf(5).

epgsearchuservars.conf

Enth�lt die User-Variablen. Siehe epgsearchuservars.conf(5).

epgsearchdone.data

Enth�lt die done-Liste. Siehe epgsearchdone.data(5).

epgsearchswitchtimers.conf

Enth�lt die Umschalttimer. Siehe epgsearchswitchtimer.conf(5).

epgsearchblacklists.conf

Enth�lt die Ausschlussliste. Siehe epgsearchblacklists.conf(5).

epgsearchchangrps.conf

Enth�lt die Kanalgruppen. Siehe epgsearchchangrps.conf(5).

epgsearchtemplates.conf

Enth�lt die Vorlagen f�r Suchtimer. Siehe epgsearchtemplates.conf(5).

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Dieses Programm ist freie Software. Sie k�nnen es unter den Bedingungen -der GNU General Public License, wie von der Free Software Foundation -ver�ffentlicht, weitergeben und/oder modifizieren, entweder gem�� Version 2 -der Lizenz oder (nach Ihrer Option) jeder sp�teren Version.

Die Ver�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 F�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 �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearch.conf.5.html b/html/de/epgsearch.conf.5.html deleted file mode 100644 index 040d505..0000000 --- a/html/de/epgsearch.conf.5.html +++ /dev/null @@ -1,168 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
BEISPIELE
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearch.conf - Die gespeicherten Suchtimer

BESCHREIBUNG

Die in epgsearch angelegten Suchtimer werden in dieser Datei gespeichert.

Sie sollte nicht manuell editiert werden. Verwende stattdessen lieber SVDRP.

FORMAT

Aufgrund von m�glichen Format�nderungen enth�lt die Datei eine Versionsangabe. -Die Format-Version befindet sich in der ersten Zeile der Datei.

Der allgemeine Feldtrenner ist ':'.

Folgende Felder sind m�glich:

-  1 - Einmalige Suchtimer ID
-  2 - Suchstring
-  3 - Verwende Zeit? 0/1
-  4 - Startzeit in HHMM 
-  5 - Stopzeit in HHMM    
-  6 - Verwende Kanal? 0 = nein,  1 = Intervall, 2 = Kanalgruppe, 3 = nur FTA
-  7 - Wenn 'verwende Kanal' = 1 dann ist Kanal ID[|Kanal ID] im VDR Format,
-      Eintr�ge oder min/max Eintr�ge getrennt durch |, wenn 'Verwende Kanal' = 2
-      dann der Kanalgruppenname
-  8 - Beachte Gross-/Kleinschreibung? 0/1
-  9 - Suchmodus:
-      0 - Der gesamte Suchbegriff muss genau so enthalten sein
-      1 - Alle Suchbegriffe (Trenner sind Leerzeichen,',', ';', '|' oder '~')
-          m�ssen enthalten sein.
-      2 - Mindestens ein Suchbegriff muss enthalten sein (Trenner sind
-          Leerzeichen, ',', ';', '|' oder '~').
-      3 - Der Suchbegriff muss genau zutreffen
-      4 - Regul�rer Ausdruck
- 10 - Suche in Titel? 0/1
- 11 - Suche in Untertitel? 0/1
- 12 - Suche in Beschreibung? 0/1
- 13 - Verwende L�nge? 0/1
- 14 - Minimale L�nge der Sendung in Minuten
- 15 - Maximale L�nge der Sendung in Minuten
- 16 - Verwende als Suchtimer? 0/1
- 17 - Verwende Tag der Woche? 0/1
- 18 - Tag der Woche (0 = Sonntag, 1 = Montag...;
-      -1 Sonntag, -2 Montag, -4 Dienstag, ...; -7 So, Mo, Di)
- 19 - Verwende als Serienaufnahme? 0/1
- 20 - Verzeichnis f�r Aufnahme
- 21 - Priorit�t der Aufnahme
- 22 - Lebensdauer der Aufnahme
- 23 - Zeitpuffer am Anfang in Minuten
- 24 - Zeitpuffer am Ende in Minuten
- 25 - Verwende VPS? 0/1
- 26 - Aktion:
-      0 = Lege Timer an
-      1 = Benachrichtige nur per OSD (kein Timer)
-      2 = Schalte nur um (kein Timer)
- 27 - Verwende erweitertes EPG? 0/1
- 28 - Felder des erweiterten EPGs. Dieser Eintrag hat folgendes Format
-      (Trenner ist '|' f�r jede Kategorie, '#' trennt ID vom Wert):
-      1 - Die ID der Kategorie des erweiterten EPGs, festgelegt in
-          F<epgsearchcats.conf>, s. C<epgsearchcats.conf(5)>
-      2 - Wert des erweiterten EPGs f�r diese Kategorie
-          (Ein ':' wird �bersetzt in "!^colon^!", z.B. "16:9" -> "16!^colon^!9")
- 29 - vermeide Wiederholungen? 0/1
- 30 - erlaubte Anzahl Wiederholungen
- 31 - Vergleiche Titel bei Pr�fung auf Wiederholung? 0/1
- 32 - Vergleiche Untertitel bei Pr�fung auf Wiederholung? 0/1
- 33 - Vergleiche Beschreibung bei Pr�fung auf Wiederholung? 0/1
- 34 - Vergleiche erweitertes EPG bei Pr�fung auf Wiederholung?
-      Dieser Eintrag ist ein Bitfeld von Kategorie IDs.
- 35 - Erlaube Wiederholungen nur innerhalb x Tagen
- 36 - L�sche eine Aufnahme automatisch nach x Tagen
- 37 - Aber behalte mindestens x Aufnahmen
- 38 - Schalte x Minuten vor der Sendung um, wenn Aktion = 2
- 39 - Pausiere das Anlegene von Timern wenn x Aufnahmen vorhanden sind
- 40 - Modus der Ausschlussliste: 0 = Aus, 1 = W�hle aus, 2 = Alle
- 41 - Verwende diese Ausschluss-Suchtimer, IDs getrennt durch '|'
- 42 - Fuzzy Toleranz f�r Suche
- 43 - Verwende diese Suche im Favoriten Men�, 0 = Nein, 1 = Ja
- 44 - ID einer Men�vorlage f�r das Suchergebnis

Folgende Zeichen werden bei der Speicherung �bersetzt:

- : => |
- | => !^pipe^!

Es m�ssen nicht alle Felder belegt sein. Gefordert sind lediglich die ersten -11.

BEISPIELE

- #version 2 - DONT TOUCH THIS!
- 1:Kommissar Beck:0:::2:�ffRecht:0:0:1:0:0:0:::1:0:0:1:%Category%~%Genre%:50:99:10:60:0:0:0::1:0:1:1:0:0:0:0:0
- 2:* S�gebrecht:0:::2:Hauptsender:0:0:0:0:0:0:::0:0:0:0:%Category%~%Genre%:50:99:10:10:0:0:1:1#|2#|3#|4#|5#|6#Marianne S�gebrecht|7#|8#|9#|10#|11#|12#|13#:1:0:1:0:0:0:0:0:0

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchblacklists.conf.5.html b/html/de/epgsearchblacklists.conf.5.html deleted file mode 100644 index 0a2d0a8..0000000 --- a/html/de/epgsearchblacklists.conf.5.html +++ /dev/null @@ -1,101 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG

Funktion

FORMAT
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchblacklists.conf - Die gespeicherten Auschlusslisten-Suchtimer

BESCHREIBUNG

In epgsearch k�nnen Ausschlusslisten (Blacklists) angelegt werden.

Dies sind im Grunde normale Suchtimer die in der Datei -epgsearchblacklists.conf gespeichert werden. Zu jedem Suchtimer kann -man dann einen oder mehrere Eintr�ge aus der Ausschlussliste ausw�hlen.

Funktion

Suchtimer ``Krimi'' verwendet Ausschlusssuchtimer ``Tatort''

Ausschlusssuchtimer ``Tatort'' sucht ``Tatort''

Es werden alle Krimis gesucht und anschliessend wird nachgesehen ob ein -Ergebnisse auf den Ausschlusssuchtimer zutrifft. Dieses wird dann verworfen.

FORMAT

Diese Datei hat dasselbe Format wie die Datei epgsearch.conf. F�r den -Aufbau verweise ich auf epgsearch.conf(5).

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchcats.conf.5.html b/html/de/epgsearchcats.conf.5.html deleted file mode 100644 index 1a1e75f..0000000 --- a/html/de/epgsearchcats.conf.5.html +++ /dev/null @@ -1,163 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
BEISPIELE
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchcats.conf - Die Kategorien des erweiterten EPGs, sofern vorhanden.

BESCHREIBUNG

Wenn man das EPG aus dem Internet bezieht, z.B. von H�rzu, enth�lt das EPG -erweiterte Daten. Zus�tzlich zum Titel, Untertitel un der Beschreibung findet -man dann eine Liste der Darsteller, Jahr des Drehs, Episode der Serie, Kategorie -und Genre des Film, etc.

Damit epgsearch diese verwenden kann m�ssen die Felder des erweiterten EPGs -Variablen zugeordnet werden.

Einige Beispieldateien werden dem Plugin mitgeliefert und finden sich im -Verzeichnis ``conf''.

Um eine eigene epgsearchcats.conf zu erstellen dient das mitgelieferte Tool -createcats.

Es scannt das vorhandene EPG und erstellt eine epgsearchcats.conf. Diese -sollte an die eigenen W�nscche angepasst werden, eine Formatbeschreibung -findet sich im Kopf der Datei.

FORMAT

Auszug aus einer epgsearchcats.conf:

--------------------------------------------------------------------

- This is just a template based on your current epg.data. Please edit!
- Perhaps a category or its value list should be removed. Also the
- 'name in menu' should be adjusted to your language.
- The order of items determines the order listed in epgsearch. It does not
- depend on the ID, which is used by epgsearch.
- Format:
- ID|category name|name in menu|values separated by ',' (option)|searchmode
- - 'ID' should be a unique positive integer
-   (changing the id later on will force you to reedit your search timers!)
- - 'category name' is the name in your epg.data
- - 'name in menu' is the name displayed in epgsearch.
- - 'values' is an optional list of possible values
-   if you omit the list, the entry turns to an edit field in epgsearch,
-   else it's an list of items to select from
- - 'searchmode' is an optional parameter specifying the mode of search:
-   text comparison:
-    0  - the whole term must appear as substring
-    1  - all single terms (delimiters are ',', ';', '|' or '~')
-         must exist as substrings. This is the default search mode.
-    2  - at least one term (delimiters are ',', ';', '|' or '~')   
-         must exist as substring.
-    3  - matches exactly
-    4  - regular expression
-   numerical comparison:
-    10 - less
-    11 - less or equal
-    12 - greater
-    13 - greater or equal
-    14 - equal
-    15 - not equal

--------------------------------------------------------------------

BEISPIELE

(Die Zeilen sind gek�rzt, daher unvollst�ndig)

Beispiel f�r EPG von H�rzu, bezogen von epgdata.com mit tvmovie2vdr.

- 1|Category|Kategorie|Information,Kinder,Musik,Serie,Show,Spielfilm,Sport|2

- 2|Genre|Genre|Abenteuer,Action,Wirtschaft,Wissen,Zeichentrick|2

- 3|Format|Video-Format|16:9,4:3|2

- 4|Audio|Audio|Dolby Surround,Dolby,Hoerfilm,Stereo|2

- 5|Year|Jahr||2

- 6|Cast|Besetzung||2

- 7|Director|Regisseur||2

- 8|Moderator|Moderation||2

- 9|Rating|Bewertung|Gro�artig besonders wertvoll,Annehmbar,Schwach|2

- 10|FSK|FSK|6,12,16,18|2

- 11|Country|Land||2

- 12|Episode|Episode||4

- 13|Themes|Thema||4

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchchangrps.conf.5.html b/html/de/epgsearchchangrps.conf.5.html deleted file mode 100644 index a31ffd7..0000000 --- a/html/de/epgsearchchangrps.conf.5.html +++ /dev/null @@ -1,100 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
BEISPIELE
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchchangrps.conf - Liste der Kanalgruppen

BESCHREIBUNG

In epgsearch kann man Sender zu Kanalgruppen zusammenfassen die dann in -den Suchtimern verwendet werden k�nnen.

Hierdurch k�nnen f�r viele Suchtimer auf einmal die durchsuchten Kan�le zentral -neu konfiguriert werden.

In dieser Datei werden die Kanalgruppen gespeichert.

FORMAT

Jede Zeile eine Kanalgruppe. Jede Zeile beginnt mit dem Gruppennamen, dahinter, getrennt durch '|', -die Liste der Kan�le.

BEISPIELE

(Die Zeilen sind gek�rzt, daher unvollst�ndig)

- Private|S19.2E-133-33-46|S19.2E-133-33-51
- ProsiebenSat.1|S19.2E-133-33-46|S19.2E-133-33-47
- RTL World|S19.2E-1-1089-12003||S19.2E-1-1089-12090

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchcmds.conf.5.html b/html/de/epgsearchcmds.conf.5.html deleted file mode 100644 index 97b3816..0000000 --- a/html/de/epgsearchcmds.conf.5.html +++ /dev/null @@ -1,109 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG

Sprachen

FORMAT
BEISPIELE
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchcmds.conf - EPG-Befehle

BESCHREIBUNG

Diese Datei enth�lt �hnlich der commands.conf oder der reccmds.conf Befehle, die -auf die in der Programm�bersicht ausgew�hlte Sendung angewandt werden k�nnen.

Intern besitzt epgsearch 8 nicht ver�nderbare EPG-Befehle.

Wenn eine epgsearchcmds.conf existiert, werden die darin aufgef�hrten Befehle -beginnend mit Nummer 9 gelistet.

Sprachen

Man kann f�r verschiedene Sprachen unterschiedliche Dateien anlegen. Sie -m�ssen dann z.B. epgsearchcmds-deu.conf f�r deutsch oder -epgsearchcmds-eng.conf f�r englisch heissen.

Wenn eine Datei entsprechend der im VDR eingestellten Sprache existiert wird -diese geladen. Existiert eine solche nicht wird versucht epgsearchcmds.conf -zu laden.

FORMAT

Befehlsname : Befehl

BEISPIELE

epg2taste (de): /usr/local/vdr/epg2taste.sh

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchdirs.conf.5.html b/html/de/epgsearchdirs.conf.5.html deleted file mode 100644 index 74dfdda..0000000 --- a/html/de/epgsearchdirs.conf.5.html +++ /dev/null @@ -1,124 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
BEISPIELE
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchdirs.conf - Liste von Aufnahmepfaden zur einfachen Auswahl

BESCHREIBUNG

In epgsearch, speziell beim Editieren von Suchtimern, muss man h�ufig ganze -Verzeichnisspfade eingeben. Da dies oft m�hselig ist, k�nnen in dieser Datei -h�ufig genutzte Pfade vorgegeben werden, die dann im Men� einfach ausgew�hlt -werden k�nnen.

FORMAT

Pro Zeile ein Pfad. Pfade k�nnen Variablen enthalten.

Verwendet werden k�nnen interne Variablen, die Variablen des erweiterten EPG -(epgsearchcats.conf) sowie die in der Datei epgsearchuservars.conf -konfigurierten Variablen.

Folgende internen Variablen stehen zur Verf�gung:

- %title%      - Title der Sendung
- %subtitle%   - Subtitle der Sendung
- %time%       - Startzeit im Format HH:MM
- %date%       - Startzeit im Format TT.MM.YY
- %datesh%     - Startdatum im Format TT.MM.
- %time_w%     - Name des Wochentages
- %time_d%     - Tag der Sendung im Format TT
- %chnr%       - Kanalnummer
- %chsh%       - Kanalname kurz
- %chlng%      - Kanalname lang

F�r weitere Variablen siehe epgsearchcats.conf(5) und epgsearchuservars.conf(5).

Im Auswahlmen� werden die Pfade alphabetisch sortiert dargestellt. Pfade die Variablen -enthalten stehen am Anfang der Liste.

BEISPIELE

- %Category%~%Genre%
- %Category%~%Genre%~%Title%~%Episode%: %Subtitle%
- Information~Natur~%Title%~%Episode%: %Subtitle%
- %Serie%
- Spielfilm~Action
- Spielfilm~Doku
- Spielfilm~Drama
- Spielfilm~Horror
- Musik
- Sport
- Show
- Serie

SIEHE AUCH

epgsearch(1), epgsearchcats.conf(5), epgsearchuservars.conf(5)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchmenu.conf.5.html b/html/de/epgsearchmenu.conf.5.html deleted file mode 100644 index b2cf48c..0000000 --- a/html/de/epgsearchmenu.conf.5.html +++ /dev/null @@ -1,153 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
BEISPIELE
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchmenu.conf - Konfiguration der Men�darstellung

BESCHREIBUNG

Die Darstellung des Men�s des Plugins kann auf die eigenen W�nsche -angepasst werden. Die Konfiguration erfolgt mit Hilfe dieser Datei.

FORMAT

- In dieser Datei k�nnen den Variablen

- MenuWhatsOnNow
- MenuWhatsOnNext
- MenuWhatsOnElse
- MenuSchedule
- MenuSearchResults

Zeichenketten zugewiesen werden die die Darstellung der Men�s im OSD regeln.

Eine Besonderheit stellt MenuSearchResults. Hier kann man der Variablen -MenuSearchResults eine beliebige Zeichenkette anh�ngen:

- MenuSearchResultsSerienlayout=...

Dies bewirkt das man beim Editieren eines Suchtimers nun auch dieses Layout -unter dem Namen ``Serienlayout'' ausw�hlen kann.

So kann man jedem Suchtimer seine eigene OSD Darstellung verpassen.

Es k�nnen alle Variablen verwendet werden. Die Variablen aus dem erweiterten -EPG, die in der epgsearchuservars.conf konfigurierten sowie die folgenden -internen:

- %title%      - Title der Sendung
- %subtitle%   - Subtitle der Sendung
- %time%       - Startzeit im Format HH:MM
- %date%       - Startzeit im Format TT.MM.YY
- %datesh%     - Startdatum im Format TT.MM.
- %time_w%     - Name des Wochentages
- %time_d%     - Tag der Sendung im Format TT
- %time_lng%   - Startzeit in Sekunden seit 1970-01-01 00:00
- %t_status%   - Timerstatus ('T', 't', 'R')
- %v_status%   - VPS Status
- %r_status%   - Running Status
- %status%     - Kompletter Status, das selbe wie
-                '%t_status%%v_status%%r_status%'

F�r die Men�s ``Was l�uft jetzt'' und ``Suchergebniss'', also die Variablen -MenuWhatsOnNow und MenuSearchResults, stehen f�nf weitere Variablen -zur Verf�gung:

- %chnr%       - Kanalnummer
- %chsh%       - Kanalname kurz
- %chlng%      - Kanalname lang
- %chdata%     - VDR's interne Kanaldarstellung (z.B. 'S19.2E-1-1101-28106')
- %progr%      - Grafischer Fortschrittsbalken (nicht f�r das Men� "Suchergenis")
- %progrT2S%   - Fortschrittsbalken im text2skin Stil (nicht f�r das Men� "Suchergenis")

Es wird bei den Variablen nicht zwischen Gross-/Kleinschreibung unterschieden.

Ein Eintrag besteht aus bis zu 6 Tabellenspalten, die Spalten werden durch -'|' getrennt. Der letzte Eintrag jeder Spalte kann die Spaltenbreite durch -angabe einer Breite in Zeichen festlegen. Die Breitenangabe wird durch ':' -vom Variablennamen getrennt.

Wenn du Trenner wie '~', '-' oder '#' verwendest um einzelne Bestandteile zu -trennen, z.B. %title% ~ %subtitle%, dann achtet epgsearch darauf das ein -solcher Trenner nicht am Ende einer Spalte steht.

Die einzelnen Spaltenbreiten sollten angepasst werden, das Aussehen ist vom -verwendeten Skin abh�ngig.

Wenn diese Datei ver�ndert werden soll w�hrend VDR l�uft kann man dem Plugin -den Startparamter '-r' oder '--reloadmenuconf' �bergeben, die Datei wird dann -bei jedem �ffnen des Men�s neu eingelesen.

BEISPIELE

- MenuWhatsOnNow=%chnr%:3|%progrt2s%:5| %time% %t_status%:8|%category%:6| %title% ~ %subtitle%:35
- MenuWhatsOnNext=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
- MenuWhatsOnElse=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
- MenuSchedule=%time% %t_status%:8|%genre%:14| %title% ~ %subtitle%:35
- MenuSearchResults=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon% %subtitle%:35
- MenuFavorites=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon%%subtitle%:35

SIEHE AUCH

epgsearch(1), epgsearchcats.conf, epgsearchuservars.conf

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchswitchtimers.conf.5.html b/html/de/epgsearchswitchtimers.conf.5.html deleted file mode 100644 index 79344d1..0000000 --- a/html/de/epgsearchswitchtimers.conf.5.html +++ /dev/null @@ -1,102 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
BEISPIELE
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchswitchtimer.conf - Die gespeicherten Umschalttimer

BESCHREIBUNG

In epgsearch kann man �ber das Programmen� und die Suchtimer -Umschalttimer anlegen, die einem zu beginn der Sendung auf die -Sendung hinweisen oder gleich umschalten.

Die Umschalttimer werden in dieser Datei gespeichert.

FORMAT

Der allgemeine Feldtrenner ist ':'.

Folgende Felder sind m�glich:

- 1 - Kanal
- 2 - Event ID
- 3 - Startzeit
- 4 - Vorlaufzeit
- 5 - Nur ank�ndigen

BEISPIELE

- S19.2E-1-1089-12060:52221:1153322700:1:0

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchtemplates.conf.5.html b/html/de/epgsearchtemplates.conf.5.html deleted file mode 100644 index f1c9287..0000000 --- a/html/de/epgsearchtemplates.conf.5.html +++ /dev/null @@ -1,87 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchtemplates.conf - Die gespeicherten Suchtimer-Vorlagen

BESCHREIBUNG

F�r die Suchtimer k�nnen Vorlagen angelegt werden. Diese werden hier -gespeichert.

FORMAT

Diese Datei hat dasselbe Format wie die Datei epgsearch.conf. F�r den -Aufbau verweise ich auf epgsearch.conf(5).

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/epgsearchuservars.conf.5.html b/html/de/epgsearchuservars.conf.5.html deleted file mode 100644 index 85f6294..0000000 --- a/html/de/epgsearchuservars.conf.5.html +++ /dev/null @@ -1,206 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT

Zuweisung
Kontroll-Strukturen
Systemaufruf
Verf�gbare Variablen

BEISPIELE
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT and LIZENZ

- - -

NAME

epgsearchuservars.conf - Die Uservariablen

BESCHREIBUNG

In dieser Datei k�nnen Variablen definiert werden die dann in epgsearch -in allen Feldern, in denen Variablen m�glich sind, zur Verf�gung stehen.

FORMAT

Die Variablen selbst sind in dem Format %Variablenname% aufgebaut.

``Variablenname'' kann aus alphanumerischen Zeichen bestehen, Leerzeichen -und Sonderzeichen sind nicht erlaubt.

Zwischen Gross-/und Kleinschreibung wird nicht unterscheiden.

Beispiele f�r m�gliche Namen:

- %Serie% %DokuVar1% %ThemesSubtitleDate1%

Zuweisung

Die Zuweisung eines Wertes erfolgt so:

- %Serie%=Neue Serie~Krimi

Hier wird der Variablen %Serie% die Zeichenkette ``Neue Serie~Krimi'' zugewiesen.

Es wird immer eine Zeichenkette zugewiesen. Leerzeichen werden daher auch -als Leerzeichen mit �bernommen.

- %Pfad%=%Serie%

Hier wird der Variablen %Pfad% der Inhalt der Variablen %Serie% zugewiesen.

Das l�sst sich beliebig verwenden.

- %Pfad%=%Serie%~Tatort

Pfad enth�lt hier den String ``Neue Serie~Krimi~Tatort''.

Kontroll-Strukturen

Einfache ``if then else'' Konstrukte sind m�gliche.

Innerhalb dieser Konstrukte k�nnen keine Strings, wohl aber Variablen -zugwiesen werden. Leerzeichen werden ignoriert.

- %Foo%=Verschiedenes

- %Variable%=%Pfad% ? %Pfad% : %Foo%

Ist Pfad nicht leer, weise %Variable% den Inhalt aus %Pfad% zu, sonst -den Inhalt aus %Foo%.

``%Pfad% ?'' bedeutet also ``nicht leer?''. Es sind auch andere Pr�fungen -m�glich.

- %Variable%=%Pfad%!=5 ? %Pfad% : %Foo%

``%Pfad%!=5 ?'' bedeutet ``ist %Pfad% ungleich 5?''

Es k�nnen auch Variablen verglichen werden.

- %Fuenf%=5

- %Variable%=%Pfad%!=%Fuenf% ? %Pfad% : %Foo%

Folgende Pr�fungen sind m�glich:

- ==   ist gleich
- !=   ist nicht gleich

Systemaufruf

Es k�nnen auch externe Programme/Scripte aufgerufen werden. Die zur�ck- -gegebene Zeichenkette wird dann einer Variablen zugewiesen.

- %Ergebnis%=system(scriptname,%Variable1% %Variable2% -f %Variable3% --dir=%Variable4% --dummy)

Ruft das Script ``scriptname'' mit den Parametern ``%Variable1%'', -``%Variable2%'', usw. auf. Das Ergebnis wird der Variablen %Ergebnis% -zugewiesen.

Es sind beliebig viele Variablen m�glich.

Wenn n�tig, umfasst epgsearch die Variablen automatisch mit ``''.

Das Script darf nur eine Zeichenkette ohne Zeilenumbruch zur�ckgeben.

Erfolgt keine R�ckgabe wird der Variablen %Ergebnis% eine leere Zeichenkette -zugewiesen.

Verf�gbare Variablen

Folgende Variablen sind bereits intern definiert und k�nnen verwendet -werden.

- %title%          - Title der Sendung
- %subtitle%       - Subtitle der Sendung
- %time%           - Startzeit im Format HH:MM
- %timeend%        - Endzeit im Format HH:MM
- %date%           - Startzeit im Format TT.MM.YY
- %datesh%         - Startdatum im Format TT.MM.
- %time_w%         - Name des Wochentages
- %time_d%         - Tag der Sendung im Format TT
- %time_lng%       - Startzeit in Sekunden seit 1970-01-01 00:00
- %chnr%           - Kanalnummer
- %chsh%           - Kanalname kurz
- %chlng%          - Kanalname lang
- %chdata%         - VDR's interne Kanaldarstellung (z.B. 'S19.2E-1-1101-28106')

- %summary%        - Beschreibung
- %htmlsummary%    - Beschreibung, alle CR ersetzt durch '<br />'
- %eventid%        - Event ID

- %colon%          - Das Zeichen ':'
- %datenow%        - Aktuelles Datum im Format TT.MM.YY
- %dateshnow%      - Aktuelles Datum im Format TT.MM.
- %timenow%        - Aktuelle Zeit im Format HH:MM
- %videodir%       - VDRs Aufnahme-Verzeichnis (z.B. /video)
- %plugconfdir%    - VDRs Verzeichnis f�r Plugin-Konfigurationsdateien (z.B. /etc/vdr/plugins)
- %epgsearchdir%   - epgsearchs Verzeichnis f�r Konfiguratzionsdateien (z.B. /etc/vdr/plugins/epgsearch)

Desweiteren k�nnen die in der Datei epgsearchcats.conf definierten Variablen -verwendet werden. Siehe dazu epgsearchcats.conf(5).

BEISPIELE

- # Wochentag, Datum, Uhrzeit
- %Datum%=%time_w% %date% %time%

- # Themes oder Subtitle oder Datum
- %ThemesSubtitleDate1%=%Subtitle% ? %Subtitle% : %Datum%
- %ThemesSubtitleDate%=%Themes% ? %Themes% : %ThemesSubtitleDate1%

- # Rufe das Script auf das den Aufnahmepfad erzeugt
- %DokuScript%=system(doku.pl,%Title%,%Subtitle%,%Episode%,%Themes%,%Category%,%Genre%)
- %Doku%=%DokuScript%

SIEHE AUCH

epgsearch(1), epgsearchcats.conf(5)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LIZENZ

Der Author kann �ber cwieninger@gmx.de 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..

- - - - diff --git a/html/de/noannounce.conf.5.html b/html/de/noannounce.conf.5.html deleted file mode 100644 index 07aecdb..0000000 --- a/html/de/noannounce.conf.5.html +++ /dev/null @@ -1,85 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT und LIZENZ

- - -

NAME

noannounce.conf - Liste von Sendungen, die nicht mehr per OSD angek�ndigt -werden sollen.

BESCHREIBUNG

Diese Datei enth�lt eine Liste von Sendungen die markiert wurden, sodass diese -nicht mehr durch den Suchtimer-Hintergrund-Thread per OSD angek�ndigt werden.

Wenn w�hrend der Ank�ndigung einer Sendung eine der Tasten '0', ... '9' oder -'Ok' gedr�ckt wird, wird nachgefragt, ob zuk�nftige Ank�ndigungen vollst�ndig -(bei den Tasten '0' oder 'Ok') oder nur f�r die n�chsten x Tage (bei den -Tasten '1' bis '9') unterdr�ckt werden sollen. Best�tigt man diese Abfrage -durch ein erneutes 'Ok', wird die Einstellung entsprechend �bernommen.

FORMAT

Pro Zeile eine Sendung, die Felder werden durch ':' getrennt.

Folgende Felder existieren:

-  1 - Titel
-  2 - Episode
-  3 - Kanal-Kennung
-  4 - Startzeit
-  5 - Zeitpunkt f�r n�chste Ank�ndigung

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT und LIZENZ

Dieses Dokument wird unter den Bedingungen der Gnu Public License -(GPL) ver�ffentlicht. Alle Angaben sind nach bestem Wissen, aber -nat�rlich ohne Gew�hr (no warranty in any kind).

- - - - diff --git a/html/de/timersdone.conf.5.html b/html/de/timersdone.conf.5.html deleted file mode 100644 index 07308d0..0000000 --- a/html/de/timersdone.conf.5.html +++ /dev/null @@ -1,86 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
BESCHREIBUNG
FORMAT
SIEHE AUCH
AUTOR (man pages)
FEHLER MELDEN
COPYRIGHT und LIZENZ

- - -

NAME

timersdone.conf - Liste von anstehenden Timern, die von Suchtimern erzeugt -wurden.

BESCHREIBUNG

Diese Datei enth�lt eine Liste von anstendenden Timern, die von Suchtimern -erzeugt wurden. Wenn die Setup-Option 'Timer nach L�schen neuprogrammieren' -auf nein steht, benutzt epgsearch diese Liste, um zu pr�fen, ob ein Timer -bereits angelegt wurde und erstellt den Timer in diesem Fall nicht nochmals. -Sobald die zugeh�rige Aufnahme stattgefunden hat, wird der Timer automatisch -aus dieser Liste entfernt.

FORMAT

Pro Zeile ein Timer, die Felder werden durch ':' getrennt.

Folgende Felder existieren:

-  1 - Kanal-Kennung
-  2 - Startzeit
-  3 - Stopzeit
-  4 - Suchtimer-ID
-  5 - Titel der Sendung
-  6 - Untertitel der Sendung

SIEHE AUCH

epgsearch(1)

AUTOR (man pages)

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

FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT und LIZENZ

http://www.cwieninger.de.vu/

Dieses Programm ist freie Software. Es darf nach belieben benutzt, -kopiert, modifiziert, verteilt und verkauft werden, solange niemand -anderem das Recht abgesprochen wird dasselbe zu tun.

- - - - diff --git a/html/en/createcats.1.html b/html/en/createcats.1.html deleted file mode 100644 index 7bb4f44..0000000 --- a/html/en/createcats.1.html +++ /dev/null @@ -1,145 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

createcats - helps you creating your own epgsearchcats.conf

SYNOPSIS

createcats [OPTIONS] /path_to/epg.data

DESCRIPTION

This tool is deliverd with the plugin and should exist in the plugins -source directory after compilation. It helps you in creating your own -epgsearchcats.conf, if the samples in directory 'conf' don't fit your needs.

createcats takes your epg.data as argument and scans it for suitable -EPG infos. Such an info is a set of a category name and a coresponding -value at the beginning of a line (represented with '|') and has the -form '|category: value', e.g.

- |Genre: Action

So simply call it with

createcats /path_to/epg.data

The output is a file epgsearchcats.conf, that should be copied to your -plugins config dir. Before using it, you should do some customizing, -since not all things in the file will be suitable to be used as -extended EPG info.

OPTIONS

The full set of arguments is:

usage: createcats [OPTIONS] /path_to/epg.data

- -m N, --minappearance=N    the minimum number a category has to appear
-                            to be used
- -v N, --maxvalues=N        values of a category are omitted if they exceed
-                            this number
- -l N, --maxlength=N        the maximum length of a text to be accepted
-                            as a category value
- -h, --help                 this help

Some notes:

-m N, --minappearance=N - -: -
createcats counts how often a category is used in your current -epg.data. If this is less than N, then this category will not be part -of the resulting epgsearchcats.conf.
-
-v N, --maxvalues=N - -: -
if the number of values for a category is more than N then createcats -will not output a value list for this category. As a consequence in -epgsearch the menu item gets an edit item, that can be filled with -every text. Else, the item gets a selection item, that lets you select -from a list of values.
-
-l N, --maxlength=N - -: -
if the text length of a value is more than N, this value is not part -of the value list.
-

Hint: Results are best, if your current EPG is as big as possible. So -update it, if you are using an external EPG provider, before calling -createcats.

Please edit this file now, since it will contain also things not suitable.

After that copy it to your plugins config directory.

AUTHOR (man pages)

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

REPORT BUGS

Bugreports (german):

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LICENSE

This program is free software; you can redistribute it and/or -modify it under the terms of the GNU General Public License -as published by the Free Software Foundation; either version 2 -of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, -but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -GNU General Public License for more details.

You should have received a copy of the GNU General Public License -along with this program; if not, write to the Free Software -Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA -Or, point your browser to http://www.gnu.org/licenses/old-licenses/gpl-2.0.html

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearch.1.html b/html/en/epgsearch.1.html deleted file mode 100644 index eff8459..0000000 --- a/html/en/epgsearch.1.html +++ /dev/null @@ -1,1311 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
OVERVIEW
OPTIONS
CONTENT
1. Description

1.1 Menu Commands
1.2 Menu search

1.2.1 Menu edit search
1.2.2 Menu search results

1.3 Extended 'now' and 'next' and favorites
1.4 Menu setup

1.4.1 General
1.4.2 EPG menus
1.4.3 User-defined EPG times
1.4.4 Timer programming
1.4.5 Search and search timers
1.4.6 Timer conflict checking
1.4.7 Email notification

2. Search timers

2.1 'Avoid repeats' - internals
2.2 How do we compare two events?
2.3 How and when do we compare?

3. Usage from other plugins or scripts
4. Using extended EPG info
5. Replacing the standard schedule menu
6. Add-ons
Advanced description
SEE ALSO
FILES
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearch - Searchtimer and replacement of the VDR program menu

OVERVIEW

EPG-Search can be used as a replacement for the default schedules -menu entry. It looks like the standard schedules menu, but adds some -additional functions:

- - Commands for EPG entries with 5 built-in commands like 'show repeats',
-   'create search'. One can add own commands for other needs, like adding a
-   VDRAdmin auto-timer.

- - Add up to 4 user-defined times to 'now' and 'next' and an optional
-   favorites menu

- - Searching the EPG: Create reusable queries, which can also be used
-   as 'search timers'.

- - Search timers: Search for broadcasts in the background and add a
-   timer if one matches (similar to VDRAdmin's auto-timers) or simply
-   make an announcement about it via OSD

- - Avoid double recordings of the same event
-   * timer preview
-   * recognition of broken recordings
-   * fuzzy event comparison

- - Progress bar in 'What's on now' and 'What's on next'

- - Shift the time displayed by key press, e.g. 'What's on now' + 30 minutes

- - Start menu can be setup between 'Schedule' or 'What's on now'

- - background check for timer conflicts with a timer conflict manager

- - detailed EPG menu (summary) allows jumping to the next/previous
-   event

- - support for extended EPG info for search timers

- - extension of the timer edit menu with a directory item, user
-   defined weekday selection and a subtitle completion.

- - Timer conflict check, informs you over the OSD about conflicts

- - Timer conflict menu, show detailed information about the conflicts
-   and let you resolve them

- - Email notifications about search timer updates and timer conflicts

Works only with >= vdr-1.3.46 or newer.

Parts of the sources are based on the repeating-ECG patch from Gerhard Steiner, who gave me the permission to use them. Thanks for his work!

OPTIONS

-f file, --svdrpsendcmd=file - -: -
the path to svdrpsend.pl for external SVDRP communication (default is -internal communication, so this is usually not needed anymore)
-
-c path, --config=path - -: -
to specify a specific config directory for all epgsearch config files, default -is '<plugins configuration directory>/epgsearch'
-
-l file, --logfile=file - -: -
to specify a specific log file for epgsearch (default log file is -epgsearch.log in the epgsearchs config directory)
-
-v n, --verbose=n - -: -
verbose level for log file. Value 0 means no logging. Other values -are 1 (general messages), 2 (detailed messages), 3 (planned for extra -detailed info for debugging purposes)
-
-r, --reloadmenuconf - -: -
reload epgsearchmenu.conf with plugin call. This can be useful when testing -customized menu layouts.
-
-m file, --mailcmd=file - -: -
the external command to be used for mail delivery. The default uses -'sendEmail.pl'. If you are using a different command or script make sure that -it has the same parameter interface as sendEmail.pl.
-

CONTENT

- 1.    Description
- 1.1     Menu commands
- 1.2     Menu search
- 1.2.1     Menu edit search
- 1.2.2     Menu search results
- 1.3     Extended 'now' and 'next'
- 1.4     Menu setup
- 2.    Search timers
- 2.1     'Avoid repeats' - internals
- 2.2     How do we compare two events?
- 2.3     How and when do we compare?
- 3.    Usage from other plugins or scripts
- 4.    Using extended EPG info
- 5.    Replacing the standard schedule menu
- 6.    Add-ons

1. Description

At first glance EPG-Search looks like the schedules menu entry of VDR. -By pressing the key '0', one can toggle the bottom color keys to access -additional functions (the default assignment of the color keys can be -adjusted by setup):

1.1 Menu Commands

This menu displays commands that can be executed on the current -item. There are 8 built-in commands:

- - Repeats: Searches for repeats

- - Record

- - Switch

- - Create search
-   Switches to search menu and adds a new search with the name of the current
-   item (to avoid editing the name manually)

- - Search in recordings:
-   Search the recordings for a broadcast with the same name

- - Mark as 'already recorded':
-   This puts the selected event in the file epgsearchdone.data and instructs
-   epgsearch to avoid recording this event if an according search timer is set
-   to "avoid repeats". An already created timer will be automatically removed
-   with the next search timer update.

- - Add/Remove to/from switch list?:
-   Controls the switch list. If there is an event in the switch list, epgsearch
-   will announce it and switch to the event before it starts. To access the
-   complete switch list, call 'Search/Actions/Switch list'.

- - Create blacklist:
-   A blacklist is used to ignore events when using search timers. A search
-   timer can be setup to ignore events from arbitrary blacklists.

You can add your own commands to this menu by editing the file -epgsearchcmds.conf in epgsearchs config directory. There's a sample -conf file with some sample commands (see directory 'scripts', taken -from vdr-wiki.de, thanks to the authors).

The format of the file is the same as VDR's commands.conf or -reccmds.conf. When a command is executed the following parameters -are passed to it:

- $1: the title of the EPG entry
- $2: the start time of the EPG entry as time_t value (like in the 
-     shutdown script)
- $3: the end time
- $4: the channel number of the EPG entry
- $5: the long channel name of the EPG entry
- $6: the subtitle of the EPG entry, "" if not present

To execute a command from the main menu you can also press its -associated number without opening the commands menu.

1.2 Menu search

Here you can add, edit, delete and execute your own queries on the -EPG. The usage and behavior of this menu is similar to VDR's timer -menu.

1.2.1 Menu edit search

Most things in this menu are quite clear, so only some notes on:

- Search term: - -

The term to search for. If you like to search for more words, separate -them by blanks. Leaving this empty (combined with search mode -'Phrase') will match anything. This is useful, if you search e.g. for -anything that starts between some times on a specific channel.

With 'blue' you can also select a template for the new search. If -one of the templates is set to default, new searches will -automatically get the settings of the default template.

Note: fuzzy searching is limited to 32 chars!

- Search mode: - -

'Phrase' searches for the expression within the EPG. 'All words' -requires, that each word of the expression occurs in the EPG item. -'at least one word' requires, that only one word occurs in the EPG item. -'Match exactly' requires, that your search term matches exactly the -found title, subtitle or description.

With 'Regular expression' you can setup a regular expression as -search term. You don't need a leading and trailing '/' in the -expression. By default these are POSIX extended regular expressions. -If you like to have Herl compatible regular expression, simply edit -the plugins Makefile and uncomment #HAVE_PCREPOSIX=1 to -HAVE_PCREPOSIX=1 (you will need pcreposix installed, comes with -libpcre from www.pcre.org, but it's already part of most distributions).

See also epgsearch(4) 'Description of the search process'.

- Use extended EPG info: - -

Only available if configured, see below 'Using extended EPG info'.

- Ignore missing categories: - -

If set to 'Yes' this tells epgsearch that a missing EPG category -should not exclude an event from the results. Caution: Using this without -any other criterions could flood your timers.

- Use channel: - -

Search only for events in the given channels interval, channel -groups or FTA channels only.

Channel groups (e.g. sport channels or Pay-TV channels) can be -managed with a sub-menu called with 'blue'.

ATTENTION: After changing the channels order please check the -settings of your search timers!

- Use day of week: - -

Besides the weekdays you can also set up a user-defined selection, -e.g. search only on Monday and Friday.

You'll find the user-defined selection in the list after Friday.

- Use blacklists: - -

You can select one or more or all blacklists here. If any search result -is also contained in one of the selected blacklists it will be skipped.

- Use in favorites menu: - -

Only available if turned on in setup. With this option you can mark a search -to be used in the favorites menu. The search results of all these searches are -listed in the favorites menu.

- Result menu layout: - -

Only available if you have defined more than one menu template for search -results in epgsearchmenu.conf. This option is used to assign a different menu -layout for the search results of this search.

- Use as Search Timer: - -

If set to yes, the plugin will do a background scan of the EPG in -certain intervals and add a timer, if there is a match. You have to -activate the 'search timers' in the setup. If set to ``user defined'' one -can specify time margins with key 'blue' where the search timer is active -or not.

- Action: - -

Default action is creating a timer for the search results. But you can -also choose to simply announce the found event via OSD or to switch -to the event one minute before it starts.

- Serial recording: - -

If set to yes, the recordings will be stored in a folder with the name -of the broadcasting and the recordings itself will have the name of -the episode. If there is no episode name, the date and time of the -recording will be used.

- Directory: - -

Here you can assign a directory, where the recording should be stored, -e.g. 'SciFi'. Use the key 'blue' to select directory entries already -used in other search entries or given by entries in the file -epgsearchdirs.conf (simply place your directories here one at each line -without the leading video directory, also see MANUAL). -If your provider delivers extended EPG infos you can also use -variables like ``%Genre%'' or ``%Category%'' in your directory -entry. These are replaced with the current EPG info, when a timer is -created.

See also epgsearch(4) 'Using variables in the directory -entry of a search timer'.

- Delete recordings after ... days: - -

Some recordings should only be kept for a few days, like news. With -this feature you can tell epgsearch to delete them automatically -after ... days.

- Pause if ... recordings exist: - -

If the given numbers of recordings currently exists, then epgsearch -will not create further timers. After deleting one or more -recordings it will go on generating new timers.

- Avoid repeats: - -

If you don't want to record repeats, this feature tries to check if -an event was already recorded/programmed and skips it. Please refer -to the section 'Avoid repeats - internals' below before using it.

- Allowed repeats: - -

If you like to accept a certain amount of repeats you can give here -their number.

- Only repeats within ... days: - -

Give here the number of days a repeat has to follow its first -broadcast. 0 is equal to no restriction.

- Compare title: - -

When comparing to events then specify here if the title should be -compared.

- Compare subtitle: - -

When comparing to events then specify here if the subtitle should be -compared. If there is no subtitle than this event is always -different to an event with/without a subtitle.

- Compare description: - -

When comparing to events then specify here if the description should -be compared.

For comparison all parts of the description, that look like a -category value, are removed first. The remaining text will be -compared. If this is similar at 90% (regarding the -Levinshtein-Distance algorithm) then it will be accepted as equal.

- Compare categories: - -

With the button 'setup' you can also specify which categories should -be compared. As with subtitles an event is different if it has no -according category value.

- Priority, lifetime, margins for start and stop: - -

Each search timer can have its own settings for these parameters. -Defaults can be adjusted in the plugins setup.

- VPS: - -

If set to yes, VPS is used, but only, if activated in VDR's setup menu and -if the broadcasting has VPS information.

- Auto delete: - -

to automatically delete a search timer if the following is true:

- * after x recordings, or
- * after x days after the first recording

Only complete recordings are counted. The deletion is executed directly after -the correspondig recording

To toggle the flag 'Use as search timer' without editing the search -entry you can use the key '2'. This will call directly the second -command of the command menu.

1.2.2 Menu search results

This menu displays the search results. A 'T' lets you know, that there -is already a timer for the event. A 't' means that there's only a -partial timer for it, as in standard schedules menu.

1.3 Extended 'now' and 'next' and favorites

By setup, one can add up to 4 additional times to extend the green -button, e.g. 'afternoon', 'prime time', 'late night'. Times, that are -already passed, are skipped (you will not get 'afternoon' at evening) with the -exception that a time will be displayed for the next day, if it is less then -20h in the future. -In these menus you can shift the currently displayed time by pressing -FastRew or FastFwd to move back and forward in time. If you don't have -these keys on your remote, you can access this function by pressing -'0' to toggle the green and yellow button to '<<' and '>>'. This toggling -can be adjusted by setup.

You can display a progress bar in 'now' and 'next'. When using text2skin you -should use the setup option ``text2skin'' in the setup option ``Show progress in -'Now'''/Show progress in 'Next'`` (the setting 'graphical' may also work with -text2skin, but this depends on the selected skin).

Furthermore you can enable in the setup an favorites list. You can configure -your searchtimers (``Use in favorite list'') to display their results in -you favorite list. This list display event in the next 24 hours ordered by time.

1.4 Menu setup

1.4.1 General

- Hide main menu entry: - -: -
This hides the main menu entry 'search'. Attention: when the plugin is -assigned to key 'green' then hiding the plugin will give you VDR's -standard schedule menu (see below to avoid this).
-
- Main menu entry: - -: -
If not hidden, the name of main menu entry can be set here. Default is -'Program guide'. Note: If you set it to something different from the default -then the main menu entry is no longer dependent on the OSD language. Setting -it back to default or empty restores this behavior again.
-
- Start menu: - -: -
Select the starting menu 'Schedules' or 'Now'
-

1.4.2 EPG menus

- Ok key: - -: -
Choose here the behavior of key 'Ok'. You can use it to display the summary -or to switch to the corresponding channel. Note: the functionality of key -'blue' (Switch/Info/Search) depends on this setting.
-
- Red key: - -: -
Select if you like to have Standard ('Record') or 'Commands' as -assignment for key 'red'.
-
- Blue key: - -: -
select if you like to have Standard ('Switch') or 'Search' as -assignment for key 'blue'.
-
- Show progress in 'Now': - -: -
In the menu 'what's on now' you can display a progress bar, that -displays the progress of the current item. When using text2skin you -should use the setup option ``text2skin'' (the setting 'graphical' may also -work with text2skin, but this depends on the selected skin).
-
- Show channel numbers: - -: -
Select this if you like to have a leading channel number before each -item in the EPG menus.
-
- Show channel separators: - -: -
Display channel group separators between channel in the menus -'Overview now',...
-
- Show day separators: - -: -
Display a day separator between events on different days in the -schedule menu.
-
- Show radio channels: - -: -
Also list radio channels.
-
- Limit channels from 1 to: - -: -
If you have a large channel set you can speed up things when you limit the -displayed channels with this setting. Use '0' to disable the limit. If the -current channel is above the limit, the limit is ignored and all channels will -be displayed again.
-
- 'One press' timer creation: - -: -
If set to 'yes' a timer is immediately created when pressing 'Record' as -introduced in vdr-1.3.38, else the timer edit menu is displayed.
-
- Show channels without EPG: - -: -
Display channels without EPG to allow switching or create a timer.
-
- Time interval for FR/FF [min]: - -: -
In the menus 'now', 'next', 'user def 1', ... you can shift the -displayed time by pressing FastRew, FastFwd on your remote control. -Adjust the amount of minutes to jump here.
-
- Toggle Green/Yellow: - -: -
If you don't have FastRew, FastFwd on your remote control, set this to -yes. When pressing '0' in the menus, this toggles the assignment of -the color keys and assigns e.g. '<<' and '>>' to 'green' and 'yellow'.
-
- Show favorites menu: - -: -
A favorites menu can display a list of your favorite broadcasts. Enable this -if you want an additional menu besides 'Now' and 'Next'. You can choose -between displaying this menu before or after the menus with user-defined -times. Any search can be used as a favorite. You only have to set the option -'Use in favorites menu' when editing a search.
-
- for the next ... hours: - -: -
This value lets you adjust the timespan used to display the favorites.
-

1.4.3 User-defined EPG times

- Use user time 1..4: - -: -
Add up to 4 user-defined times besides 'now' and 'next'.
-
- Description: - -: -
Name of the user-defined time, e.g. 'Afternoon', 'Prime time', 'Late -night'.
-
- Time: - -: -
The associated time of the user-defined time.
-

1.4.4 Timer programming

- Use VDR's timer edit menu: - -: -
When programming a standard timer epgsearch uses an extended menu, -that also supports a directory item, user defined weekday selection -and subtitle completion. If you are using a patched version of VDR, -that also has an extended timer edit menu and like to use this menu -rather than epgsearch's then set this option to 'Yes'.
-
- Default recording directory: - -: -
This entry will be used in standard timer programming as default -directory. You can also use EPG category variables (e.g. 'My -Movies~%Category%~%Genre%'). When the timer edit menu is launched -epgsearch tries to replace all variables with the values found in -the description of the event. If not all variables could be replaced -then the directory item is left blank.
-
- Add episode to manual timers: - -: -
When manually adding a timer epgsearch can automatically add the -episode name to the timer file resulting in a sub-folder for the -later recording, that is named with the episode name. Choose here how -this should be done. 'smart' tries to recognize if this makes -sense. Therefore it checks the length of the event and skips the -subtitle if the event has more than 80min.
-
- Default timer check method: - -: -
Manual timers can be checked for EPG changes. Here you can setup the default -check method for each channel. The following methods exist: - * no check - * by event ID: checks by an event ID supplied by the channel provider. - * by channel and time: check by the duration match.
-; -
Not all channels provide a proper event ID, so you can setup the default for -each channel here. When programming a manual timer, this default use used in -epgsearch's own timer edit menu.
-

1.4.5 Search and search timers

- Use search timers: - -: -
If yes, the plugin makes a background scan of the EPG and adds timers -if it finds matching entries. This applies only to searches that are -marked with 'use as search timer'.
-
- Update interval: - -: -
The update interval of the background scan for search timers in minutes.
-
- SVDRP port: - -: -
If you are using a SVDRP port other than 2001 then enter this here -to get the search timers working.
-
- Default Priority: - -: -
Default priority of generated timers.
-
- Default Lifetime: - -: -
Default lifetime of generated timers.
-
- Margin at start/stop: - -: -
Default margins of generated timers.
-
- No announcements when replaying: - -: -
suppress event announcements while any replay is active.
-
- Recreate timers after deletion: - -: -
epgsearch remembers by default which timers where already created by search -timers and will not recreate them if they were removed. To disable this -behaviour set this to 'Yes'.
-; -
Default margins of generated timers.
-
- Ignore Pay-TV channels: - -: -
Set this to 'Yes' if you don't want to have events from Pay-TV channels when -searching for a repeat.
-
- Search templates: - -: -
Here you can manage search templates which can be used when creating a -search.
-
- Blacklists: - -: -
Here you can manage blacklists which can be used to suppress unwanted events -within a search.
-
- Channel groups: - -: -
Here you can setup channel groups (e.g. Sport channels, Pay-TV -channels) that can be used as criterion in searches. The same can -be done in the search edit menu.
-

Important: if you get your EPG from external sources make sure that search -timer updates are disabled while your EPG is updated. The reason for this is -that epgsearch will remove timers without events assigned to them. This -situation can exist while the new EPG is feeded to VDR. A simple way to -disable search timer updates is to use the SVDRP command SETS in your EPG -update script:

svdrpsend.pl plug epgsearch SETS off

svdrpsend.pl plug epgsearch SETS on

1.4.6 Timer conflict checking

- Ignore below priority: - -: -
If a timer will fail with a priority below the given value, you won't get an -OSD message about this and the conflict will be classified as 'not relevant' -in the conflicts overview.
-
- Ignore conflict duration less ... min.: - -: -
If a conflict will last only the given minutes it will not produce an OSD -message and the conflict will be classified as 'not relevant' -in the conflicts overview.
-
- Only check within next ... days: - -: -
Here you can specify the day range that should be used for the conflict -check.
-
- After each timer programming: - -: -
This performs a conflict check after each manual timer programming and - if -the new/modified timer is involved in a conflict - pops up an OSD message -about it.
-
- ``When a recording starts: - -: -
Set this to 'yes' if the conflict check should be performed when a recording starts. -In the case of a conlfict you get immediately a message that informs you about it. -The message is only displayed if the conflict is within the next 2 hours.
-
- After each search timer update: - -: -
Specify here if you want to have a conflict check after each search timer -update. If set to 'No':
-
- every ... minutes: - -: -
performs a conflict check in the background every ... minutes and informs -about relevant conflicts via OSD. Set this to '0' to disable this feature.
-
- if conflicts within next ... minutes: - -
-
- every ... minutes: - -
-
if you like to have a more frequent check and OSD notification when a -conflict appears within the given time, use this feature.
-
- -
-
- Avoid notification when replaying: - -: -
Set this to 'yes' if the don't want to get OSD messages about conflicts if -you currently replay something. Nevertheless messages will be displayed if - the first upcoming conflict is within the next 2 hours.
-

Also have a look at epgsearch(4), section 'Working with the timer conflict menu'.

1.4.7 Email notification

Please make sure, that 'sendEmail.pl' is in the path of your executables and -that the 'epgsearchupdmail.templ' and 'epgsearchconflmail.templ' exists in -epgsearch's configurations directory!

- Search timer notification: - -

Enable this, if you want to get an email notification, when the search timer -background thread has

-  - created a new timer
-  - modified an existing timer
-  - deleted a timer, that was void because of EPG changes or other user
-    actions.

(Also requires 'Use search timers' in the search timer setup to be activated.)

- Timer conflict notification: - -

Enable this, if you want to get an email notification about timer -conflicts. The notification will only include 'relevant' conflicts as -specified in the timer conflict setup. epgsearch will always send a new -notification if there is any change in the current conflicts.

(Also requires 'After each search timer update' or 'every ... minutes' in the -conflict check setup to be activated.)

- Send to: - -

The mail adress of the recipient. Note: Some providers (like Arcor) don't -allow the same adresse for sender and recipient.

- Mail method: - -

You can choose between:

-  - sendEmail.pl: this is a simply script shipped with epgsearch, that allows
-    mail delivery also on systems without a configured mail server. Please
-    copy it to your $PATH
-  - sendmail: requires a properly configured mail system

- Email address: - -

Your full(!) email account address to be used for sending the mail.

- SMTP server: - -

The name of your SMTP server to be used for sending the mails.

- Use SMTP authentication: - -

Select 'yes' if your account needs authentication to send mails.

- AUTH user: - -

Specify the accounts username if your account needs authentication.

- AUTH password: - -

Specify the accounts password if your account needs authentication. -Note: The password is saved as plain text. You have to make sure on your own -that your system is safe and no VDR configurations files are visible to non -authorized persons.

After the account setup, check if it works with 'Test'. If you are -using 'sendEmail.pl' for mail delivery, there should be something like 'Email -sent successfully' at the end of the test output. The test function is not -available for method 'sendmail'.

Also have a look at epgsearch(4), section 'Email notifications'.

2. Search timers

This is quite the same as VDRAdmin's auto-timers, but needs no external -software. When you create a search, you can give it an option to use -it as search timer. Now the plugin scans EPG entries in certain update -intervals (->setup) in the background and creates timers if there -are matching entries. If you don't like to get a new timer, but only -want to be informed about the event set 'Announce only (no timer)' to -yes. -Since these search timers are quite useful for serials, you can set -the option 'serial recording' in a search, which creates timers -whose recordings are stored in a folder with the serials name and -whose entries are named with the episode name. If there is no episode -name, the plugin names the recording with a date/time string.

To use search timers, you also have to activate them in the plugins setup. -Also edit the SVDRP port, if you are not using the default 2001.

If you want to trigger a background scan manually simply

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

This can also be part of your shutdown script. (Add here a sleep -afterwards to give the plugin the time to finish the scan.)

For more info about searchtimers please refer to epgsearch(4), -'Description of the search process' and 'How do Search Timers work?'

2.1 'Avoid repeats' - internals

This section explains the feature 'Avoid repeats' for a search timer. -Sometimes one cannot avoid double recordings of an event only by -setting the corresponding search criterions.

Therefore the feature 'avoid repeats' tries to check before creating a -timer, if the same event was already recorded in the past or if there -is a timer that records the same event. If so, there will be no new -timer for the event.

2.2 How do we compare two events?

To check if two events are the same there are many possible settings -for a search timer. You can choose the title, subtitle, description or -extended EPG categories within the description of an event to be -compared with the elements of another event.

This comparison is always done case-sensitive and for the whole -term. But the description of an event makes an exception of this. -First all text within the description will be truncated that looks -like an extended category entry, e.g. 'Rating: tip'. An extended -category entry is a line of text beginning with max. 40 signs, -followed by ':' and ending with max. 60 further signs. -The reason for this cutting is that some categories like the rating of -an event are not part of the description of the repeat of the same -event.

The remaining text will now be compared by length. If the difference -is bigger then 90%, then we rate the description of the two events as -different. If not, we apply the Levinsthein-Distance-Algorithm (LD), -which makes a fuzzy text comparison. We accept the description of the -events as equal, if LD returns a match of more then 90%. -Since LD is quite runtime intensive (O(mn)), you should not choose -'compare description' as the only comparison criterion, but combine -it always with other criterions.

2.3 How and when do we compare?

As already mentioned each search timer update checks search timers -with this feature for recordings in the past or an already existing -timer for the same event.

To remember past recordings epgsearch stores their info in the file -epgsearchdone.data. You can have a look at the contents of this file -calling 'show recordings done' in the 'actions' of the searches menu. -This file only stores info about recordings that are complete, -i.e. that started and stopped just in time. So a broken recording will -not be stored in this file and epgsearch will automatically try to -record the next repeat, if there is any.

How to use it?

As you see, the whole feature depends on the quality of the EPG. -After creating such a search timer, you should first check if it does -what is intended. Therefore the menu of search results has an -additional mode for the key 'blue' named 'Timer preview'. Here you can -see, what timers the next update would create. Existing timers are -labeled with 'T', future timers with 'P'.

Hint: If the programming results in a conflict simply disable the -conflicting timer in the timers menu. The next search timer update, -will try to program a different timer for the same event, if it exists.

When it works not correctly :-)

To get a better control of the programming or not-programming of the -timers when using this feature a log file was introduced. When starting -epgsearch with the command line option '-v n' where n is the log level -than you get additional info in the file epgsearch.log. Available log -levels are 0 (no logging) to 3 (extended logging). See also the manual -for the command line options.

3. Usage from other plugins or scripts

See epgsearch(4).

4. Using extended EPG info

Some EPG providers deliver additional EPG information like the type of -event, the video and audio format, cast,...

Using tvm2vdr or epg4vdr you can import this into vdr. -To use this information with search timers one has to configure it -with the file epgsearchcats.conf in epgsearchs config directory. The -format of the file is as follows:

- ID|category name|name in menu|values separated by ','(option)|search mode(option)

- - 'ID' should be a unique positive integer
-    (changing the id later on will force you to re-edit your search timers!)
- - 'category name' is the name as delivered by the EPG provider, e.g. 'Genre'
- - 'name in menu' is the name displayed in epgsearch.
- - 'values' is an optional list of possible values
- - 'search mode' specifies the search mode:
-   text comparison:
-   0 - the whole term must appear as substring
-   1 - all single terms (delimiters are ',', ';', '|' or '~') 
-       must exist as substrings. This is the default search mode.
-   2 - at least one term (delimiters are ',', ';', '|' or '~') 
-       must exist as substring.
-   3 - matches exactly
-   4 - regular expression
-   numerical comparison:
-   10 - less
-   11 - less or equal
-   12 - greater
-   13 - greater or equal
-   14 - equal
-   15 - not equal

Sample files for epgsearchcats.conf are delivered with the plugin in the -directory 'conf'.

Simply copy the one that fits for you to epgsearchs configurations directory -filename epgsearchcats.conf and then have a look to the search timers -edit menu (after a restart of VDR).

Since setting up a new epgsearchcats.conf is a lot of work, I've added -a small tool 'createcats', that makes the biggest part of the job. It -should have been compiled with the plugin and exists in the sources -directory.

See createcats(1) for information about how to use it.

Internals: epgsearch scans the summary of an event for the category -name followed by ': ' for all categories that have a corresponding -value set in the search timer. The search is case sensitive regarding -the category name as also the value.

5. Replacing the standard schedule menu

To use this plugin as a replacement for the default green key, simply -put the line

- Green   @epgsearch

in your keymacros.conf. If you don't like to get another plugin entry -in your main menu, first hide it by setup. Then you could use my -launcher-plugin and put the line

- Green @launcher x

in your keymacros.conf, where x is the position of the Epgsearch -plugin within launchers menu listing.

Attention: Hiding the plugin without using the launcher plugin or -other patches that enable calling hidden plugins will show the standard -schedules menu when you press the green key. This is not needed -anymore after VDR >= 1.3.32.

Another approach is using a patch to VDR that replaces vdr's standard -schedule menu with epgsearch (vdr-replace-schedulemenu.diff.gz in the -patches subdir, thanks to the author Uwe/egal@vdrportal). When using -this patch the entry should look like

- Gree Schedule

This patch is already included in some patch collections, like the -Bigpatch.

6. Add-ons

epgsearch delivers 2 'mini'-plugins. Both require an installed epgsearch (but -epgsearch can be hided in the main menu):

- epgsearchonly: - -: -
For those who only want to use the search feature and/or -search timers or simply want to have a separate main menu entry for the -search feature. This plugin creates a main menu entry 'Search' which calls -epgsearch search menu. -Activation in VDR start script with ``-Pepgsearchonly''.
-
- conflictcheckonly: - -: -
The timer conflict check can also have its own main menu -entry which displays epgsearch conflict overview menu. It has a setup option -to display an information about the last check directly in its main menu entry. -Activation in VDR start script with ``-Pconflictcheckonly''.
-

Have fun!

Christian Wieninger

Advanced description

See epgsearch(4) or read online

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

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

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

FILES

epgsearch.conf

Searchtimers. See epgsearch.conf(5).

epgsearchcats.conf

Categories, advanced epg. See epgsearchcats.conf(5).

epgsearchcmds.conf

EPG-commands, like the commands in commands.conf. See epgsearchcmds.conf(5).

epgsearchdirs.conf

Pre-defined patches which can be selected while editing an searchtimer. See epgsearchdirs.conf(5).

epgsearchmenu.conf

Configuration of the OSD menu layout. See epgsearchmenu.conf(5).

epgsearchuservars.conf

User defined variables. See epgsearchuservars.conf(5).

epgsearchdone.data

The done-data. See epgsearchdone.data(5).

epgsearchswitchtimers.conf

The switchtimers. See epgsearchswitchtimer.conf(5).

epgsearchblacklists.conf

The blacklist. See epgsearchblacklists.conf(5).

epgsearchchangrps.conf

The channelgroups. See epgsearchchangrps.conf(5).

epgsearchtemplates.conf

Templates for searchtimers. See epgsearchtemplates.conf(5).

AUTHOR (man pages)

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

REPORT BUGS

Bugreports (german):

http://www.vdr-developer.org/mantisbt/

Mailinglist:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearch.4.html b/html/en/epgsearch.4.html deleted file mode 100644 index d7ca287..0000000 --- a/html/en/epgsearch.4.html +++ /dev/null @@ -1,912 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
OVERVIEW
CONTENT
1. Using variables in the directory entry of a search timer
2. The format of epgsearch.conf
3. Description of the search process
4. How do Search Timers work?
5. How to trigger a search timer update?
6. The sources of the 'Select directory' menu
7. Language dependent commands for EPG
8. Usage from other plugins or scripts

8.1. File-based (intended for use in scripts)
8.2. via Plugin-Interface (intended for use in plugins)

9. SVDRP interface

search management:
channel group management:
blacklist management:
search template management:
extended EPG categories:
misc:
timer conflicts:

10. Customizing the EPG menus
11. Working with the timer conflict menu
12. User defined variables

Assignment
Control structures
Calling a system command
Possible variables
EXAMPLES

13. Email notification

Customizing the notifications mails

SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearch - Searchtimer and replacement of the VDR program menu

OVERVIEW

Since the README get bigger and bigger this man page shall be used -to explain some things in detail. So it's not really a manual, but an -extended README.

CONTENT

- 1.  Using variables in the directory entry of a search timer
- 2.  The format of epgsearch.conf
- 3.  Description of the search process
- 4.  How do Search Timers work?
- 5.  How to trigger a search timer update?
- 6.  The sources of the 'Select directory' menu
- 7.  Language dependent commands for EPG
- 8.  Usage from other plugins or scripts
- 9.  SVDRP interface
- 10. Customizing the EPG menus
- 11. Working with the timer conflict menu
- 12. User defined variables
- 13. Email notifications

1. Using variables in the directory entry of a search timer

If you are using extended EPG information, you can use variables as -part of a directory entry of a search timer. These variables always have -the form '%variable%'. The name of a variable corresponds with the -internal name of an extended EPG info, as specified in the file -epgsearchcats.conf (samples can be found in subdirectory 'conf'). -Example:

- 1|Category|Kategorie|Information,Kinder,Musik,Serie,Show,Spielfilm,Sport|3

The category with ID 1 has the internal name 'Category'. So you could -use it with '%Category%'. The names are not case sensitive. Sample -directory entries could look like this:

- My Movies~%Category%
- Childrens Movies~%category%
- %CATEGORY%~%genre%

There are also three other variables: %Title%, %Subtitle% and %Channel%. -If you don't use %Title%, the title is always automatically -appended to the directory entry, when a timer will be created. If you -set 'serial recording' to 'yes' in your search timer then also the -subtitle will be automatically appended. So the directory entry

- %Category%~%Genre%~%Title%~%Subtitle%

is the same as

- %Category%~%Genre%
- (with 'serial recording' set to 'yes').

The %Channel% variable gets replaced with the name of the channel.

Attention: Automatically appending title and subtitle will not be -done, if you use the variables %Title% or %Subtitle% in the directory -entry. This allows to form directory entries like this one:

- %Category%~%Genre%~%Title%~%Episode%~%Subtitle%

There is also another variable %search.query% that will be replaced with the -query of the search timer.

2. The format of epgsearch.conf

Due to some new features there was a change in the format. The format -is now signed with a comment in the first line. The field delimiter -is ':':

-  1 - unique search timer id
-  2 - the search term
-  3 - use time? 0/1
-  4 - start time in HHMM 
-  5 - stop time in HHMM 
-  6 - use channel? 0 = no,  1 = Interval, 2 = Channel group, 3 = FTA only
-  7 - if 'use channel' = 1 then channel id[|channel id] in vdr format,
-      one entry or min/max entry separated with |, if 'use channel' = 2
-      then the channel group name     
-  8 - match case? 0/1 
-  9 - search mode:
-       0 - the whole term must appear as substring
-       1 - all single terms (delimiters are blank,',', ';', '|' or '~') 
-          must exist as substrings.
-       2 - at least one term (delimiters are blank, ',', ';', '|' or '~') 
-           must exist as substring.
-       3 - matches exactly
-       4 - regular expression
-       5 - fuzzy searching (specify tolerance in parameter 42, not available
-           for EPG categories)
- 10 - use title? 0/1
- 11 - use subtitle? 0/1
- 12 - use description? 0/1
- 13 - use duration? 0/1
- 14 - min duration in minutes
- 15 - max duration in minutes
- 16 - use as search timer? 0/1/2 (with 2 one can specify time margins in 
-      parameter 48/49 where the search timer is active)
- 17 - use day of week? 0/1
- 18 - day of week (0 = Sunday, 1 = Monday...;      
-      -1 Sunday, -2 Monday, -4 Tuesday, ...; -7 Sun, Mon, Tue)
- 19 - use series recording? 0/1
- 20 - directory for recording
- 21 - priority of recording
- 22 - lifetime of recording
- 23 - time margin for start in minutes
- 24 - time margin for stop in minutes
- 25 - use VPS? 0/1
- 26 - action:
-       0 = create a timer
-       1 = announce only via OSD (no timer)
-       2 = switch only (no timer)
- 27 - use extended EPG info? 0/1
- 28 - extended EPG info values. This entry has the following format
-      (delimiter is '|' for each category, '#' separates id and value):
-      1 - the id of the extended EPG info category as specified in
-          epgsearchcats.conf
-      2 - the value of the extended EPG info category
-          (a ':' will be translated to "!^colon^!", e.g. in "16:9")
- 29 - avoid repeats? 0/1
- 30 - allowed repeats
- 31 - compare title when testing for a repeat? 0/1     
- 32 - compare subtitle when testing for a repeat? 0/1     
- 33 - compare description when testing for a repeat? 0/1     
- 34 - compare extended EPG info when testing for a repeat?
-      This entry is a bit field of the category IDs.
- 35 - accepts repeats only within x days
- 36 - delete a recording automatically after x days
- 37 - but keep this number of recordings anyway
- 38 - minutes before switch (if action = 2)
- 39 - pause if x recordings already exist
- 40 - blacklist usage mode (0 none, 1 selection, 2 all)
- 41 - selected blacklist IDs separated with '|'
- 42 - fuzzy tolerance value for fuzzy searching
- 43 - use this search in favorites menu (0 no, 1 yes)
- 44 - number of the search menu template to use (only available if multiple
-      search result templates are defined in epgsearchmenu.conf)
- 45 - auto deletion mode (0 don't delete search timer, 1 delete after given
-      count of recordings, 2 delete after given days after first recording)
- 46 - count of recordings after which to delete the search timer
- 47 - count of days after the first recording after which to delete the search
-      timer
- 48 - first day where the search timer is active (see parameter 16)
- 49 - last day where the search timer is active (see parameter 16)
- 50 - ignore missing EPG categories? 0/1
- 51 - unmute sound if off when used as switch timer

A ':' in the search term or the directory entry will be translated in -a '|'. If a '|' exists in the search term, e.g. when using regular -expressions, it will be translated to ``!^pipe^!'' (I know it's ugly ;-))

3. Description of the search process

First, for each broadcasting a search text divided by '~' is created, -depending on the settings of 'Use title', 'Use subtitle' and 'Use -description':

- title~subtitle~description

If ``Match case'' is not set, the search text and the search term are -transformed to lower case. -Now depending on the search mode, the search term will be looked up in -the search text:

- 'Phrase' matches - -: -
if the search term is found anywhere in the search text.
-
- 'at least one word', 'all words' - -: -
first the search term will be split in single words. Delimiters are a -blank and the characters ',' ';' '|' '~'.
-; -
Then we check if at least one or all words appear in the search text.
-
- 'match exactly' - -: -
matches if search term and search text are identical.
-
- 'regular expression' - -: -
the search is done with a regular expression. You don't need a leading -and trailing '/' in your search term. -Two standards of regular expression are supported: extended -POSIX and Perl compatible regular expressions (PCRE) (see INSTALL).
-

If the search was successful until now, the other criterions (start -time, duration, week day) are checked.

4. How do Search Timers work?

With each update, the plugin searches for new matches of your search -timers. If a new match is found then a new timer is created. For -serial recordings, the subtitle is appended to the recording -directory. Many providers deliver the subtitle just 1-2 days before -the event. The plugin uses then a date/time string for the subtitle, -but replaces this one later if the subtitle is present.

Start and end times of a broadcasting often vary a little bit. To avoid -getting many different timers for the same event, the plugin -checks before adding a new timer, if there is one, that has start and -end times which only differ by a maximum of 10 minutes (or the events -duration if this is less then 10 minutes). If so, the present timer is -modified, else a new timer is created. If the timer was set to inactive -there will be no update. Also manually corrected priority or lifetime -will not be changed when updating.

If you have set 'Announce only (no timer)' to yes, no timer is -created. Instead you get an OSD message about the event. This message -is displayed at each scan, but only if there is no timer for the event.

5. How to trigger a search timer update?

the update of search timers runs in its own thread. There are several -ways to trigger it:

- automatically - -

after VDR starts there is always an update (after a -few seconds). After this, the setup option 'Update interval' tells -epgsearch when the next update should be done repeatedly (in minutes).

- manually extern - -

the thread observes the file '.epgsearchupdate' in the -plugins config directory. When you

- touch /path_to_file/.epgsearchupdate

this will also trigger an update. So this is a simple solution to -make an update e.g. by a script.

- manually intern - -

calling actions or pressing '3' in the menu of searches asks also -for an update.

- from other plugins - -

there's a service -'Epgsearch-updatesearchtimers-v1.0' that can be used with the service -interface of VDR from other plugins with the option to inform via -OSD when the update has finished

6. The sources of the 'Select directory' menu

This menu displays directories, that can be used for search timers or -ordinary timers. The items displayed are read from the following -sources:

-   * current recording directories
-   * current timer directories
-   * directories used in search timers
-   * directories specified in F<epgsearchdirs.conf>,
-     see C<epgsearchdirs.con(5)>

The menu merges theses directories and displays only distinct -directories. With key 'yellow' one can change the depth of the -directories shown. If there are items, that contain category variables -like '%genre%', these entries are always shown before any other -directories. They are also not level dependent, but are always shown -with their full directory.

If this menu is called from the timer edit menu and an item is -selected that contains the variables ``%title%'' or ``%subtitle'' then the -'file' item of the timer gets cleared, since title or subtitle already -exist in the 'directory' item. -This list can also be accessed via the SVDRP command 'LSRD'.

7. Language dependent commands for EPG

If you like to have a language dependent list of commands simply -translate your present epgsearchcmds.conf to your preferred OSD -language and store it with the filename epgsearchcmds-XXX.conf, where -XXX is the language code from i18n.c:

-  { "eng,dos",
-    "deu,ger",
-    "slv",
-    "ita",
-    "dut,nla,nld",
-    "por",
-    "fra,fre",
-    "nor",
-    "fin,smi",
-    "pol",
-    "esl,spa",
-    "ell,gre",
-    "sve,swe",
-    "rom,rum",
-    "hun",
-    "cat,cln",
-    "rus",
-    "hrv",
-    "est",
-    "dan",
-  }

If there are more codes for one language (e.g. ``deu,ger'') choose -one of them. If there is no language dependent file, epgsearch loads -the file epgsearchcmds.conf.

8. Usage from other plugins or scripts

Searching the EPG and other functionality can be used by other plugins -or scripts. There are two approaches:

8.1. File-based (intended for use in scripts)

Therefore simply create the file '.epgsearchrc' in the plugins config -directory with the following lines in it:

- Search=your search term
- Searchmode=x  // 0=phrase, 1=and, 2=or, 3=regular expression
- ChannelNr=x   // add this line, to search on a specific channel
- UseTitle=x    // 1(default) or 0
- UseSubtitle=x // 1(default) or 0
- UseDescr=x    // 1(default) or 0

Then call Epgsearch via svdrpsend.pl (you must have assigned a key -to it), e.g.

- svdrpsend.pl HITK green

At startup Epgsearch will look for this file and give you the -search results for your search, if it exists. After that the file is -removed.

A sample script recrep.sh, that searches for the repeats of a recording -exists in the scripts subdirectory of Epgsearch.

8.2. via Plugin-Interface (intended for use in plugins)

A plugin can directly call two functions of epgsearch with only some -lines of source code:

- - searching the EPG for some criteria and display the result list
- - extended timer edit menu

I have added a quick and dirty dummy plugin -(source/vdr-epgsearchclient-0.0.1.tgz), that demonstrates the usage.

9. SVDRP interface

epgsearch implements a SVDRP interface, that can be accessed for -example like this

- svdrpsend.pl PLUG epgsearch LSTS

the following commands are available:

search management:

- * 'LSTS [ID]' to list all searches, or the one with the passed ID
-   (format is the same as epgsearch.conf)
- * 'NEWS <settings>' to add a new search
-   REMARK: the value of element ID is ignored. epgsearch will always
-   assign the next free ID
- * 'DELS <ID>' to delete the search with ID
- * 'EDIS <settings>' to modify an existing search
- * 'UPDS [OSD]' to update the search timers. Passing the optional keyword
-   'OSD' pops up an OSD message after the update has finished.
- * 'MODS ID ON|OFF' turns on/off the option 'Use as search timer'.
- * 'UPDD' to reload the file epgsearchdone.data, e.g. after an
-   external tool has modified it.
- * 'SETS <ON|OFF>' to temporarily activate or cancel the search timer background
-   thread. 
- * 'FIND <settings>' for searching the EPG
-   input is the same as with 'NEWS'. output is a list of found events formatted
-   as 'NEWT' lines. So they can be immediately used to create a new timer for
-   an event.
- * 'QRYS < ID(s) >' to get the results for a search with the given
-   ID. Multiple IDs can also be passed and have to be separated with '|'. 
-   The results are formatted like this:

-   search ID    : // the ID of the corresponding search timer
-   event ID     : // VDR event ID
-   title        : // event title, any ':' will be converted to '|'
-   episode name : // event short text, any ':' will be converted to '|'
-   event start  : // event start in seconds since 1970-01-01
-   event stop   : // event stop in seconds since 1970-01-01
-   channel      : // channel ID in VDR's internal representation (e.g. 'S19.2E-1-1101-28106')
-   timer start  : // timer start in seconds since 1970-01-01 (only valid if timer flag is > 0)
-   timer stop   : // timer stop in seconds since 1970-01-01 (only valid if timer flag is > 0)
-   timer file   : // timer file (only valid if timer flag is > 0)
-   timer flag   : // 0 = no timer needed, 1 = has timer, 2 timer planned for next update)
- * 'QRYS <settings>' to get the results for a search with the given search
-   settings. 
- * 'QRYF [hours]' to get the results for the favorites menu, see QRYS for
-   result format. The optional parameter specifies the number of hours to
-   evaluate and defaults to 24h.

channel group management:

- * 'LSTC [channel group name]'
-   list all channel groups or if given the one with name 'group name'
- * 'NEWC <channel group settings>'
-   create a new channel group, format as in epgsearchchangrps.conf
- * 'EDIC <channel group settings>'
-   modify an existing channel group, format as in epgsearchchangrps.conf
- * 'DELC <channel group name>'
-   delete an existing channel group
- * 'RENC <old channel group name|new channel group name>'
-   rename an existing channel group

blacklist management:

- * 'LSTB [ID]' to list all blacklists, or the one with the passed ID
-   (format is the same as epgsearchblacklists.conf)
- * 'NEWB <settings>' to add a new blacklist
-   REMARK: the value of element ID is ignored. epgsearch will always
-   assign the next free ID
- * 'DELB <ID>' to delete the blacklist with ID
- * 'EDIB <settings>' to modify an existing blacklist

search template management:

- * 'LSTT [ID]' to list all search templates, or the one with the passed ID
-   (format is the same as epgsearch.conf)
- * 'NEWT <settings>' to add a new search template
-   REMARK: the value of element ID is ignored. epgsearch will always
-   assign the next free ID
- * 'DELT <ID>' to delete the search template with ID
- * 'EDIT <settings>' to modify an existing search template
- * 'DEFT [ID]' returns the ID of the default search template. When passing an
-   ID it activates the corresponding template as default.

extended EPG categories:

- * 'LSTE [ID] to get the extended EPG categories defined in epgsearchcats.conf
-   or the one with the given ID. (format is the same as epgsearchcats.conf)

misc:

- * 'SETP [option]' returns the current value of the given setup option or a
-   list of all options with their current values.
-   The following options can be accessed:
-    - ShowFavoritesMenu
-    - UseSearchTimers

timer conflicts:

- * 'LSCC [REL]' returns the current timer conflicts. With the option 'REL' only
-   relevant conflicts are listed. The result list looks like this for example 
-   when we have 2 timer conflicts at one time:

-   1190232780:152|30|50#152#45:45|10|50#152#45

-   '1190232780' is the time of the conflict in seconds since 1970-01-01. It's 
-   followed by list of timers that have a conflict at this time:

-   '152|30|50#152#45' is the description of the first conflicting timer. Here:

-   '152' is VDR's timer id of this timer as returned from VDR's LSTT command
-   '30' is the percentage of recording that would be done (0...100)
-   '50#152#45' is the list of concurrent timers at this conflict

-   '45|10|50#152#45' describes the next conflict

10. Customizing the EPG menus

The file epgsearchmenu.conf in your plugins config directory is used to store -the entries for customizing the EPG menus. You specify the look of each menu -(What's on now, What's on next, What's on at ..., Schedule, Search results, -Favorites) with a separate line. Here's a sample:

- MenuWhatsOnNow=%chnr%:3|%progrt2s%:5| %time% %t_status%:8|%category%:6| %title% ~ %subtitle%:35
- MenuWhatsOnNext=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
- MenuWhatsOnElse=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
- MenuSchedule=%time% %t_status%:8|%genre%:14| %title% ~ %subtitle%:35
- MenuSearchResults=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon% %subtitle%:35
- MenuFavorites=%chnr%:3|%time%:6|%timespan%:7|%t_status%:14|%genre%:8| %title%%colon%%subtitle%:35

E.g. the entry 'MenuWhatsOnNow' tells epgsearch how you would like to build a -line for the menu 'What's on now'. This would create a menu line starting with -the channel number, followed by a progress bar in text2skin style, a space of -one char, the start time, the timer status, the EPG category (like ``movie'') -and finally the title and subtitle.

The values for MenuWhatsOnNext, MenuWhatsOnElse, MenuSchedule, -MenuSearchResults, MenuFavorites specify the menu 'What's on next', 'What's on -at ...', 'Schedule', 'Search results' and 'Favorites' respectively. If you do -not specify one entry, epgsearch uses it's default menu look.

'MenuSearchResults' has something special: If you want to have different -layouts for your search results depending on the search, you can use more then -one menu template. Simply define e.g. an additional

- MenuSearchResultsTip of the Day=%chnr%:3|%time_w%:4|%t_status%:3|%genre%:10|%title%%colon% %subtitle%:35

This will produce an additional menu item ``Result menu layout'' in the edit -menu of a search where you can choose between the default menu template and your -own templates. In the example above you will get ``Tip of the Day'' as selection -entry, since epgsearch simply cuts the leading ``MenuSearchResults''. When you -display the search results the chosen template will be used instead of the -default one.

The following variables exist:

- %time%           - start time in format HH:MM
- %timeend%        - end time in format HH:MM
- %date%           - start date in format TT.MM.YY
- %datesh%         - start date in format TT.MM.
- %time_w%         - weekday name
- %time_d%         - start day in format TT
- %time_lng%       - start time in seconds since 1970-01-01 00:00
- %timespan%       - timespan from now to the beginning of an event, e.g. 'in 15m'
-                    or the time an event is already running, e.g. '10m'. 
- %length%         - length in seconds
- %title%          - title
- %subtitle%       - subtitle
- %summary%        - summary
- %htmlsummary%    - summary, where all CR are replaced with '<br />'
- %eventid%        - numeric event ID
- %t_status%       - timer status ('T', 't', 'R')
- %v_status%       - VPS status
- %r_status%       - running status
- %status%         - complete status, the same as
-                    '%t_status%%v_status%%r_status%'

- %<epg-category>% - a value from the extended EPG categories, specified in
-                    epgsearchcats.conf, like %genre% or %category%

for the 'Whats on...' and 'Search results' menu there are also:

- %chnr%           - channel number
- %chsh%           - the short channel name (>=vdr-1.3.15)
- %chlng%          - the 'normal' channel name
- %chdata%         - VDR's internal channel representation (e.g. 'S19.2E-1-1101-28106')
- %progr%          - graphical progress bar (not for menu 'Search results')
- %progrT2S%       - progress bar in text2skin style (not for menu 'Search results')

some indepent variables:

- %colon%          - the sign ':'
- %datenow%        - current date in format TT.MM.YY
- %dateshnow%      - current date in format TT.MM.
- %timenow%        - current time in format HH:MM
- %videodir%       - VDR video directory (e.g. /video)
- %plugconfdir%    - VDR plugin config directory (e.g. /etc/vdr/plugins)
- %epgsearchdir%   - epgsearchs config directory (e.g. /etc/vdr/plugins/epgsearch)

The variables are not case sensitive. You can also use variables for extended -EPG categories defined in epgsearchcats.conf or use your own user defined -variables defined in epgsearchuservars.conf

An entry consists of up to 6 tables separated with '|'. The last entry of -each table should declare the table width in chars, separated with ':'.

If you use a separator like '~', '-' or '#' to separate items like title or -subtitle, e.g. %title% ~ %subtitle%, and the subtitle is empty, then epgsearch -will try to fix this automatically to avoid a trailing separator.

You should vary the tab width values to fit your needs, since the look often -depends on the selected skin. epgsearchmenu.conf is not reloaded with every -plugin call, since this is only useful when testing the conf file. To activate -the permanent reload for testing your conf, pass the new start parameter '-r' -or '--reloadmenuconf' in your runvdr.

There's a sample epgsearchmenu.conf in the subdirectory ``conf''. For a quick try -copy it to your plugins config directory (e.g. /etc/vdr/plugins).

To enable icons from WarEagleIcon-Patch simply put the line

- WarEagleIcons=1

to epgsearchmenu.conf.

NOTE: As long as there is a file epgsearchmenu.conf with an entry for a special -menu, all setup settings regarding the look of this menu are ignored.

11. Working with the timer conflict menu

If a conflict is detected within the periodic conflict background check you get -an OSD message which informs you about it. Pressing 'Ok' you will get a menu -that displays all relevant conflicts. You can manually call this menu in -epgsearch in the menu 'Search/Actions'.

Besides the relevant conflicts (relevance is controlled via the setup options -of epgsearch) there may also be conflicts which are not classified as -important. If so, you can press 'Show all' to get the complete list. The menu -title always displays the number of relevant conflicts and the total number.

The list displays first the time when a conflict appears and then all timers -that will fail here. A timer entry consists of the channel number and its name -followed by the timer priority and the percentage value that shows how much of -the timer will be recorded. Finally the timer's file entry is displayed.

When you select a timer entry and press 'Ok' or 'Details' you get a new menu -which displays all concurrent timers. This menu allows you to resolve the -conflict by

- - searching a repeat for an event
- - disabling a timer
- - deleting a timer
- - changing the timers start- or stop-time or its priority
- - executing any other commands on this timer

An entry of this menu consists of the sign '>' to indicate an active timer, -the channel number, the start and stop time, the priority, the number of the -device that will do the recording (or 'C' for conflict) and the timer's file -entry. Pressing 'Ok' on a timer entry will show you its event description if -present.

If one returns from this menu to the conflict overview menu there will be an -automatic update to see if a conflict was really resolved. Some changes to a -timer (like modifying start/stop or deleting a timer) in the conflict details -menu also cause an immediate return to the overview menu and produce an -update.

12. User defined variables

You can create your own variables to be used in any place that supports -variables, like the default recording directory for manually created timers, -the recording directory of a search timer or in your customized EPG menus. -Put them in the file epgsearchuservars.conf.

Variables looks like %Variablename%.

``Variablename'' can be consist of any alphanumerical character. Space -and special characters are not allowed.

The variable names are case-insensitive.

Examples for possible names:

- %Series% %DocuVar1% %ThemesSubtitleDate1%

Assignment

- %Series%=New series~Thriller

The variable %Series% will be assigned with the string ``New series~Thriller''.

Assignments are always strings. Spaces stay spaces.

- %Path%=%Series%

The variable %Path% gets the content of the variable %Series%.

You can do nearly everything:

- %Path%=%Serie%~Lost

The variable %Path% contains now the string ``New series~Thriller~Lost''.

Control structures

You can use simple ``if then else'' constructions.

These constructions cannot contain strings, only variables. -Spaces are ignored.

- %Foo%=Other

- %Variable%=%Path% ? %Path% : %Foo%

If %Path% is not empty, assign the content of %Path% to %Variable%, -otherwise the content of %Foo%.

``%Path% ?'' means ``not empty?''. You can use other checks.

- %Variable%=%Path%!=5 ? %Path% : %Foo%

``%Path%!=5 ?'' means ``is %Path% equal 5?''

You can also compare variables.

- %Five%=5

- %Variable%=%Path%!=%Five% ? %Path% : %Foo%

Other possible checks:

- ==   equal
- !=   not equal

Calling a system command

You can call external commands. The returned string will be assigned -to a variable

- %uservar%=system(scriptname[, parameters])

Calls the script ``scriptname'' with the parameters defined in the optional list -of 'parameters'. This can be an arbitrary expression containing other user -variables, but not again a system call or a conditional expression.

Sample:

- %myVar%=system(/usr/local/bin/myscript.sh, -t %title% -s %subtitle% -u %myOtherVar%) 
- 
-The script must return a string B<without> line break!

If the script returns nothing, an empty string will be assigned to the -Variable %Result%.

Possible variables

for a list of already builtin variables refer to the section ``Customizing the EPG menus'' -Furthermore you can use every variable defined in epgsearchcats.conf.

See epgsearchcats.conf(5).

EXAMPLES

- # Weekday, Date, Time   
- %DateStr%=%time_w% %date% %time%

- # Themes or Subtitle or Date
- %ThemesSubtitleDate1%=%Subtitle% ? %Subtitle% : %DateStr%
- %ThemesSubtitleDate%=%Themes% ? %Themes% : %ThemesSubtitleDate1%

- # Calls this script to get a recording path
- %DocuScript%=system(doku.pl, -t %Title% -s %Subtitle% -e %Episode% -th %Themes% -c %Category% -g %Genre%)
- %Docu%=%DocuScript%

13. Email notification

If you want to get email notifications about timers added/modified/removed by -the search timer thread or about timer conflicts, first copy the script -'sendEmail.pl' to the place where your executables are (e.g. /usr/local/bin) -and then configure your email account in the setup. Press 'Test' to check if -it works. There should be something like 'Email successfully sent' at the end -of the output. -The content of the mails is defined by the files

-  - epgsearchupdmail.templ (for search timer update notifications)
-  - epgsearchconflmail.templ (for timer conflict notifications)

You can find sample files in the 'conf' directory. Copy them to epgsearchs -config directory (e.g. /etc/vdr/plugins/epgsearch).

Customizing the notifications mails

The content of the mails can be customized in many ways. You can use plain -text or HTML (see the sample conf/epgsearchupdmail-html.templ). For an update -mail you have to define the following sections:

-  - "subject" to be used as mail subject
-  - "mailbody" the body of the mail:
-    put '%update.newtimers%' in the place where the list of new timers should
-    appear. The same for %update.modtimers% and %update.deltimers% for the
-    list of changed or deleted timers.
-  - "timer" the description of one timer. This section is used to display one
-    timer within a timer list, e.g. in %update.newtimers%

each section is enclosed in a pseudo XML tag.

The following variables can be used in the section <mailbody>:

-  - %update.newtimers%      - will be replaced with the list of new timers
-                              created with this update. The timers are
-                              displayed as defined in the section '<timer>'
-  - %update.countnewtimers% - the number of new timers
-  - %update.modtimers%      - same as %update.newtimers% but for modified
-                              timers. 
-  - %update.countmodtimers% - the number of modified timers
-  - %update.deltimers%      - same as %update.newtimers% but for deleted
-                              timers. (Note: a deleted timer has eventually
-                              no event assigned to it. So all event variables
-                              within the timer section will be substituted to
-                              an empty string.)
-  - %update.countdeltimers% - the number of deleted timers
-  - %colon%                 - the sign ':'
-  - %datenow%               - current date in format TT.MM.YY
-  - %dateshnow%             - current date in format TT.MM.
-  - %timenow%               - current time in format HH:MM

The following variables can be used in the section <timer>:

-  - %timer.date%            - date of the timer
-  - %timer.start%           - start time of the timer
-  - %timer.stop%            - stop time of the timer
-  - %timer.file%            - recording directory of the timer
-  - %timer.chnr%            - channel number 
-  - %timer.chsh%            - short channel name
-  - %timer.chlng%           - channel name
-  - %timer.search%          - name of the search timer, that created the timer
-  - %timer.searchid%        - id of the search timer, that created the timer
-  - any event variable (as in '10. Customizing the EPG menus')
-  - any extended EPG variable as defined in epgsearchcats.conf
-  - any user variable (as in '12. User defined variables')

For a conflict notification mail the following sections exist:

-  - "subject" to be used as mail subject
-  - "mailbody" the body of the mail. Put %conflict.conflicts% in the place
-    where the list of conflict times should appear (Note: there can be more
-    than one timer conflict at the same time!). A conflict time uses the
-    section 'conflictsat' to display its content.
-  - "conflictsat" the description of one time where one or more conflicts
-    exists. Put %conflict.confltimers% in the place where the list of conflict
-    timers should appear.
-  - "confltimer" the description of one conflicting timer

The following variables can be used in the section <mailbody>:

-  - %conflict.count%        - complete number of timer conflicts
-  - %conflict.conflicts%    - list of times with conflicting timers

The following variables can be used in the section <conflictsat>:

-  - %conflict.date%         - date of the conflict
-  - %conflict.time%         - time of the conflict
-  - %conflict.confltimers%  - list of conflicting timers for this time

The section <conflicttimer> can use the same variables as the section <timer> -in an update mail (see above).

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearch.conf.5.html b/html/en/epgsearch.conf.5.html deleted file mode 100644 index e050df8..0000000 --- a/html/en/epgsearch.conf.5.html +++ /dev/null @@ -1,172 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
SYNTAX
EXAMPLE
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearch.conf - The searchtimers

DESCRIPTION

This file contains the searchtimers.

Do not edit it manually, you should use SVDRP.

SYNTAX

Due to some new features there was a change in the format. The format -is now signed with a comment in the first line. The field delimiter -is ':':

-  1 - unique search timer id
-  2 - the search term
-  3 - use time? 0/1
-  4 - start time in HHMM
-  5 - stop time in HHMM
-  6 - use channel? 0 = no,  1 = Interval, 2 = Channel group, 3 = FTA only
-  7 - if 'use channel' = 1 then channel id[|channel id] in VDR format, 
-      one entry or min/max entry separated with |, if 'use channel' = 2
-      then the channel group name
-  8 - match case? 0/1
-  9 - search mode:
-      0 - the whole term must appear as substring
-      1 - all single terms (delimiters are blank,',', ';', '|' or '~')
-          must exist as substrings.
-      2 - at least one term (delimiters are blank, ',', ';', '|' or '~')
-          must exist as substring.
-      3 - matches exactly   
-      4 - regular expression
- 10 - use title? 0/1      
- 11 - use subtitle? 0/1   
- 12 - use description? 0/1
- 13 - use duration? 0/1
- 14 - min duration in minutes 
- 15 - max duration in minutes 
- 16 - use as search timer? 0/1
- 17 - use day of week? 0/1
- 18 - day of week (0 = Sunday, 1 = Monday...; 
-      -1 Sunday, -2 Monday, -4 Tuesday, ...; -7 Sun, Mon, Tue)
- 19 - use series recording? 0/1
- 20 - directory for recording
- 21 - priority of recording
- 22 - lifetime of recording
- 23 - time margin for start in minutes
- 24 - time margin for stop in minutes
- 25 - use VPS? 0/1
- 26 - action:
-      0 = create a timer
-      1 = announce only via OSD (no timer)
-      2 = switch only (no timer)
- 27 - use extended EPG info? 0/1
- 28 - extended EPG info values. This entry has the following format
-      (delimiter is '|' for each category, '#' separates id and value):
-      1 - the id of the extended EPG info category as specified in
-          epgsearchcats.conf
-      2 - the value of the extended EPG info category
-          (a ':' will be translated to "!^colon^!", e.g. in "16:9")
- 29 - avoid repeats? 0/1
- 30 - allowed repeats
- 31 - compare title when testing for a repeat? 0/1        
- 32 - compare subtitle when testing for a repeat? 0/1     
- 33 - compare description when testing for a repeat? 0/1  
- 34 - compare extended EPG info when testing for a repeat?
-      This entry is a bit field of the category IDs.
- 35 - accepts repeats only within x days
- 36 - delete a recording automatically after x days
- 37 - but keep this number of recordings anyway
- 38 - minutes before switch (if action = 2)
- 39 - pause if x recordings already exist
- 40 - blacklist usage mode (0 none, 1 selection, 2 all)
- 41 - selected blacklist IDs separated with '|'
- 42 - fuzzy tolerance value for fuzzy searching
- 43 - use this search in favorites menu (0 no, 1 yes)
- 44 - id of a menu search template
- 45 - auto deletion mode (0 don't delete search timer, 1 delete after given
-      count of recordings, 2 delete after given days after first recording)
- 46 - count of recordings after which to delete the search timer
- 47 - count of days after the first recording after which to delete the search
-      timer
- 48 - first day where the search timer is active (see parameter 16)
- 49 - last day where the search timer is active (see parameter 16)
- 50 - ignore missing EPG categories? 0/1
- 51 - unmute sound if off when used as switch timer

A ':' in the search term or the directory entry will be translated in a -'|'. If a '|' exists in the search term, e.g. when using regular -expressions, it will be translated to ``!^pipe^!'' (I know it's ugly ;-))

There's no need to fill all fields, only the first 11 fields must exist.

EXAMPLE

- #version 2 - DON'T TOUCH THIS!
- 1:Kommissar Beck:0:::2:�ffRecht:0:0:1:0:0:0:::1:0:0:1:%Category%~%Genre%:50:99:10:60:0:0:0::1:0:1:1:0:0:0:0:0
- 2:* S�gebrecht:0:::2:Hauptsender:0:0:0:0:0:0:::0:0:0:0:%Category%~%Genre%:50:99:10:10:0:0:1:1#|2#|3#|4#|5#|6#Marianne S�gebrecht|7#|8#|9#|10#|11#|12#|13#:1:0:1:0:0:0:0:0:0

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchblacklists.conf.5.html b/html/en/epgsearchblacklists.conf.5.html deleted file mode 100644 index 9ac10fa..0000000 --- a/html/en/epgsearchblacklists.conf.5.html +++ /dev/null @@ -1,100 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION

USAGE

SYNTAX
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchblacklists.conf - Blacklist

DESCRIPTION

You can create blacklists in epgsearch and use them in searchtimers.

A blacklist entry is like a normal searchtimer which is saved in the file -epgsearchblacklists.conf.

While editing an searchtimer you can select one ore more blacklist entries.

USAGE

Searchtimer ``Action'' use blacklist ``Damme''.

Blacklist entry ``Damme'' searches ``Damme''

First the searchtimer searches all films with ``Action''.

Then for each search result epgsearch will test if the result matches -against ``Damme''. If so, the result will be dismissed.

SYNTAX

This file uses the same syntax as epgsearch.conf except that theres no <use as searchtimer> field. -So there's a shift by one field from this position. Because that, see epgsearch.conf(5).

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchcats.conf.5.html b/html/en/epgsearchcats.conf.5.html deleted file mode 100644 index 28c47d1..0000000 --- a/html/en/epgsearchcats.conf.5.html +++ /dev/null @@ -1,157 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
SYNTAX
EXAMPLE
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchcats.conf - Configuration of the additional EPG information

DESCRIPTION

Some EPG providers deliver additional EPG information like the type of -event, the video and audio format, cast,...

Using tvm2vdr or epg4vdr you can import this into vdr. To use this -information with search timers one has to configure it with the file -epgsearchcats.conf in your plugins config directory.

Sample files for epgsearchcats.conf are delivered with the plugin in -the directory 'conf'.

Simply copy the one that fits for you to your plugins config directory with -filename epgsearchcats.conf and then have a look to the search timers -edit menu (after a restart of VDR).

Since setting up a new epgsearchcats.conf is a lot of work, I've added -a small tool 'createcats', that makes the biggest part of the job. It -should have been compiled with the plugin and exists in the sources -directory.

See createcats(1) for information about how to use it.

Internals: epgsearch scans the summary of an event for the category -name followed by ': ' for all categories that have a corresponding -value set in the search timer. The search is case sensitive regarding -the category name as also the value.

SYNTAX

- ID|category name|name in menu|values separated by ','(option)|searchmode(option)

- - 'ID' should be a unique positive integer
-   (changing the id later on will force you to re-edit your search timers!)
- - 'category name' is the name as delivered by the EPG provider, e.g. 'Genre'
- - 'name in menu' is the name displayed in epgsearch.
- - 'values' is an optional list of possible values   
- - 'searchmode' specifies the search mode:
-   text comparison:
-    0  - the whole term must appear as substring
-    1  - all single terms (delimiters are ',', ';', '|' or '~')
-         must exist as substrings. This is the default search mode.
-    2  - at least one term (delimiters are ',', ';', '|' or '~')   
-         must exist as substring.
-    3  - matches exactly
-    4  - regular expression
-   numerical comparison:
-    10 - less
-    11 - less or equal
-    12 - greater
-    13 - greater or equal
-    14 - equal
-    15 - not equal

EXAMPLE

(Lines are shortened for correct displaying)

Example for EPG from H�rzu, downloaded from epgdata.com with tvmovie2vdr.

- 1|Category|Kategorie|Information,Kinder,Musik,Serie,Show,Spielfilm,Sport|2

- 2|Genre|Genre|Abenteuer,Action,Wirtschaft,Wissen,Zeichentrick|2

- 3|Format|Video-Format|16:9,4:3|2

- 4|Audio|Audio|Dolby Surround,Dolby,Hoerfilm,Stereo|2

- 5|Year|Jahr||2

- 6|Cast|Besetzung||2

- 7|Director|Regisseur||2

- 8|Moderator|Moderation||2

- 9|Rating|Bewertung|Gro�artig besonders wertvoll,Annehmbar,Schwach|2

- 10|FSK|FSK|6,12,16,18|2

- 11|Country|Land||2

- 12|Episode|Episode||4

- 13|Themes|Thema||4

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchchangrps.conf.5.html b/html/en/epgsearchchangrps.conf.5.html deleted file mode 100644 index 3d06ea7..0000000 --- a/html/en/epgsearchchangrps.conf.5.html +++ /dev/null @@ -1,95 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
SYNTAX
EXAMPLE
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchchangrps.conf - Channel groups

DESCRIPTION

You can define channel groups in epgsearch which can be used in searchtimers.

In this file the groups will be saved.

SYNTAX

Each line contains one channel group. The line begins with the group name, after the name, -split by '|', the list of channels.

EXAMPLE

(Lines are shortened for clean displaying)

- Private|S19.2E-133-33-46|S19.2E-133-33-51
- ProsiebenSat.1|S19.2E-133-33-46|S19.2E-133-33-47
- RTL World|S19.2E-1-1089-12003||S19.2E-1-1089-12090

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchcmds.conf.5.html b/html/en/epgsearchcmds.conf.5.html deleted file mode 100644 index 240d7fb..0000000 --- a/html/en/epgsearchcmds.conf.5.html +++ /dev/null @@ -1,105 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION

Language

SYNTAX
EXAMPLE
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchcmds.conf - EPG Commands

DESCRIPTION

This file contains, like the file commands.conf or reccmds.conf, commands, which -can be applied to the in the program menu selected event.

Internal epgsearch has 8 not changeable commands.

If there is a epgsearchcmds.conf, the commands in it will be appended to -the list of the internal commands, starting with 9.

Language

You can use different files for each language. For example epgsearchcmds-eng.conf -will be loaded if the, in VDR selected, language is english.

If there is no file for the selected language, epgsearch tries to load -epgsearchcmds.conf.

SYNTAX

Description : Command

EXAMPLE

epg2taste (de): /usr/local/vdr/epg2taste.sh

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchdirs.conf.5.html b/html/en/epgsearchdirs.conf.5.html deleted file mode 100644 index 90a5e2f..0000000 --- a/html/en/epgsearchdirs.conf.5.html +++ /dev/null @@ -1,129 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
SYNTAX
EXAMPLE
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchdirs.conf - List of directories for selecting in epgsearch

DESCRIPTION

This is one source of the 'Select directory' menu.

This file contain directories which can be used for search timers or -ordinary timers.

The items displayed are read from the following sources:

-   * current recording directories
-   * current timer directories
-   * directories used in search timers
-   * directories specified in F<epgsearchdirs.conf>

SYNTAX

Each line contains a directory. You can use every variable, internal ones -those defined in epgsearchuservars.conf and the variables of the -extended EPG.

See epgsearchcats.conf(5) and epgsearchuservars.conf(5).

Internal ones:

- %time%           - start time in format HH:MM
- %date%           - start date in format TT.MM.YY
- %datesh%         - start date in format TT.MM.
- %time_w%         - weekday name
- %time_d%         - start day in format TT
- %time_lng%       - start time in seconds since 1970-01-01 00:00
- %title%          - title
- %subtitle%       - subtitle

EXAMPLE

- %Category%~%Genre%
- %Category%~%Genre%~%Title%~%Episode%: %Subtitle%
- Information~Nature~%Title%~%Episode%: %Subtitle%
- %Series%
- Movie~Action
- Movie~Docu
- Movie~Thriller
- Music
- Sports

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchmenu.conf.5.html b/html/en/epgsearchmenu.conf.5.html deleted file mode 100644 index 01944fc..0000000 --- a/html/en/epgsearchmenu.conf.5.html +++ /dev/null @@ -1,162 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
EXAMPLE
SYNTAX
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchmenu.conf - Customizing the EPG menus

DESCRIPTION

EXAMPLE

- MenuWhatsOnNow=%chnr%:3|%progrt2s%:5| %time% %t_status%:8|%category%:6| %title% ~ %subtitle%:35
- MenuWhatsOnNext=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
- MenuWhatsOnElse=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
- MenuSchedule=%time% %t_status%:8|%genre%:14| %title% ~ %subtitle%:35
- MenuSearchResults=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon% %subtitle%:35
- MenuFavorites=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon%%subtitle%:35

SYNTAX

- MenuSearchResultsTip of the Day=%chnr%:3|%time_w%:4|%t_status%:3|%genre%:10|%title%%colon% %subtitle%:35

The following variables exist:

- %time%           - start time in format HH:MM   
- %date%           - start date in format TT.MM.YY
- %datesh%         - start date in format TT.MM.
- %time_w%         - weekday name
- %time_d%         - start day in format TT
- %time_lng%       - start time in seconds since 1970-01-01 00:00
- %title%          - title   
- %subtitle%       - subtitle
- %t_status%       - timer status ('T', 't', 'R')
- %v_status%       - VPS status
- %r_status%       - running status
- %status%         - complete status, the same as
-                    '%t_status%%v_status%%r_status%'
- %colon%          - the sign ':'
- %<epg-category>% - a value from the extended EPG categories, specified in
-                    epgsearchcats.conf, like %genre% or %category%

for the 'Whats on...' and 'Search results' menu there is also:

- %chnr%           - channel number
- %chsh%           - the short channel name (>=vdr-1.3.15)
- %chlng%          - the 'normal' channel name
- %chdata%         - VDR's internal channel representation (e.g. 'S19.2E-1-1101-28106')
- %progr%          - graphical progress bar (not for menu 'Search results')
- %progrT2S%       - progress bar in text2skin style (not for menu 'Search results')

the variables are not case sensitive.

An entry consists of up to 6 tables separated with '|'. The last entry of -each table should declare the table width in chars, separated with ':'.

There's a sample epgsearchmenu.conf in the subdirectory ``conf''. For a quick try -copy it to your plugins config directory (e.g. /etc/vdr/plugins).

To enable icons from WarEagleIcon-Patch simply put the line

- WarEagleIcons=1

to epgsearchmenu.conf.

NOTE: As long as there is a file epgsearchmenu.conf with an entry for a special -menu, all setup settings regarding the look of this menu are ignored.

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchswitchtimers.conf.5.html b/html/en/epgsearchswitchtimers.conf.5.html deleted file mode 100644 index 60e8c14..0000000 --- a/html/en/epgsearchswitchtimers.conf.5.html +++ /dev/null @@ -1,102 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
SYNTAX
EXAMPLE
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchswitchtimer.conf - The list of switchtimer

DESCRIPTION

In epgsearch switchtimer can be created via the program menu -or the searchtimers. These switchtimer can switch the channel -at the beginning of the event or only inform you about the -start via OSD.

The switchtimers are saved in this file.

SYNTAX

The delimiter is ':'.

This fields are possible:

- 1 - Channel
- 2 - Event ID
- 3 - Start time
- 4 - Minutes to switch before event
- 5 - Only inform via OSD
- 6 - unmute sound if off

EXAMPLE

- S19.2E-1-1089-12060:52221:1153322700:1:0

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchtemplates.conf.5.html b/html/en/epgsearchtemplates.conf.5.html deleted file mode 100644 index f7d216d..0000000 --- a/html/en/epgsearchtemplates.conf.5.html +++ /dev/null @@ -1,86 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
SYNTAX
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchtemplates.conf - Searchtimer templates

DESCRIPTION

In epgsearch searchtimer templates can be created for easy -creating new searchtimers.

These templates are saved in this file.

SYNTAX

This file has the same syntax as the epgsearch.conf.

So please refer to epgsearch.conf, see epgsearch.conf(5).

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/epgsearchuservars.conf.5.html b/html/en/epgsearchuservars.conf.5.html deleted file mode 100644 index 96be465..0000000 --- a/html/en/epgsearchuservars.conf.5.html +++ /dev/null @@ -1,201 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
SYNTAX

Assignment
Control structures
Calling a system command
Possible variables

EXAMPLES
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

epgsearchuservars.conf - User defined variables

DESCRIPTION

In this file you can defines variables which then can be used -in epgsearch in any play where variables are possible.

SYNTAX

Variables looks like %Variablename%.

``Variablename'' can be consist of any alphanumerical character. Space -and special characters are not allowed.

The variable names are case-insensitive.

Examples for possible names:

- %Series% %DocuVar1% %ThemesSubtitleDate1%

Assignment

- %Series%=New series~Thriller

The variable %Series% will be assigned with the string ``New series~Thriller''.

Assignments are always strings. Spaces stay spaces.

- %Path%=%Series%

The variable %Path% gets the content of the variable %Series%.

You can do nearly everything:

- %Path%=%Serie%~Lost

The variable %Path% contains now the string ``New series~Thriller~Lost''.

Control structures

You can use simple ``if then else'' constructions.

These constructions cannot contain strings, only variables. -Spaces are ignored.

- %Foo%=Other

- %Variable%=%Path% ? %Path% : %Foo%

If %Path% is not empty, assign the content of %Path% to %Variable%, -otherwise the content of %Foo%.

``%Path% ?'' means ``not empty?''. You can use other checks.

- %Variable%=%Path%!=5 ? %Path% : %Foo%

``%Path%!=5 ?'' means ``is %Path% equal 5?''

You can also compare variables.

- %Five%=5

- %Variable%=%Path%!=%Five% ? %Path% : %Foo%

Other possible checks:

- ==   equal
- !=   not equal

Calling a system command

You can call external commands. The returned string will be assigned -to a variable

- %Result%=system(scriptname,%Variable1% %Variable2% -f %Variable3% --dir=%Variable4% --dummy)

Calls the script ``scriptname'' with the parameters ``%Variable1%'', -``%Variable2%'', etc. The result will be stored in %Result%.

You can use as many variables as you want.

If needed, epgsearch will quote the variable.

The script must return a string without line break!

If the script returns nothing, an empty string will be assigned to the -Variable %Result%.

Possible variables

The following variables exist:

- %time%           - start time in format HH:MM
- %timeend%        - end time in format HH:MM
- %date%           - start date in format TT.MM.YY
- %datesh%         - start date in format TT.MM.   
- %time_w%         - weekday name
- %time_d%         - start day in format TT
- %time_lng%       - start time in seconds since 1970-01-01 00:00
- %title%          - title
- %subtitle%       - subtitle
- %summary%        - summary
- %htmlsummary%    - summary, where all CR are replaced with '<br />'
- %eventid%        - numeric event ID

- %<epg-category>% - a value from the extended EPG categories, specified in
-                    F<epgsearchcats.conf>, like %genre% or %category%

- %chnr%           - channel number
- %chsh%           - the short channel name (>=vdr-1.3.15)
- %chlng%          - the 'normal' channel name
- %chdata%         - VDR's internal channel representation (e.g. 'S19.2E-1-1101-28106')

- %colon%          - the sign ':'
- %datenow%        - current date in format TT.MM.YY
- %dateshnow%      - current date in format TT.MM.
- %timenow%        - current time in format HH:MM
- %videodir%       - VDR video directory (e.g. /video)
- %plugconfdir%    - VDR plugin config directory (e.g. /etc/vdr/plugins)
- %epgsearchdir%   - epgsearchs config directory (e.g. /etc/vdr/plugins/epgsearch)

EXAMPLES

- # Weekday, Date, Time   
- %DateStr%=%time_w% %date% %time%

- # Themes or Subtitle or Date
- %ThemesSubtitleDate1%=%Subtitle% ? %Subtitle% : %DateStr%
- %ThemesSubtitleDate%=%Themes% ? %Themes% : %ThemesSubtitleDate1%

- # Calls this script to get a recording path
- %DocuScript%=system(doku.pl,%Title%,%Subtitle%,%Episode%,%Themes%,%Category%,%Genre%)
- %Docu%=%DocuScript%

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/noannounce.conf.5.html b/html/en/noannounce.conf.5.html deleted file mode 100644 index 6dd078d..0000000 --- a/html/en/noannounce.conf.5.html +++ /dev/null @@ -1,97 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
FORMAT
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

noannounce.conf - list of events that have been marked to not be announced -via OSD

DESCRIPTION

This file contains a list of events that have been marked to not be announced -via OSD by the search timer background thread.

If the user presses one of the keys 'Ok', '0', ... '9' while the announcement -of an event is displayed, he will be asked if further announcements of this -event should be disabled for ever (user hit '0' or 'Ok') or for the next 'x' -days (user hit '1' to '9'). After pressing 'Ok' again, this setting will be -stored.

FORMAT

Events are stored one per line, where the fields are separated with ':'.

The following fields exists:

-  1 - title
-  2 - short text
-  3 - channel ID
-  4 - start time
-  5 - next announce time

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

- - - - diff --git a/html/en/timersdone.conf.5.html b/html/en/timersdone.conf.5.html deleted file mode 100644 index b1d739d..0000000 --- a/html/en/timersdone.conf.5.html +++ /dev/null @@ -1,83 +0,0 @@ - - - - -Epgsearch Version 0.9.24.beta9 - - - - - - -

- - -

NAME
DESCRIPTION
FORMAT
SEE ALSO
AUTHOR (man pages)
REPORT BUGS
COPYRIGHT and LICENSE

- - -

NAME

timersdone.conf - list of current timers created by search timers

DESCRIPTION

This file contains the current timers that were created by search timers. If -the setup option 'Recreate timers after deletion' is set to 'no', epgsearch -uses this list to determine if a timer was already created and cancels -further timer creations. If a corresponding recording was made for any timer -in this list, the timer is automatically removed from it.

FORMAT

Timers are stored one per line, where the fields are separated with ':'.

The following fields exists:

-  1 - channel-ID
-  2 - start time
-  3 - stop time
-  4 - search timer ID
-  5 - event title
-  6 - event episode

AUTHOR (man pages)

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

REPORT BUGS

Bug reports (german):

http://www.vdr-developer.org/mantisbt/

Mailing list:

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

COPYRIGHT and LICENSE

http://www.cwieninger.de.vu/

This is free software. You may redistribute copies of it under the terms of the GNU General Public License <http://www.gnu.org/licenses/gpl.html>. -There is NO WARRANTY, to the extent permitted by law.

- - - - -- cgit v1.2.3