epgsearch(1)                 EPGSearch Version 2.4.6                epgsearch(1)

NAME
     EPGSearch – Suchtimer und Ersatz für das Standard-Programm-Menü des VDR

BESCHREIBUNG
     EPGSearch  kann  als Ersatz für das übliche Programm-Menü des VDR verwendet
     werden. Es sieht zwar genauso aus, erweitert es aber um einige  zusätzliche
     Funktionen:

     • Im  Hauptmenü  kann die normale Programmübersicht des VDR durch einen er‐
       weiterten Programmführer ersetzt werden.

     • Der Programmführer erlaubt den Wechsel zwischen den nächsten und den ger‐
       ade laufenden Sendungen.

     • Neben den zeitnahen Sendungen erlaubt der Programmführer die Anzeige  von
       Sendungen  für bis zu vier benutzerdefinierte Zeiten sowie eine Übersicht
       selbstdefinierter Favoriten.

     • Verschiebung der  im  Programmführer  angezeigten  Zeit  per  Tastendruck
       (bspw. um 30 Minuten).

     • Fortschrittsanzeige  in  der  Programmübersicht für die laufenden und die
       nächsten Sendungen.

     • Integrierte Befehle, um etwa Wiederholungen von Sendungen anzuzeigen oder
       Suchtimer für diese anzulegen. Zudem  lassen  sich  eigene  Befehle  ein‐
       binden, um beispielsweise VDRAdmin-Autotimer zu erstellen.

     • Suche  im  EPG:  Anlegen  von  wiederverwendbaren  Abfragen, die auch als
       Suchtimer verwendet werden können.

     • Suchtimer:  Hintergrundsuche  nach  zutreffenden  Sendungen  und  Anlegen
       entsprechender  Timer  (ähnlich  der  Autotimer  von  VDRAdmin)  oder Be‐
       nachrichtigung über Sendungen per OSD.

     • Unterstützung von Inhaltskennungen und erweiterten  EPG-Informationen  in
       Suchtimern.

     • Vermeidung von mehrfachen Aufnahmen der gleichen Sendung:

       – Timer-Vorschau
       – Erkennung unbrauchbarer Aufnahmen
       – Unscharfer Vergleich von Sendungen



     • Erweiterung  des Timer-Editieren-Menüs um Verzeichnisse, flexible Auswahl
       von Wochentagen und Ergänzung von Untertiteln ("Episodennamen").

     • Hintergrundüberwachung auf Timer-Konflikte in Verbindung mit einem Timer-
       Konfliktmanager.

     • Benachrichtigung über erkannte Timer-Konflikte per OSD.

     • Detaillierte Anzeige der Timer-Konflikte und Unterstützung bei deren  Au‐
       flösung.

     • E-Mail-Benachrichtigungen  über Suchtimer-Aktualisierungen und Timer-Kon‐
       flikte.

     Teile der Quelltexte  basieren  auf  dem  Repeating-EPG-Patch  von  Gerhard
     Steiner, der die Erlaubnis gab, diese zu verwenden. Danke für seine Arbeit!

OPTIONEN
     −f file,  −−svdrpsendcmd=file
         Pfad zu svdrpsend für externe SVDRP-Kommunikation. Standard ist interne
         Kommunikation,  weshalb  diese  Option normalerweise nicht erforderlich
         ist.

     −c path,  −−config=path
         Festlegung  eines   eigenen   Konfigurationsverzeichnisses   für   alle
         EPGSearch-Dateien    (Standard    ist   <Plugin-Konfigurationsverzeich‐
         nis>/epgsearch).

     −l file,  −−logfile=file
         Festlegung  eines  abweichenden  Dateipfades  für  das   Log-File   von
         EPGSearch.  Standard ist epgsearch.log im Konfigurationsverzeichnis von
         EPGSearch.

     -v n,  −−verbose=n
         Detailgrad  für das Log-File. Der Wert 0 bedeutet kein Logging. Weitere
         Werte sind 1 (allgemeine Meldungen), 2 (detaillierte Meldungen), 3 (für
         Debug-Zwecke).

     −r,  −−reloadmenuconf
         Bewirkt ein Neuladen der Datei  epgsearchmenu.conf  bei  jedem  Plugin-
         Aufruf  im  OSD.  Dies  kann  für  das  Testen eines selbst angepassten
         Menü-Layouts praktisch sein.

     −m file,  −−mailcmd=file
         Externes Kommando für den  E-Mail-Versand.  Als  Standard  wird  sendE‐
         mail.pl  benutzt.  Wenn ein abweichendes Kommando oder Skript verwendet
         werden soll, muss sichergestellt sein, dass das  gleiche  Parameter-In‐
         terface 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ü 'Einstellungen'
            1.4.1 Allgemein
            1.4.2 EPG-Menüs
            1.4.3 Benutzerdefinierte EPG-Zeiten
            1.4.4 Timer-Programmierung
            1.4.5 Suche und Suchtimer
            1.4.6 Timer-Konfliktprüfung
            1.4.7 E-Mail-Benachrichtigung
     2. Suchtimer
        2.1 Wiederholungen vermeiden im Detail
        2.2 Wie funktioniert der Vergleichstest zweier Sendungen?
        2.3 Wie und wo wird der Vergleichstest eingesetzt?
            2.3.1 Wie verwenden?
            2.3.2 Wenn es nicht richtig funktioniert
     3. Verwendung der Suche durch andere Plugins oder Skripte
     4. Verwendung erweiterter EPG-Informationen
     5. Ersetzen des Standard-Programm-Menüs
     6. Add-ons

1. Beschreibung
     Auf  den  ersten  Blick  sieht EPGSearch wie das Programm-Menü des VDR aus.
     Ein Tastendruck auf 0 schaltet die Farbtasten um, so dass weitere  Funktio‐
     nen  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  ange‐
     wandt werden können. Es gibt acht vorgegebene Befehle:

     Wiederholungen
         Zeigt weitere Sendungen mit gleichem Titel.

     Aufnehmen
         Legt einen Timer zum Aufnehmen der Sendung an.

     Umschalten
         Schaltet zum Kanal der Sendung um.

     Suche anlegen
         Schaltet  zum  Suchmenü  und  erzeugt  eine Suche mit dem Namen der ak‐
         tuellen Sendung als Suchbegriff (um eine manuelle Erfassung zu  vermei‐
         den).

     Suche in Aufnahmen
         Durchsucht die Aufnahmen nach einer Sendung gleichen Namens.

     Als 'bereits aufgezeichnet' markieren?
         Übernimmt  die  ausgewählte Sendung in die Datei epgsearchdone.data und
         weist EPGSearch an, diese Sendung nicht aufzunehmen,  falls  der  zuge‐
         hörige Suchtimer auf 'Wiederholung vermeiden' gestellt 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  Um‐
         schaltliste enthalten ist, wird kurz vor Beginn eine Ankündigung einge‐
         blendet und dann umgeschaltet. Um die gesamte Umschaltliste einzusehen,
         bitte 'Suche' » 'Aktionen' » 'Zeige Umschaltliste' aufrufen.

     Ausschlussliste anlegen
         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 Konfigurationsverzeichnis von EPGSearch editiert. Eine Beispieldatei mit
     exemplarischen  Skripten  liegt  dem  Plugin  bei  (siehe  Unterverzeichnis
     scripts; sie stammt von 'vdr-wiki.de' – Dank an die Autoren).

     Das  Format  der  Datei  ist  identisch  zur  Datei commands.conf oder rec‐
     cmds.conf des VDR; siehe auch epgsearchcmds.conf(5).

     Wenn ein Befehl ausgeführt wird, werden folgende Parameter übergeben:

     $1  Titel des Programmeintrags.

     $2  Startzeitpunkt des Programmeintrags in  Epoch-Notation  (Sekunden  seit
         dem 01.01.1970, 00:00 UTC), wie auch beim Shutdown-Skript.

     $3  Endzeitpunkt  des Programmeintrags in Epoch-Notation (Sekunden seit dem
         01.01.1970, 00:00 UTC).

     $4  Kanalnummer des Programmeintrags.

     $5  Vollständiger Kanalname des Programmeintrags.

     $6  Untertitel des Programmeintrags oder ein  leerer  String,  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 wie im Timer-Menü des VDR.

     1.2.1 Menü 'Suche editieren'

     Das Meiste in diesem Menü ist selbsterklärend. Deshalb nur einige Anmerkun‐
     gen zu ausgewählten Elementen:

     Suche
         Der Suchbegriff. Bei der Suche nach mehreren  Worten,  sind  diese  mit
         Leerzeichen  zu  trennen. Lässt man den Suchbegriff leer (in Verbindung
         mit Suchmodus 'Ausdruck'), wird alles akzeptiert.  Das  kann  praktisch
         sein,  um  etwa alles zu suchen, was zu einer bestimmten Zeit auf einem
         bestimmten Sender kommt.

         Mit Taste '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
         Für die Suche stehen mehrere Varianten zur Auswahl:

         Ausdruck
             Sucht nach dem entsprechenden  Ausdruck  innerhalb  eines  EPG-Ein‐
             trags.

         Alle Worte
             Erfordert, dass jedes Wort im EPG-Eintrag vorkommt.

         Ein Wort
             Erfordert,  dass zumindest eines der Worte im EPG-Eintrag enthalten
             ist.

         Exakt
             Vergleicht den gesamten Suchbegriff mit dem EPG-Eintrag.  Dies  ist
             vor allem praktisch bei kurzen Titeln, wie etwa "Alf".

         Regulärer Ausdruck
             Erlaubt  die  Angabe  eines  regulären  Ausdrucks  zur  Suche.  Um‐
             schließende Schrägstriche ('/') sind nicht erforderlich.

             Wenn im Makefile des Plugins (was standardmäßig der Fall  ist)  die
             automatische  Konfiguration aktiviert ist (kein '#' vor 'AUTOCONFIG
             = 1'), werden bevorzugt Perl-kompatible reguläre  Ausdrücke  (PCRE)
             verwendet;  dies  erfordert, dass libpcre oder libpcre2 installiert
             wurden.  Alternativ werden POSIX-konforme, erweiterte reguläre Aus‐
             drücke genutzt, die auch näherungsweise Vergleiche  erlauben;  dies
             erfordert die Bibliothek libtre.

             Ohne  automatische  Konfiguration  muss  im  Makefile  des  Plugins
             lediglich '#REGEXLIB = pcre2' in 'REGEXLIB = pcre2'  geändert,  die
             gewünschte  Bibliothek  für  reguläre  Ausdrücke eingesetzt und das
             Plugin neu kompiliert werden. Die benötigte Bibliothek muss  vorher
             gegebenenfalls  mit  Hilfe der Paketverwaltung des Systems noch in‐
             stalliert.

         Unscharf
             Vergleicht den Suchbegriff anhand des Levenshtein-Distanz-Algorith‐
             mus.  Der Wert 'Toleranz' legt fest, wie groß die  Abweichung  sein
             darf.

         Eine Beschreibung des Suchprozesses findet sich in epgsearch(4).

     Inhaltskennungen verwenden
         Einige  Provider  liefern  Kennungen  für den Inhalt einer Sendung, wie
         etwa 'Film/Drama', 'Sport' und dergleichen. Solche Kennungen können  ab
         VDR   1.7.11   zur   Suche  ausgewählt  werden.  Dabei  ist  auch  eine
         Mehrfachauswahl möglich, wobei die Art  der  Übereinstimmung  für  jede
         Suche individuell einstellbar ist.

         Standardmäßig   müssen   alle   ausgewählten  Kennungen  übereinstimmen
         (UND-Verknüpfung); doch kann auch festgelegt werden,  dass  schon  eine
         einzige  Übereinstimmung  genügt  (ODER-Verknüpfung).  Da  ähnliche In‐
         haltskennungen in Gruppen gegliedert sind, lässt sich  alternativ  fes‐
         tlegen,  dass mindestens eine Übereinstimmung in jeder genutzten Gruppe
         vorliegen muss (ODER-Verknüpfung innerhalb einer  Gruppe,  UND-Verknüp‐
         fung zwischen den Gruppen).

         Besondere   Merkmale  von  Sendungen  (wie  etwa  Originalsprache  oder
         schwarzweiß) werden zudem in einer von diesem Ähnlichkeitsschema  abwe‐
         ichenden  Gruppe  von  Inhaltskennungen geführt. Für diese Gruppe lässt
         sich getrennt  festlegen,  ob  standardmäßig  alle  gewählten  Merkmale
         übereinstimmen   müssen   (UND-Verknüpfung)   oder   nur   eines  davon
         (ODER-Verknüpfung).

     Erweiterte EPG-Informationen verwenden
         Diese Option ist nur  verfügbar,  sofern  erweiterte  EPG-Informationen
         konfiguriert  wurden;  siehe  'Erweiterter EPG-Informationen verwenden'
         weiter unten.

     Art der Übereinstimmung
         Standardmäßig müssen alle gewählten Kategorien im  EPG  enthalten  sein
         und den angegebenen Werten entsprechen. Wenn 'alle außer fehlende Kate‐
         gorien'  gewählt  ist,  verhindert  dies,  dass  eine  Sendung  aus dem
         Suchergebnis ausgeschlossen wird, nur weil eine gewählte  Kategorie  im
         EPG  nicht  vorhanden  ist.  Alternativ kann per 'mindestens eine Kate‐
         gorie' festlegt werden, dass schon die Übereinstimmung  einer  einzigen
         Kategorie ausreichend soll.

         Vorsicht:  Ohne weiter eingrenzende Suchkriterien können die beiden al‐
         ternativen Einstellungen zu einer Flut von Timern führen.

     Kanal verwenden
         Sucht nur im angegebenen  Kanalbereich,  der  hinterlegten  Kanalgruppe
         oder in frei empfangbaren Sendern (FTA-Sender).

         Kanalgruppen,  wie  etwa  Sportsender oder Pay-TV-Kanäle, können anhand
         eines Untermenüs erstellt und verwaltet werden, das mittels  der  Taste
         'Blau' aufgerufen wird.

         Achtung:  Nach einer Änderung der Kanalreihenfolge sollten die Bereich‐
         seinstellungen von Suchtimern unbedingt kontrolliert werden!

     Wochentag verwenden
         Neben einzelnen Wochentagen kann auch eine  benutzerdefinierte  Auswahl
         getroffen werden, um etwa nur montags und freitags zu suchen.

         Die  benutzerdefinierte  Auswahl  findet  sich  am  Ende  der Liste der
         Wochentage ('So.', 'Mo.', ..., 'Sa.', benutzerdefiniert) und kann  über
         die Taste 'Rot' bearbeitet werden.

     Ausschlusslisten verwenden
         Ausschlusslisten  können  benutzt  werden,  um  unerwünschte  Sendungen
         auszuschließen.  Hier können entweder nur globale  bzw.  eine,  mehrere
         oder  alle  Ausschlusslisten  selektiert werden. Falls ein Suchergebnis
         auch in einer der gewählten Ausschlusslisten erscheint, wird es verwor‐
         fen.

     Im Favoriten-Menü verwenden
         Nur verfügbar, wenn im Setup aktiviert. Mit  dieser  Option  kann  eine
         Suche zur Verwendung im Favoritenmenü markiert werden. Dieses Menü lis‐
         tet alle Suchergebnisse von Suchen mit dieser Option.

     Layout des Ergebnis-Menü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.

     Als Suchtimer verwenden
         Falls  'ja',  sucht  das Plugin im Hintergrund nach passenden Sendungen
         und erzeugt  für  jede  gefundene  einen  Timer  (im  Setup  muss  dazu
         'Suchtimer   verwenden'  aktiviert  sein).  Bei  der  Einstellung  'be‐
         nutzerdefiniert' lässt sich über die Taste 'Blau' ein Zeitfenster  ein‐
         stellen, in dem der Suchtimer aktiv sein soll.

     Aktion
         Die  Standardaktion ist 'aufnehmen', also das Erzeugen eines Timers für
         jedes Suchergebnis.  Man  kann  aber  auch  festlegen,  dass  nur  eine
         Ankündigung  der  Sendung per OSD vorgenommen werden soll, sobald diese
         gefunden wird.  Eine weitere Möglichkeit ist  'nur  umschalten',  womit
         automatisch  eine Minute vor Beginn der Sendung auf deren Kanal gewech‐
         selt wird. Ebenso kann mit 'ankündigen und umschalten' die Sendung  vor
         ihrem  Beginn  angekündigt  werden und mit der Taste 'OK' daraufhin zum
         entsprechenden Kanal gewechselt werden.   Weitere  Aktionen  sind  'per
         E-Mail ankündigen' und 'inaktive Aufnahme'.

     Serienaufnahme
         Falls 'ja', werden die Aufzeichnungen in einem Ordner mit dem Titel als
         Serienname  gespeichert,  wobei  der Untertitel als Episodenname dient.
         Falls ein Untertitel fehlt, werden ersatzweise Datum  und  Uhrzeit  der
         Sendung als Episodenname verwendet.

     Verzeichnis
         Hier  kann  man ein Verzeichnis angeben, in dem die Aufzeichnung gespe‐
         ichert wird, wie etwa 'SciFi'. Mit der Taste 'Blau' kann ein  Verzeich‐
         nis  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. Sie enthält jeweils ein Verzeich‐
         nis pro Zeile ohne den vorausgehenden  Pfad  des  Video-Verzeichnisses;
         siehe auch epgsearch(4).

         Wenn man erweiterte EPG-Informationen von einem Provider erhält, können
         im  Verzeichnis-Eintrag  auch Variablen wie '%Genre%' oder '%Category%'
         verwendet werden. Diese werden durch die vorgefundenen erweiterten EPG-
         Informationen ersetzt, sobald ein Timer erzeugt wird.

         Siehe  auch  "Verwendung  von  Variablen  im  Verzeichniseintrag  eines
         Suchtimers" in epgsearch(4).

     Aufzeichnungen nach ... Tagen löschen
         Manche  Aufzeichnungen  sollen  nur  ein paar Tage existieren, wie etwa
         Nachrichten.  Mit diesem Feature kann man EPGSearch anweisen,  dass  es
         die  Aufzeichnungen  automatisch  nach  einer bestimmten Zahl von Tagen
         löschen soll.

     Pause, wenn ... Aufzeichnungen existieren
         Wenn die  angegebene  Anzahl  von  Aufzeichnungen  existiert,  pausiert
         EPGSearch  mit  dem  Erzeugen neuer Timer. Erst nach Löschen einer oder
         mehrerer  dieser  Aufzeichnungen  wird  wieder  nach  neuen   Sendungen
         gesucht.

     Wiederholungen vermeiden
         Wenn  man  keine Wiederholungen aufnehmen will, versucht dieses Feature
         festzustellen, ob eine Sendung bereits programmiert oder  aufgezeichnet
         wurde und überspringt diese dann. Bitte vor Verwendung weiter unten den
         Abschnitt "Wiederholungen vermeiden im Detail" lesen.

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

     Nur innerhalb von ... Tagen
         Falls  Wiederholungen nur innerhalb einer anzugebenden Anzahl von Tagen
         erlaubt werden sollen, kann dies hier eingestellt werden.  Der  Wert  0
         entspricht einer unbegrenzten Anzahl von Aufnahmen.

     Titel vergleichen
         Legt  fest, ob beim Test, ob eine Sendung identisch ist, der Titel ver‐
         glichen werden soll.

     Untertitel vergleichen
         Legt fest, ob beim Test, ob eine Sendung identisch ist, auch der Unter‐
         titel verglichen werden soll. Bei 'ja' stuft EPGSearch  zwei  Sendungen
         nur  dann  als identisch ein, wenn die Untertitel gleich sind und nicht
         leer.

         Bei 'falls vorhanden' können Sendungen auch identisch sein, wenn  beide
         Untertitel   leer   sind.  Im  Normalfall  sollte  dann  besser  'nein'
         eingestellt werden.

     Beschreibung vergleichen
         Legt fest, ob beim Test, ob eine Sendung identisch ist,  auch  die  In‐
         haltsbeschreibung verglichen werden soll.

         Zum  Vergleich  zweier Inhaltsbeschreibungen werden zunächst alle Teile
         aus den Inhalten entfernt, die Kategorienangaben gleichen könnten;  die
         verbleibenden  Texte werden dann miteinander verglichen. Genügt der an‐
         hand  des  Levenshtein-Distanz-Algorithmus  ermittelte  Prozentsatz  an
         Übereinstimmung  dem  in  der folgenden Option angegebenen Wert, werden
         die Beschreibungen als gleich betrachtet.

     Minimale Übereinstimmung in %
         Die notwendige Übereinstimmung zweier Inhaltsbeschreibungen in Prozent.

     Zeitpunkt vergleichen
         Manchmal wird eine Sendung häufig innerhalb einer  gewissen  Zeitspanne
         (Tag,  Woche,  Monat  usw.)  wiederholt,  ohne  dass sich die einzelnen
         Sendungen anhand des EPG-Inhalts unterscheiden  lassen.  Die  Sendezeit
         ist  somit  die  einzig verwertbare Information. Für den Vergleich kann
         hier die entsprechende Zeitspanne auswählt werden, um die  Wiederholun‐
         gen zu ignorieren.

     Kategorien vergleichen
         Über die Schaltfläche 'Einstellungen' kann angegeben werden, welche der
         erweiterten  EPG-Kategorien  ebenfalls  miteinander  verglichen  werden
         sollen.  Wie schon bei den Untertiteln gilt  eine  Sendung  als  unter‐
         schiedlich, wenn sie keine entsprechende Kategorie aufweist.

     Priorität, Lebensdauer, Vor- und Nachlauf
         Jeder  Suchtimer  kann  für diese Parameter eigene Einstellungen haben.
         Die Voreinstellung wird im Setup vorgenommen.

     VPS verwenden
         Nutzt VPS, falls im VDR-Setup aktiv und die gefundene Sendung über VPS-
         Daten verfügt.

     Automatisch löschen
         Zum automatischen Löschen eines Suchtimers anhand  folgender  Bedingun‐
         gen:

         • nach ... Aufnahmen

         • nach ... Tagen nach der ersten Aufnahme

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

     Um den Status 'Als Suchtimer verwenden' zu ändern, ohne das Menü zu öffnen,
     kann die Taste 2 verwendet werden. Dies ruft direkt den zweiten  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' und 'Nächste'
     Im  Setup  können bis zu vier zusätzliche Zeiten als Erweiterung zu 'Jetzt'
     und 'Nächste' angegeben werden, um die Auswahl für die Taste 'Grün' zu  er‐
     weitern,  beispielsweise  'Nachmittag',  'Abend' oder 'Nacht'. Bereits ver‐
     strichene Zeiten werden übersprungen, sodass man etwa am Abend kein  'Nach‐
     mittag'  mehr angeboten bekommt. Liegt aber ein Zeitpunkt nicht mehr als 20
     Stunden in der Zukunft, wird das Menü des nächsten Tages angezeigt.

     In diesem Menü kann die aktuell angezeigte Zeit durch  Drücken  auf  'FRew'
     und 'FFwd' nach hinten oder vorne verschoben werden. Falls diese Tasten auf
     der  Fernbedienung nicht existieren, kann die 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.

     Zudem  lässt  sich ein Fortschrittsbalken ins Menü 'Jetzt' / 'Nächste' ein‐
     blenden.

     Des Weiteren kann in den Einstellungen ein Favoriten-Menü zugeschaltet wer‐
     den.  Für eine Suche lässt sich mittels 'Im Favoriten-Menü verwenden' fest‐
     gelegen, dass die Suchergebnisse dort  angezeigt  werden  sollen.  Das  Fa‐
     voriten-Menü  zeigt  Sendungen  der  (standardmäßig) nächsten 24 Stunden in
     chronologischer Reihenfolge.

   1.4 Menü 'Einstellungen'
     1.4.1 Allgemein

     Hauptmenü-Eintrag verbergen
         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ü aufgerufen wird. Siehe
         unten, wie sich das vermeiden lässt.

     Hauptmenü-Eintrag
         Falls  nicht  ausgeblendet,  kann  hier der Name des Hauptmenü-Eintrags
         hinterlegt werden. Vorgabe ist 'Programmführer'.

         Hinweis: Wenn der Name von der Standardeinstellung  abweicht,  ist  der
         Hauptmenü-Eintrag  nicht  mehr mit der gewählten OSD-Sprache verknüpft.
         Setzt man den Namen aber wieder auf die Standardeinstellung zurück oder
         löscht ihn, ist die Verknüpfung mit der OSD-Sprache wieder gegeben.

     Starte mit
         Auswahl von 'Programm' oder 'Jetzt' als Startmenü.

     1.4.2 EPG-Menüs

     Taste 'OK'
         Hier kann das Verhalten der Taste  'OK'  festgelegt  werden.  Man  kann
         damit  die  Inhaltsangabe anzeigen oder zum entsprechenden Sender wech‐
         seln.

         Hinweis: Die Funktion  der  Taste  'Blau'  ('Umschalten',  'Info'  oder
         'Suche') hängt von dieser Einstellung ab.

     Taste 'Rot'
         Legt  fest, ob man 'Aufnehmen' (Standardeinstellung) oder 'Befehle' als
         Vorbelegung möchte.

     Taste 'Blau'
         Legt fest, ob man 'Umschalten' (Standardeinstellung) oder  'Suche'  als
         Vorbelegung möchte.

     Fortschritt in 'Jetzt' anzeigen
         Im  Menü  'Jetzt'  kann ein Fortschrittsbalken eingeblendet werden, der
         die bereits verstrichene Zeit der laufenden Sendung anzeigt.

     Kanalnummern anzeigen
         Auswählen,  um  eine  führende  Kanalnummer   vor   jedem   EPG-Eintrag
         anzuzeigen.

     Kanaltrennlinien anzeigen
         Zur Anzeige einer Trennzeile zwischen Kanalgruppen im Menü 'Übersicht -
         Jetzt' und den anderen Menüs von Programmübersichten.

     Tagestrennlinien anzeigen
         Zur  Anzeige einer Trennzeile zwischen Sendungen unterschiedlicher Tage
         im Menü 'Programm'.

     Radiokanäle anzeigen
         Erlaubt die Anzeige von Radiokanälen.

     Kanäle begrenzen von 1 bis
         Bei einer sehr großen Kanalliste lässt sich der Menüaufbau  mit  dieser
         Einstellung durch eine Einschränkung der angezeigten Kanäle beschleuni‐
         gen.  Mit 0 wird das Limit aufgehoben. Wenn der aktuelle Kanal über dem
         Limit liegt, wird  das  Limit  ignoriert,  sodass  wieder  alle  Kanäle
         angezeigt werden.

     Timer mit 'Aufnehmen' sofort anlegen
         Falls 'ja', wird nach Drücken von 'Aufnahme' sofort ein Timer angelegt.
         Andernfalls erscheint stattdessen das Timer-Editieren-Menü.

     Kanäle ohne EPG anzeigen
         Zur Anzeige von Programmen ohne EPG, um auf diese umschalten oder einen
         Timer programmieren zu können.

     Zeitintervall für 'FRew' / 'FFwd' [min]
         In   den   Menüs   'Jetzt'  und  'Nächste'  sowie  den  Menüs  mit  be‐
         nutzerdefinierten Zeiten kann der angezeigte  Zeitpunkt  durch  drücken
         von  'FRew'  bzw.  'FFwd' verschoben werden. Die Sprungweite in Minuten
         kann hier festgelegt werden.

     Tasten 'Grün' / 'Gelb' umschalten
         Auf 'ja' setzen, falls die Tasten 'FRew' bzw. 'FFwd' auf der  Fernbedi‐
         enung  nicht  vorhanden sind. In entsprechenden Menüs werden damit nach
         Drücken der Taste 0 die Tasten 'Grün'  und  'Gelb'  beispielsweise  auf
         '<<' und '>>' umgeschaltet.

     Favoriten-Menü anzeigen
         Das   Favoriten-Menü   kann  dazu  verwendet  werden,  eine  Liste  von
         bevorzugten Sendungen anzuzeigen, die innerhalb  der  nächsten  Stunden
         laufen.  Je  nach  Einstellung  erscheint dieses Menü vor oder nach den
         EPG-Menüs mit benutzerdefinierten Zeiten.  Die  Auswahl  von  Sendungen
         wird  durch  Setzen  der Option 'Im Favoriten-Menü verwenden' innerhalb
         einer Suche vorgenommen.

     für die nächsten ... Stunden
         Mit diesem Wert wird die  Zeitspanne  eingestellt,  für  die  Favoriten
         angezeigt werden sollen.

     1.4.3 Benutzerdefinierte EPG-Zeiten

     Benutzerdefinierte Zeit 1..4 verwenden
         Bis  zu  vier benutzerdefinierte Zeiten können zu 'Jetzt' und 'Nächste'
         hinzugefügt werden.

     Beschreibung
         Name der benutzerdefinierten  Zeit,  etwa  'Nachmittag',  'Abend'  oder
         'Nacht'.

     ZeitUhrzeit, ab der die benutzerdefinierte Zeitspanne beginnt.

     1.4.4 Timer-Programmierung

     Timer-Editieren-Menü des VDR verwenden
         Beim  normalen  Programmieren  eines Timers verwendet EPGSearch ein er‐
         weitertes  Timer-Editieren-Menü,  das  einen  Verzeichniseintrag,   be‐
         nutzerdefinierte Wochentage und die Vervollständigung um Untertitel an‐
         bietet. Falls man einen gepatchten VDR verwendet, der ebenfalls ein er‐
         weitertes  Timer-Editieren-Menü-Menü anbietet und lieber dieses verwen‐
         den möchte, dann diese Option auf 'ja' setzen.

     Standard-Aufnahmeverzeichnis
         Dieser Eintrag wird beim normalen Programmieren eines Timers verwendet.
         Die Nutzung von EPG-Variablen ist ebenfalls möglich, etwa 'Filme~%Cate‐
         gory%~%Genre%'.  Wird  das  Timer-Editieren-Menü  aufgerufen,  versucht
         EPGSearch,  alle  Variablen  durch  die  Werte aus 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 Dateinamen
         automatisch  um den Untertitel ergänzen. Dies bewirkt, dass die spätere
         Aufnahme in einem nach dem Titel benannten "Serienverzeichnis" mit  dem
         Untertitel als Episodenname gespeichert wird.

         Hier  legt man fest, ob bzw. wie die Ergänzung erfolgen soll: 'intelli‐
         gent' versucht anhand der Länge einer Sendung festzustellen, ob ein Un‐
         tertitel als Episodenname sinnvoll ist. Ist die Sendung länger  als  80
         Minuten, wird kein Episodenname 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  hinter‐
         legt werden. Folgende Prüfmethoden existieren:

         Ohne Überwachung


         Anhand Sendungskennung
             Geprüft  wird  anhand  einer Kennung, die durch den Sender vergeben
             wird.

         Anhand Sender/Uhrzeit
             Geprüft wird anhand der Sendung, die am besten zur  Dauer  der  ur‐
             sprünglichen Sendung passt.

         Nicht  alle  Sender  liefern  eine vernünftige Sendungskennung. Deshalb
         kann hier die Standardeinstellung für jeden Kanal einzeln gesetzt  wer‐
         den.  Bei  der  Programmierung  eines  manuellen  Timers  wird diese im
         Timer-Editieren-Menü vorgegeben, falls das Menü von  EPGSearch  benutzt
         wird.

     1.4.5 Suche und Suchtimer

     Suchtimer verwenden
         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 Default-
         Host für Aufnahmen definiert ist.

     Aktualisierungsintervall
         Das Intervall in Minuten, in dem die Hintergrundsuche vorgenommen wird.

     SVDRP-Port
         Falls nicht der Standard-SVDRP-Port 6419 (Port  2001  vor  VDR  1.7.15)
         verwendet wird, bitte hier anpassen, damit die Suchtimer funktionieren.

     Verzögerung der internen Threads
         Der  Start  des Suchtimer-Update-Threads und der folgenden Konfliktprü‐
         fung kann um 0..300 Sekunden ab 'VDR Ready' verzögert werden. Standard‐
         mäßig sind dies 10 Sekunden.

     Priorität, Lebensdauer, Vorlauf und Nachlauf
         Legen die entsprechenden Voreinstellungen für  neu  erzeugte  Suchtimer
         fest.

     Erlaubte Aufnahmefehler
         Erlaubte   Fehler  in  einer  Aufnahme,  bevor  sie  als  unvollständig
         gekennzeichnet wird (verfügbar seit VDR 2.5.4)

     Ankündigungen bei Wiedergabe unterdrücken
         Zum  Unterdrücken  von  Sendungsankündigungen  während  einer   aktiven
         Wiedergabe.

     Timer nach Löschen neu programmieren
         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.

     Prüfen, ob EPG für ... Stunden existiert
         Falls das EPG von externen Anbietern bezogen wird, kann  es  vorkommen,
         dass  der  Abruf  fehlschlägt  und somit Aufzeichnungen wegen fehlender
         EPG-Daten verlorengehen.  Hiermit  kann  geprüft  werden,  ob  für  die
         vorgegebene  Zahl  von  Stunden  bei  den  gewünschten  Sendern ein EPG
         vorhanden ist. Ein Wert von 0 deaktiviert die Prüfung.

     Per OSD warnen
         Falls 'ja', erscheint die Warnung als OSD-Einblendung.

     Per E-Mail warnen
         Falls ja, wird die Warnung  per  E-Mail  versandt.  Hierfür  bitte  das
         E-Mail-Konto unter 'E-Mail-Benachrichtigung' konfigurieren.

     Zeitbegrenzung für Timer [t]
         Begrenzt die Erzeugung von Timern auf einen Zeitraum in Tagen. Ein Wert
         von 0 deaktiviert die Begrenzung.

     Zu prüfende Kanalgruppe
         Hier  die  Kanalgruppe  auswählen,  für welche die Prüfung durchgeführt
         werden soll. Diese gegebenenfalls zuvor unter 'Kanalgruppen' anlegen.

     PayTV-Sender ignorieren
         Auf 'ja' setzen, wenn der Suche nach Wiederholungen keine Sendungen von
         PayTV-Sendern gewünscht sind.

     Suchvorlagen
         Hier können Suchvorlagen  verwaltet  werden,  die  beim  Anlegen  neuer
         Suchen und Suchtimer verwendbar sind.

     Ausschlusslisten
         Hier  können  Ausschlusslisten verwaltet 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
         verwenden'  auf  'nur  globale'  steht,  lassen sich damit unerwünschte
         Sendungen von allen Suchtimern unkompliziert ausschließen.

         Ausnahme: Falls bei einem Suchtimer  für  'Ausschlusslisten  verwenden'
         die  Option 'keine' gewählt ist, hat eine globale Ausschlussliste keine
         Auswirkung. Ebenso werden globale Ausschlusslisten bei der  Suche  nach
         Wiederholungen über das OSD ignoriert.

     Kanalgruppen
         Verwaltet  die  Kanalgruppen, die als Suchkriterium in einer Suche ver‐
         wendet werden können. Die Verwaltung ist auch im  Editieren-Menü  einer
         Suche möglich.

     Wichtig:  Wenn  die  EPG-Daten  von  einer  externen Quelle bezogen werden,
     sollte dafür gesorgt werden, dass die Suchtimer-Updates während des EPG-Up‐
     dates abgeschaltet sind. Der Grund hierfür ist, dass EPGSearch  alle  Timer
     löscht,  denen  keine  Sendungen  zugeordnet  sind.  Diese  Situation  kann
     auftreten, solange die neuen EPG-Daten vom VDR eingelesen werden.

     Die Abschaltung der Updates geht am einfachsten mit dem SVDRP-Befehl 'SETS'
     im EPG-Update-Skript:

         svdrpsend PLUG epgsearch SETS off
         epg-updates-laden
         svdrpsend PLUG epgsearch SETS on

     1.4.6 Timer-Konfliktprüfung

     Priorität kleiner als ... ignorieren
         Falls  ein  Timer  fehlschlagen  sollte,  dessen  Priorität  unter  dem
         angegebenen Wert liegt, wird darauf nicht per OSD-Nachricht hingewiesen
         und   der   Konflikt  wird  als  irrelevant  in  der  Konfliktübersicht
         angezeigt.

     Konfliktdauer unter ... Minuten ignorieren
         Falls ein Konflikt nicht länger als die  angegebene  Zahl  von  Minuten
         dauert,  wird  darauf  nicht per OSD-Nachricht hingewiesen und der Kon‐
         flikt wird als irrelevant in der Konfliktübersicht angezeigt.

     Nur die nächsten ... Tage prüfen
         Hier kann der Zeitraum für die Konfliktprüfung angegeben werden.

     Konflikte auch für Remote-Timer prüfen
         Falls SVDRP-Peering aktiv ist und 'ja' gewählt ist,  werden  auch  Kon‐
         flikte bei Remote-Timern überprüft. Dazu muss am entsprechenden Remote-
         Rechner  das  Plugin  EGPSearch  ebenfalls  aktiviert sein. Default ist
         'nein'.

     Nach jeder Timer-Programmierung
         Dies bewirkt eine Konfliktprüfung nach jeder  manuellen  Timer-Program‐
         mierung  und  erzeugt eine OSD-Nachricht, falls der neue bzw. geänderte
         Timer in einen Konflikt involviert ist.

     Beim Beginn einer Aufnahme
         Auf 'ja' setzen, wenn die Konfliktprüfung beim Beginn einer jeden  Auf‐
         nahme  erfolgen  soll.  Im  Falle eines Konflikts wird dann sofort eine
         OSD-Meldung angezeigt. Diese erscheint aber nur, wenn der Konflikt  in‐
         nerhalb der nächsten zwei Stunden auftritt.

     Nach jedem Suchtimer-Update
         Hier  kann  eingestellt  werden,  ob  eine  Konfliktprüfung  nach jedem
         Suchtimer-Update erfolgen soll.  Andernfalls  greifen  die  nachfolgend
         beschriebenen Einstellungen.

     Alle ... Minuten
         Gibt an, in welchem Intervall im Hintergrund eine automatische Konflik‐
         tprüfung  erfolgen  soll.  Bei  relevanten  Konflikten erfolgt eine Be‐
         nachrichtigung per OSD. Mit 0 wird diese Funktion deaktiviert.

     Wenn nächster Konflikt in ... Minuten
         Wenn ein Konflikt in der angegebenen Zahl von  Minuten  eintritt,  soll
         das nachfolgend angegebene Prüfintervall verwendet werden.

         Alle ... Minuten
             Um einen kurz bevorstehenden Konflikt nicht zu übersehen, kann hier
             ein kürzeres Prüfintervall eingestellt werden.

     Nachricht bei Wiedergabe vermeiden
         Bitte  auf  'ja'  setzen,  wenn  während einer Wiedergabe keine OSD-Be‐
         nachrichtigungen über Timer-Konflikte gewünscht sind. Die Benachrichti‐
         gung erfolgt trotzdem, wenn der nächste Konflikt innerhalb der nächsten
         zwei Stunden auftritt.

     Bitte ebenfalls den Abschnitt "Working with  the  timer-conflict  menu"  in
     epgsearch(4) berücksichtigen.

     1.4.7 E-Mail-Benachrichtigung

     Hierzu  bitte  sicherstellen,  dass  sendEmail.pl  in einem Verzeichnis von
     $PATH liegt und epgsearchupdmail.templ und epgsearchconflmail.templ im Kon‐
     figurationsverzeichnis von EPGSearch vorliegen.

     Suchtimer-Benachrichtigung
         Diese Option aktivieren, wenn  eine  E-Mail-Benachrichtigung  gewünscht
         wird, 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 Be‐
         nutzeraktionen nicht mehr gültig sind.

         Hierfür  muss  ebenfalls die Option 'Suchtimer verwenden' im Suchtimer-
         Setup aktiv sein.

     Zeit zwischen E-Mails [h]
         Für  Benachrichtigungen  zu  Suchtimern  kann  hier  angegeben  werden,
         welchen  Mindestabstand in Stunden die E-Mails haben sollen. Sobald die
         entsprechende Zeit verstrichen ist, wird eine E-Mail nach dem  nächsten
         Suchtimer-Update  versandt. Der Wert 0 bewirkt einen sofortigen E-Mail-
         Versand.

     Timer-Konflikt-Benachrichtigung
         Diese Option aktivieren, wenn eine E-Mail-Benachrichtigung  bei  Timer-
         Konflikten  gewünscht wird. Es werden nur Konflikte gemeldet, die gemäß
         den Einstellungen zur Timer-Konfliktprüfung  relevant  sind.  Neue  Be‐
         nachrichtigungen  werden nur versandt, wenn sich bei den Konflikten Ve‐
         ränderungen ergeben haben.

         Hinweis: Hierfür muss in den  Einstellungen  der  Timer-Konfliktprüfung
         die  Option  'Nach jedem Suchtimer-Update' oder 'alle ... Minuten'  ak‐
         tiviert sein.

     Senden an
         Hier die vollständige (!) E-Mail-Adresse  hinterlegen,  an  welche  die
         Nachrichten versandt werden sollen.

         Hinweis:  Einige  Provider  (wie etwa Arcor) erlauben keine identischen
         E-Mail-Adressen für Sender und Empfänger.

     E-Mail-Versandmethode
         Zur Auswahl stehen:

         sendEmail.pl
             Ein einfaches Skript, das auch  auf  Systemen  ohne  konfigurierten
             Mailserver  den  Versand  von  E-Mails erlaubt. Das Skript wird mit
             EPGSearch ausgeliefert und sollte in einem  Verzeichnis  von  $PATH
             liegen.

         sendmail
             Setzt ein korrekt aufgesetztes Mailsystem voraus.

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

     SMTP-Server
         Der Name des SMTP-Servers, über den der E-Mail-Versand erfolgen soll.

     SMTP-Authentifizierung verwenden
         Bitte 'ja' wählen, wenn das  E-Mail-Konto  eine  SMTP-Authentifizierung
         für den E-Mail-Versand benötigt.

     Benutzername
         Hier  bitte  den Benutzernamen angeben, falls das E-Mail-Konto eine Au‐
         thentifizierung erfordert.

     Passwort
         Hier bitte das Passwort angeben, falls das  E-Mail-Konto  eine  Authen‐
         tifizierung erfordert.

         Achtung:  Das  Passwort  wird  im Klartext gespeichert. Es liegt in der
         eigenen Verantwortung, dafür Sorge zu tragen, dass  das  System  sicher
         ist  und  dass unautorisierten Personen kein Zugriff auf VDR-Konfigura‐
         tionsdateien möglich ist.

     Nach Eingabe der E-Mail-Kontoeinstellungen bitte mittels 'Test' prüfen,  ob
     alles  funktioniert.  Wenn mit sendEmail.pl gearbeitet wird, sollte am Ende
     der Testausgabe etwas wie 'Email sent successfully' erscheinen. Eine  Test‐
     funktion gibt es für 'sendmail' leider nicht.

     Bitte  ebenfalls  den  Abschnitt  'E-mail  notifications'  in  epgsearch(4)
     berücksichtigen.

2. Suchtimer
     Die Suchtimer entsprechen in etwa den Autotimern  von  VDRAdmin,  benötigen
     jedoch kein externes Programm. Beim Anlegen einer Suche kann man festlegen,
     ob diese als Suchtimer verwendet werden soll. Das Plugin sucht dann im Hin‐
     tergrund  in  bestimmten  Zeitabständen  (siehe 'Aktualisierungsintervall')
     nach passenden Sendungen und erzeugt Timer für  die  gefundenen  Sendungen.
     Sollen  keine  Timer  angelegt,  sondern die Sendungen nur gemeldet werden,
     dann bitte 'per OSD ankündigen' einstellen.

     Gerade für Serien ist dies sehr praktisch, weshalb es in der Suche die  Op‐
     tion  'Serienaufnahme' gibt. In diesem Fall wird ein Timer mit zusätzlichem
     Episodennamen angelegt. Die Aufnahme wird dann in einem  Ordner  mit  Titel
     als  Seriennamen  gespeichert, wobei der Untertitel als Episodenname dient.
     Falls ein Untertitel  fehlt,  werden  ersatzweise  Datum  und  Uhrzeit  der
     Sendung als Episodenname verwendet.

     Die  Suchtimer-Funktion  muss außerdem im Setup aktiviert werden. Falls für
     SVDRP nicht der Standardport verwendet wird,  den  gewünschten  Port  bitte
     ebenfalls im Setup eintragen.

     Um eine Hintergrund-Suche manuell anzustoßen, genügt die Ausführung von:

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

     Diese  Anweisung kann ebenfalls Teil des shutdown-Skripts sein. Dort sollte
     man dann aber noch eine Verzögerung von ein paar Sekunden  vorsehen,  damit
     das Plugin ausreichend Zeit hat, den Scan zu beenden.

     Mehr  Infos zu Suchtimern finden sich in epgsearch(4) unter "Description of
     the search process" und "How do Search Timers work?".

   2.1 Wiederholungen vermeiden im Detail
     Nicht immer lässt sich durch entsprechende  Suchkriterien  vermeiden,  dass
     auch  Timer  für Wiederholungen erzeugt werden. Dieser Abschnitt erläutert,
     wie die Option 'Wiederholungen vermeiden' eines Suchtimers funktioniert.

     Um möglichst keine Duplikate von Sendungen zu erhalten, versucht  das  Fea‐
     ture  'Wiederholungen  vermeiden'  vor  dem  Programmieren einer Sendung zu
     prüfen, ob eine gleiche Sendung schon einmal aufgenommen wurde oder ob  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 zweier Sendungen?
     Für  den  Test  auf  Gleichheit  zweier  Sendungen  gibt es viele Einstell‐
     möglichkeiten bei  Suchtimern.  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  prüft die einzelnen Angaben immer auf vollständige Überein‐
     stimmung, einschließlich der Schreibweise. Die Beschreibung  einer  Sendung
     stellt jedoch eine Ausnahme dar: Hier wird zunächst alles aus dem Text eli‐
     miniert,  was eine erweiterte Kategorie darstellen könnte, wie etwa 'Bewer‐
     tung: Tagestipp'.  Eine solche erweiterte Kategorie entspricht einer Zeile,
     die mit bis zu 40 Zeichen beginnt, von einem ':' gefolgt wird und dann max‐
     imal weitere 60 Zeichen umfasst. Hintergrund für diese Filterung  sind  oft
     vorhandene  Bewertungen  wie 'Tagestipp', die bei der Wiederholung vielfach
     aber nicht mehr enthalten sind.

     Der verbleibende Text wird nun zunächst in der Länge  verglichen.  Ist  der
     Unterschied  größer  als  90  Prozent,  wird  die  Beschreibung  als unter‐
     schiedlich gewertet. Andernfalls erfolgt eine Prüfung per  Levenshtein-Dis‐
     tanz-Algorithmus   (LD),  der  einen  Fuzzy-Textvergleich  durchführt.  Die
     Beschreibung wird als gleich akzeptiert, wenn LD eine  Übereinstimmung  von
     mehr als 90 Prozent meldet.

     Da  dieser  Algorithmus  ziemlich laufzeitintensiv ist (Komplexität O(mn)),
     sollte nach Möglichkeit nicht nur 'Beschreibung vergleichen'  als  einziges
     Vergleichskriterium  ausgewählt werden, sondern am besten immer nur in Kom‐
     bination mit anderen Kriterien.

   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 ob in der Timer-Liste ein Timer vorhanden ist, der
     die  gleiche  Sendung  aufzeichnen  würde.   Nach jeder Aufnahme, die durch
     einen Suchtimer mit 'Wiederholungen vermeiden' erzeugt wurde,  werden  alle
     Angaben zu dieser Sendung der Datei epgsearchdone.data gespeichert. Mittels
     'Erledigte Aufnahmen anzeigen' in den 'Aktionen' des Menüs 'Suche' kann man
     sich alle Sendungen, die ein solcher Timer bisher aufgenommen hat, anzeigen
     lassen  und  diese auch bearbeiten. In die Datei fließen nur Aufnahmen ein,
     die bezüglich der Timer-Angaben korrekt begonnen  haben  und  auch  beendet
     wurden.  Das  heißt, dass unvollständige Aufnahmen nicht registriert werden
     und somit beim nächsten Suchtimer-Update automatisch ein  neuer  Timer  für
     diese Sendung erzeugt wird, falls eine Wiederholung gefunden wurde.

     Seit  VDR 2.5.4 werden auch Aufnahmen mit Fehlern nicht registriert. Möchte
     man eine bestimmte Anzahl von Aufnahmefehlern zulassen, kann der  Wert  für
     'Erlaubte Aufnahmefehler' entsprechend gesetzt werden.

     2.3.1 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, erst einmal zu prüfen, ob er sich wie  gewünscht  verhält.
     Dazu gibt es für solche Timer im Menü 'Suchergebnisse' auf der Taste 'Blau'
     die zusätzliche Belegung 'Timer-Vorschau'. Sendungen, die noch keinen Timer
     haben  ('T'),  für  die  aber  einer  aufgrund  des  Features beim nächsten
     Suchtimer-Update programmiert werden würde, haben dort ein 'P' stehen.

     Hinweis: Möchte man aufgrund von Konflikten  einen  bereits  programmierten
     Timer  nicht  verwenden,  sollte  dieser  im Timer-Menü deaktiviert werden.
     Beim nächsten Suchtimer-Update wird dann einfach die nächstmögliche Wieder‐
     holung programmiert, falls vorhanden.

     2.3.2 Wenn es nicht richtig funktioniert

     Damit bei Verwendung dieses  Features  besser  nachvollziehbar  ist,  warum
     Timer erzeugt wurden oder warum nicht, steht für EPGSearch ein eigenes Log-
     File  zur  Verfügung.  Startet man EPGSearch mit einem Log-Level von 2 oder
     höher ('−v 2'), werden beim Suchtimer-Update  in  der  Datei  epgsearch.log
     weiterführende Informationen abgelegt. Siehe auch die Kommandozeilen-Optio‐
     nen weiter oben.

3. Verwendung der Suche durch andere Plugins oder Skripte
     Siehe epgsearch(4).

4. Verwendung erweiterter EPG-Informationen
     Einige  EPG-Provider liefern zusätzliche EPG-Informationen, wie die Art der
     Sendung, das Video- und Audio-Format, die Besetzung usw. in  der  Beschrei‐
     bung einer Sendung.

     Anmerkung:  Dies hat nichts mit den Inhaltskategorien zu tun, die gemäß DIN
     EN 300 468, Tabelle 18, als zusätzliche Daten  ausgeliefert  und  seit  VDR
     1.7.11  unterstützt werden. Leider liefern nicht alle Provider solche Daten
     bzw. setzen die Kennungen korrekt. Deshalb gibt es den Ansatz der  "erweit‐
     erten  EPG-Informationen", der versucht, diese Information aus der Inhalts‐
     beschreibung zu extrahieren.

     Mit Tools wie tvmovie2vdr oder epg4vdr können derartige EPG-Inhalte in  den
     VDR importiert werden.  Anhand solcher Daten lässt sich beispielsweise rel‐
     ativ  einfach  eine Suche erzeugen, die alle Tagestipps findet, die in 16:9
     ausgestrahlt werden.  Dazu  durchsucht  EPGSearch  die  Beschreibung  einer
     Sendung nach Zeilen, die mit den Namen von Kategorien beginnen, gefolgt von
     ':'  und  einem  Leerzeichen,  für  die im Suchtimer ein oder mehrere Werte
     festgelegt sind. Die Suche berücksichtigt Groß- und Kleinschreibung  sowohl
     bei den Kategorienamen als auch bei deren Werten.

     Um  Informationen  dieser Art in Suchtimern verwenden zu können, müssen an‐
     hand  der  Datei  epgsearchcats.conf   im   Konfigurationsverzeichnis   von
     EPGSearch entsprechende Einstellungen vorliegen.  Zeilen dieser Datei haben
     folgendes Format:

         ID|Kategorienname[,Format]|Bezeichnung im Menü|Kategorienwerte|Suchmodus

     Die einzelnen Felder einer Zeile haben folgende Bedeutung:

     1 – Eindeutige Kennung (ID)
         Integer mit einem positiven Wert.

         Achtung:  Ändert man später die Kennung, müssen die Suchtimer angepasst
         werden!

     2 – Kategoriename
         String mit dem Namen der EPG-Kategorie laut EPG-Provider, etwa 'Genre'.

         Wenn ein optionales 'Format' angegeben ist, wird der Kategoriewert  als
         Ganzzahl  interpretiert  und  gemäß der Formatangabe dargestellt (siehe
         'man printf' für anwendbare Formatangaben).

     3 – Bezeichnung im Menü
         String mit dem Namen der EPG-Kategorie in Auswahlmenüs von EPGSearch.

     4 – Kategoriewerte
         String mit einer optionalen, kommaseparierten Liste von Werten für  die
         EPG-Kategorie.

     5 – Suchmodus
         Optionale Enumeration mit den folgenden Werten:

             Textvergleich:

             0 = der gesamte Begriff muss enthalten sein
             1 = jedes Wort (durch eines der Zeichen ',;|~' getrennt) muss en‐
             thalten sein; dies ist die Standardeinstellung
             2 = mindestens ein Wort (durch eines der Zeichen ',;|~' getrennt)
             muss enthalten sein
             3 = exakte Übereinstimmung
             4 = regulärer Ausdruck

             Numerischer Vergleich:

             10 = kleiner
             11 = kleiner oder gleich
             12 = größer
             13 = größer oder gleich
             14 = gleich
             15 = ungleich

     Beispieldateien  finden  sich im Verzeichnis conf von EPGSearch. Oft genügt
     es, eine (weitgehend) passende Vorlage als epgsearchcats.conf ins  Konfigu‐
     rationsverzeichnis  des  Plugins  zu  kopieren  und gegebenenfalls ein paar
     kleinere Anpassungen vorzunehmen. Zur Nutzung der EPG-Kategorien  muss  man
     den   VDR  danach  lediglich  neu  starten  und  das  Editieren-Menü  eines
     Suchtimers aufrufen.

     Weil das Aufsetzen einer neuen epgsearchcats.conf  aber  ziemlich  mühselig
     ist,  wird  createcats  als kleines Tool mitgeliefert, das den Großteil der
     Arbeit übernimmt. Es findet sich im  Binärverzeichnis des VDR ind wird fol‐
     gendermaßen aufgerufen:

         createcats <Pfad_zu>/epg.data

     Das Tool scannt die vorhandenen EPG-Informationen und versucht, daraus  die
     erweiterten  Informationen zu extrahieren. Das Ergebnis ist eine neue Datei
     epgsearchcats.conf, die aber noch bearbeitet werden muss, weil sicher nicht
     alles genau passt. Danach muss die Datei ins Konfigurationsverzeichnis  des
     Plugins kopiert werden.

     Siehe  auch createcats(1) für weitergehende Informationen zu seiner Verwen‐
     dung.

5. Ersetzen des Standard-Programm-Menüs
     Um das Plugin als Ersatz für das über die Taste  'Grün'  aufgerufene  Stan‐
     dard-Menü 'Programm' des VDR zu verwenden, genügt es, die Zeile:

         Green @epgsearch

     in  die  Datei  keymacros.conf  einzufügen. Falls kein weiterer Menüeintrag
     'Programmführer' im Hauptmenü erscheinen soll, kann der Eintrag des Plugins
     über die Einstellungen verborgen werden.

6. Add-ons
     Mit EPGSearch werden zwei weitere Mini-Plugins ausgeliefert. Beide  Plugins
     erfordern,  dass  EPGSearch  ebenfalls installiert ist (EPGSearch kann aber
     aus dem Hauptmenü ausgeblendet werden):

     epgsearchonly
         Werden nur die Suchfunktionen bzw.  Suchtimer  von  EPGSearch  benötigt
         oder  lediglich  ein  eigener Hauptmenüeintrag für die Suche gewünscht,
         kann dies mit diesem Plugin erreicht werden. Es  erzeugt  einen  Haupt‐
         menüeintrag  'Schnellsuche',  der  direkt in das Menü 'Suche editieren'
         führt.

         Die Aktivierung erfolgt im VDR-Startskript mit '−Pepgsearchonly'.

     conflictcheckonly
         Die Timer-Konfliktprüfung kann ebenfalls als  eigener  Hauptmenüeintrag
         angelegt  werden. Über eine Option in den Einstellungen lässt sich auch
         das Ergebnis der letzten Konfliktprüfung direkt im Hauptmenü anzeigen.

         Die Aktivierung erfolgt im VDR-Startskript mit '−Pconflictcheckonly'.

DATEIEN
     epgsearch.conf
         Enthält die Suchtimer; siehe epgsearch.conf(5).

     epgsearchblacklists.conf
         Enthält die Ausschlusslisten; siehe epgsearchblacklists.conf(5).

     epgsearchcats.conf
         Enthält die Kategorien für  die  erweiterten  EPG-Informationen;  siehe
         epgsearchcats.conf(5).

     epgsearchchangrps.conf
         Enthält die Kanalgruppen; siehe epgsearchchangrps.conf(5).

     epgsearchcmds.conf
         Enthält  Befehle  ähnlich der Datei 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).

     epgsearchdone.data
         Enthält die Liste erledigter Suchtimer; siehe epgsearchdone.data(5).

     epgsearchmenu.conf
         Enthält  die  vom  Benutzer gewählte Konfiguration der OSD-Menüdarstel‐
         lung; siehe epgsearchmenu.conf(5).

     epgsearchswitchtimers.conf
         Enthält die Umschalttimer; siehe epgsearchswitchtimer.conf(5).

     epgsearchtemplates.conf
         Enthält die Vorlagen für Suchtimer; siehe epgsearchtemplates.conf(5).

     epgsearchuservars.conf
         Enthält  die  benutzerspezifischen  Variablen;   siehe   epgsearchuser‐
         vars.conf(5).

HINWEISE
     Die  ausführliche  Beschreibung  der internen Funktionen des Plugins findet
     sich in epgsearch(4).

AUTOREN (Man-Pages)
     Ursprünglich erstellt von Mike Constabel <epgsearch  (at)  constabel  (dot)
     net>.

     Überarbeitet  und  an  die aktuellen Features von EPGSearch adaptiert durch
     die derzeitigen Maintainer.

PROJEKTSEITE
     Das Plugin wird als Projekt auf GitHub geführt:

     <https://github.com/vdr-projects/vdr-plugin-epgsearch/>

FEHLER MELDEN
     Fehlerberichte sowie Feature-Anfragen können über den Bugtracker  des  Pro‐
     jekts eingespeist werden:

     <https://github.com/vdr-projects/vdr-plugin-epgsearch/issues/>

COPYRIGHT und LIZENZ
     Copyright © 2004-2010 Christian Wieninger

     Copyright © 2011-2025 TomJoad (VDR-Portal) et al.

     Dieses Programm ist freie Software. Sie können es unter den Bedingungen der
     GNU  General  Public  License,  wie von der Free Software Foundation veröf‐
     fentlicht, 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 Ih‐
     nen von Nutzen sein wird, aber OHNE IRGENDEINE GARANTIE, sogar ohne die im‐
     plizite Garantie der MARKTREIFE oder  der  VERWENDBARKEIT  FÜR  EINEN  BES‐
     TIMMTEN 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  <https://www.gnu.org/licenses/old-li‐
     censes/gpl-2.0.html> auf.

     Der ursprüngliche Autor kann über cwieninger@gmx.de erreicht werden.

     Die aktuellen Maintainer können über die  Projektseite  auf  GitHub  (siehe
     oben) erreicht werden.

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

SIEHE AUCH
     epgsearch(4),  epgsearch.conf(5),  epgsearchblacklists.conf(5),  epgsearch‐
     cats.conf(5),       epgsearchchangrps.conf(5),       epgsearchcmds.conf(5),
     epgsearchdirs.conf(5),    epgsearchdone.data(5),     epgsearchmenu.conf(5),
     epgsearchswitchtimer.conf(5), epgsearchuservars.conf(5)

perl v5.40.1                       2026-04-19                       epgsearch(1)
