4mepgsearch24m(1)                Epgsearch Version 2.4.4               4mepgsearch24m(1)

1mNAME0m
       epgsearch - Suchtimer und Ersatz für VDR's Standard-Programm-Menü

1mBESCHREIBUNG0m
       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

       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!

1mOPTIONEN0m
       -f file,  --svdrpsendcmd=file
           Pfad  zu  svdrpsend  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.

1mInhalt0m
        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

1m1. Beschreibung0m
       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):

   1m1.1 Menü Befehle0m
       Dieses  Menü  zeigt  Befehle  an,  die auf den ausgewählten Menüeintrag
       angewandt werden können. Es gibt 8 vorgegebene Befehle:

        - Wiederholung: Zeigt weitere Sendungen mit gleichem Titel
        - 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.

   1m1.2 Menü Suche0m
       Hier  kann  man  eine  Suche  im  EPG  erzeugen, editieren, löschen und
       ausführen. Bedienung und Verhalten ist ähnlich zu VDR's Timer-Menü.

       4m1.2.124m 4mMenü24m 4mSuche24m 4meditieren0m

       Das meiste in diesem  Menü  ist  selbsterklärend,  deshalb  nur  einige
       Anmerkungen zu:

       - 1mSuche:0m
           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!

       - 1mSuchmodus:0m
           '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.

       - 1mVerw. Kennung für Inhalt0m
           Einige Provider liefern Kennungen für  den  Inhalt  einer  Sendung,
           z.B.     "Film/Drama",   "Dokumentation",...(erst   ab   vdr-1.7.11
           verfügbar) Hiermit können diesen Kennungen  ausgewählt  werden.  Es
           ist  auch eine Mehrfachauswahl möglich, die dann in allen Kennungen
           übereinstimmen muss (UND-Verknüpfung).

       - 1mVerw. erweiterte EPG Info0m
           (nur verfügbar, wenn konfiguriert. Siehe weiter  unten  'Verwendung
           erweiterter EPG Infos')

       - 1mIgnoriere fehlende Kategorien0m
           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.

       - 1mVerw. Kanal:0m
           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!

       - 1mVerwende Wochentag:0m
           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

       - 1mVerwende Ausschlusslisten:0m
           Ausschlusslisten können benutzt werden, um  unerwünschte  Sendungen
           auszuschließen.   Hier  können  nur globale, eine oder mehrere oder
           alle Ausschlusslisten selektiert werden.   Falls  ein  Suchergebnis
           auch  in  einer  der  gewählten Ausschlusslisten erscheint, wird es
           verworfen.

       - 1mIn Favoritenmenü verw.:0m
           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.

       - 1mLayout des Ergebnismenüs:0m
           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.

       - 1mVerwende als Suchtimer:0m
           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.

       - 1mAktion:0m
           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, sobald diese gefunden
           wird.  Eine weitere Möglichkeit ist 'nur umschalten'. Dadurch  wird
           automatisch  eine  Minute  vor  Beginn  der Sendung auf deren Kanal
           gewechselt. Ebenso kann mit 'Ankündigen und Umschalten' die Sendung
           vor ihrem Beginn angekündigt werden und mit 'Ok' zum entsprechenden
           Kanal gewechselt werden.  Weitere  Aktionen  sind  'Ankündigen  per
           Mail' und 'Inaktive Aufnahme'

       - 1mSerienaufnahme:0m
           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.

       - 1mVerzeichnis:0m
           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')

       - 1mAufn. nach ... Tagen löschen0m
           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

       - 1mPause, wenn ... Aufnahmen existieren0m
           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.

       - 1mWiederholung vermeiden0m
           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.

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

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

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

       - 1mVergleiche Untertitel0m
           Einstellung,  ob beim Test, ob eine Sendung identisch ist, auch der
           Untertitel verglichen werden soll. Bei 'ja'  stuft  epgsearch  zwei
           Sendungen nur dann als identisch ein, wenn die Episodennamen gleich
           sind  und  nicht  leer.   Bei 'erlaube leere' können auch Sendungen
           identisch sein, wenn beide Unterttitel  leer  sind.  Im  Normalfall
           sollte dann auf "nein" gestellt werden.

       - 1mVergleiche Beschreibung0m
           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   zum
           Prozentsatz der folgenden Option ähnlich (im Sinne des Levinshtein-
           Distance-Algorithmus) wird er als gleich behandelt.

       - "Min. Übereinstimmung in %"
           Die notwendige Übereinstimmung zweier Beschreibung in %.

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

       - 1mVergl. Kategorien0m
           Über  die Schaltfläche 'Einstellungen' kann angegeben werden welche
           Kategorien ebenfalls miteinander verglichen werden sollen.

       - 1mPriorität, Lebensdauer, Zeitpuffer Anfang und Ende:0m
           Jeder Suchtimer  kann  für  diese  Parameter  eigene  Einstellungen
           haben. Die Voreinstellung wird im Setup vorgenommen.

       - 1mVPS:0m
           aktiviert  VPS,  falls  im  VDR-Setup  aktiv  und für die gefundene
           Sendung auch VPS-Informationen vorhanden sind.

       - 1mautomatisch löschen:0m
           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.

       4m1.2.224m 4mMenü24m 4mSuchergebnisse0m

       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ü.

   1m1.3 Erweitertes 'Jetzt' and 'Nächste'0m
       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.

   1m1.4 Menü Setup0m
       4m1.4.124m 4mAllgemein0m

       - 1mHauptmenüeintrag verstecken:0m
           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).

       - 1mHauptmenü-Eintrag0m
           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.

       - 1mStartmenü:0m
           Auswahl von 'Programm' oder 'Jetzt' als Startmenü.

       4m1.4.224m 4mEPG24m 4mMenüs0m

       - 1mTaste Ok:0m
           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.

       - 1mTaste Rot:0m
           Auswahl,  ob  man  den  Standard  ('Aufnehmen')  oder 'Befehle' als
           Vorbelegung möchte.

       - 1mTaste Blau:0m
           Auswahl, ob  man  den  Standard  ('Umschalten')  oder  'Suche'  als
           Vorbelegung möchte.

       - 1mZeige Fortschrittsbalken in 'Jetzt':0m
           Im  Menü  'Jetzt' kann ein Fortschrittsbalken angezeigt werden, der
           den Fortschritt der laufenden Sendung anzeigt.

       - 1mZeige Kanalnummer:0m
           auswählen, um eine führende Programmnummer  vor  jedem  EPG-Eintrag
           anzuzeigen.

       - 1mZeige Kanal-Separatoren:0m
           zur   Anzeige   einer  Trennzeile  zwischen  Kanalgruppen  im  Menü
           'Übersicht - Jetzt' ...

       - 1mZeige Tages-Separatoren:0m
           zur Anzeige einer Trennzeile zwischen  Sendungen  unterschiedlicher
           Tage im Menü 'Programm'.

       - 1mZeige Radiokanäle:0m
           Zeigt auch Radiokanäle an.

       - 1mLimit channels from 1 to:0m
           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.

       - 1mTimer mit 'Aufnehmen' sofort anlegen:0m
           Falls 'Ja' wird ein Timer sofort erzeugt,  sobald  man  'Aufnehmen'
           drückt, sonst wird das Timer-Edit-Menü angezeigt.

       - 1mZeige Kanäle ohne EPG:0m
           zur  Anzeige  von  Programmen  ohne EPG, um auf diese umschalten zu
           können oder einen Timer zu programmieren

       - 1mTimer mit 'Aufnehmen' sofort anlegen:0m
           Falls 'Ja' wird  nach  Drücken  von  'Aufnahme'  sofort  ein  Timer
           angelegt, falls 'Nein' erscheint das Timer-Edit-Menü.

       - 1mZeitintervall für FR/FF [min]:0m
           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.

       - 1mGrün/Gelb umschalten:0m
           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.

       - 1mZeige Favoriten-Menü:0m
           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.

       - 1mfür die nächsten ... Stunden:0m
           Mit diesem Wert wird die Zeitspanne eingestellt, für die  Favoriten
           angezeigt werden sollen.

       4m1.4.324m 4mBenutzerdef.24m 4mEPG-Zeiten0m

       - 1mBenutzerdef. Zeit 1..4:0m
           Bis  zu 4 benutzerdefinierte Zeiten können zu 'Jetzt' und 'Nächste'
           hinzugefügt werden.

       - 1mBeschreibung:0m
           Name  der  benutzerdef.   Zeit,   z.B.   'Nachmittags',   'Abends',
           'Spätabends'.

       - 1mZeit:0m
           zugehörige Uhrzeit.

       4m1.4.424m 4mTimer-Programmierung0m

       - 1mVDR's Time-Edit-Menü verw.0m
           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.

       - 1mStandard Aufn. Verzeichnis:0m
           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.

       - 1mUntertitel in manuellen Timern:0m
           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.

       - 1mStandard-Timer-Prüfmethode:0m
           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.

       4m1.4.524m 4mSuche24m 4mund24m 4mSuchtimer0m

       - 1mVerwende Suchtimer:0m
           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.

           Suchtimer  werden  immer  lokal  erzeugt,  auch  wenn  ein  anderer
           Defaulthost für Aufnahmen definiert ist.

       - 1mAktualisierungsintervall:0m
           Das  Intervall  in Minuten, in dem die Hintergrundsuche vorgenommen
           wird.

       - 1mSVDRP Port:0m
           Falls nicht der  Standard-SVDRP-Port  6419  (2001  vor  vdr-1.7.15)
           verwendet  wird,  dann  bitte  hier  anpassen,  damit die Suchtimer
           funktionieren.

       - 1mVerzögerung der internen Threads:0m
           Der Start des Suchtimer-Updatethreads und des  folgenden  Konflikt-
           Checks  kann  um  0...300 Sekunden nach VDR-Ready verzögert werden.
           Default sind 10 Sekunden

       - 1mPriorität, Lebensdauer und Zeitpuffer für Anfang und Ende:0m
           Voreinstellungen

       - 1mErlaubte Fehler:0m
           Erlaubte Aufnahmefehler,  bevor  eine  Aufnahme  als  unvollständig
           gekennzeichnet wird (nicht verfügbar in vdr 2.4)

       - 1mKeine Ankündigung bei Wiedergabe:0m
           zum  Unterdrücken  von Sendungs-Ankündigungen während einer aktiven
           Wiedergabe.

       - 1mTimer nach Löschen neuprogrammieren:0m
           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.

       - 1mPrüfe ob EPG für ... [h] existiert:0m
           Falls EPG von externen Anbietern bezogen wird, kann es  vorkommenm,
           dass  hier auch mal etwas schiefläuft und somit wegen fehlendem EPG
           Aufzeichnungen verlorengehen.  Hiermit kann geprüft werden, ob  für
           die  nächsten ... Stunden EPG bei den gewünschten Sendern vorhanden
           ist. Mit '0' wird die Prüfung deaktiviert.

       - "per OSD warnen:"
           falls ja, erscheint die Warnung als OSD-Einblendung

       - "per Mail warnen:"
           falls ja, wird die Warnung per Mail versandt. Bitte das Email-Konto
           unter Email-Benachrichtigung konfigurieren.

       - "zu prüfende Kanalgruppe:"
           hier die Kanalgruppe auswählen, für die  die  Prüfung  durchgeführt
           werden soll.  Gegebenefalls zuvor unter Kanalgruppen anlegen.

       - 1mPayTV-Sender ignorieren:0m
           Auf  'Ja'  setzen, wenn man bei der Suche nach Wiederholungen keine
           Sendungen von PayTV-Sendern haben will.

       - 1mSuch-Vorlagen:0m
           Hier können Suchvorlagen verwaltet werden, die beim  Anlegen  neuer
           Suchen verwendet werden können.

       - 1mAusschlusslisten:0m
           Hier   können   Ausschlusslisten  verwalten  werden.  Diese  können
           innerhalb einer Suche verwendet werden um unerwünschte Sendungen zu
           vermeiden.    Eine   Ausschlussliste   kann   auch    als    global
           gekennzeichnet  werden.  Da  die Standardeinstellung beim Suchtimer
           für die Option 'Ausschlusslisten verw.'  auf 'nur  globale'  steht,
           kann  man somit einfach unerwünschte Sendungen von allen Suchtimern
           ausschließen.   Ausnahme:   Falls   beim   Suchtimer   die   Option
           'Ausschlusslisten  verw.:  keine'  gewählt  ist,  hat  eine globale
           Ausschlussliste   keine   Auswirkung.   Ebenso    werden    globale
           Ausschlusslisten  bei  der  Suche  nach Wiederholungen über das OSD
           ignoriert.

       - 1mKanalgruppen:0m
           verwaltet die Kanalgruppen, die als Suchkriterium  in  einer  Suche
           verwendet werden können. Die Verwaltung ist auch im Edit-Menü einer
           Suche möglich.

       1mWichtig22m:  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 plug epgsearch SETS off

       <das EPG update Skript>

       svdrpsend plug epgsearch SETS on

       4m1.4.624m 4mTimer-Konflikt-Prüfung0m

       - 1mIgnoriere unter Priorität:0m
           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.

       - 1mIgnoriere Konfliktdauer unter ... Min.:0m
           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.

       - 1mPrüfe nur die nächsten ... Tage:0m
           Hier kann der Zeitraum der Prüfung angegeben werden.

       - 1mKonflikte auch für Remote-Timer prüfen:0m
           Falls SVDRPPeering aktiv ist, werden auch Konflikte bei  entfernten
           Timern  überpüft.  Dazu  muss  am entsprechenden Remote-Rechner das
           epgsearch-Plugin ebenfalls aktiviert sein. Default ist nein.

       - 1mNach jeder Timer-Programmierung:0m
           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.

       - 1mBeim Beginn einer Aufnahme:0m
           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.

       - 1mNach jedem Suchtimer-Update:0m
           Hier  kann  eingestellt  werden, ob eine Konfliktprüfung nach jedem
           Suchtimer-Update erfolgen soll. Falls nicht:

       - 1mnach ... Minuten:0m
           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.

       - 1mWenn nächster Konflikt in ... Minuten:0m
           Wenn nächster Konflikt in ... Minuten eintritt, verwende  folgendes
           Prüfintervall.

           - 1malle ... Minuten:0m
               um  einen  Konflikt  in Kürze nicht zu übersehen, kann hier ein
               kürzeres Prüfintervall eingestellt werden.

       - 1mVermeide Nachricht bei Wiedergabe:0m
           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.

       4m1.4.724m 4mEmail-Benachrichtigungen0m

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

       - 1mSuchtimer-Benachrichtigung:0m
           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.)

       - 1mZeit zwischen Mails [h]:0m
           Für Benachrichtigungen zu Suchtimern kann  hier  angegeben  werden,
           welchen  Mindestabstand  in  Stunden die Mails haben sollen. Sobald
           die entsprechende Zeit verstrichen ist, wird  eine  Mail  nach  dem
           nächsten  Suchtimer-Update  versandt.  Der  Wert '0' bedeutet keine
           Verzögerung und bewirkt einen sofortigen Mailversand.

       - 1mTimer-Konflikt-Benachrichtigung:0m
           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.)

       - 1mEmail-Adresse:0m
           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.

       - 1mMail-Methode:0m
           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.

       - 1mEmail-Adresse:0m
           Hier bitte die volle (!) Email-Adresse  hinterlegen,  von  der  die
           Nachricht versandt werden soll.

       - 1mSMTP Server:0m
           Der Name des SMTP Servers, über den der Mailversand erfolgt.

       - 1mVerw. SMTP-Authentifizierung:0m
           'Ja' wählen wenn das Emailkonto eine SMTP-Authentifizierung für den
           Emailversand benötigt.

       - 1mAUTH-Benutzer:0m
           Hier  bitte  den  Benutzernamen  angeben, falls das Email-Konto mit
           Authentifizierung arbeitet.

       - 1mAUTH-Passwort:0m
           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.

1m2. Suchtimer0m
       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 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?'.

1m2.1 'Wiederholungen vermeiden' - Im Detail0m
       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.

   1m2.2 Wie funktioniert der Vergleichstest zwischen 2 Sendungen?0m
       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.

   1m2.3 Wie und wo wird der Vergleichstest eingesetzt?0m
       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. Seit vdr  2.5.x  werden  auch  Aufnahmen  mit  Fehlern  nicht
       registriert.  Möchte  man  eine  bestimmte  Anzahl  von Aufnahmefehlern
       zulassen, kann der Wert für "Erlaubte Fehler" hochgesetzt werden.

       1mWie verwenden?0m

       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.

       1mWenn es nicht richtig funktioniert :-)0m

       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'.

1m3. Verwendung der Suche durch andere Plugins oder Skripte0m
       Siehe epgsearch(4).

1m4. Verwendung erweiterter EPG Infos0m
       Einige  EPG  Provider  liefern  zusätzliche  EPG  Infos wie die Art der
       Sendung,  das  Video  und  Audio  Format,  die  Besetzung,...  in   der
       Beschreibung der Sendung.

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

       Mit tvmovie2vdr oder epg4vdr 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.

1m5. Ersetzen des Standardmenü0m
       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.

       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.

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

       - 1mepgsearchonly:0m
           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".

       - 1mconflictcheckonly:0m
           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

1mAusführliche Beschreibung0m
       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>

1mSIEHE AUCH0m
       "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)"

1mDATEIEN0m
       4mepgsearch.conf0m

       Enthält die Suchtimer. Siehe "epgsearch.conf(5)".

       4mepgsearchcats.conf0m

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

       4mepgsearchcmds.conf0m

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

       4mepgsearchdirs.conf0m

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

       4mepgsearchmenu.conf0m

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

       4mepgsearchuservars.conf0m

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

       4mepgsearchdone.data0m

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

       4mepgsearchswitchtimers.conf0m

       Enthält die Umschalttimer. Siehe "epgsearchswitchtimer.conf(5)".

       4mepgsearchblacklists.conf0m

       Enthält die Ausschlussliste. Siehe "epgsearchblacklists.conf(5)".

       4mepgsearchchangrps.conf0m

       Enthält die Kanalgruppen. Siehe "epgsearchchangrps.conf(5)".

       4mepgsearchtemplates.conf0m

       Enthält die Vorlagen für Suchtimer. Siehe "epgsearchtemplates.conf(5)".

1mAUTOR (man pages)0m
       Mike Constabel <epgsearch (at) constabel (dot) net>

1mFEHLER MELDEN0m
       Fehlerberichte bitte im Bugtracker.

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

       Mailinglist:

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

1mCOPYRIGHT and LIZENZ0m
       Copyright © 2004-2010 Christian Wieninger

       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..

perl v5.40.1                      2025-10-30                      4mepgsearch24m(1)
