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 erweiterten Programmführer ersetzt werden.

•   Der Programmführer erlaubt den Wechsel zwischen den nächsten und den gerade 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 einbinden, 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 Benachrichtigung ü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 Auflösung.

•   E-Mail-Benachrichtigungen über Suchtimer-Aktualisierungen und Timer-Konflikte.

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-Konfigurationsverzeichnis>/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 sendEmail.pl benutzt. Wenn ein abweichendes Kommando oder Skript verwendet werden soll, muss sichergestellt sein, dass das gleiche Parameter-Interface verwendet wird wie bei sendEmail.pl.

INHALT

1. Beschreibung
    1.1 Menü 'Befehle'
    1.2 Menü 'Suche'
        1.2.1 Menü 'Suche editieren'
        1.2.2 Menü 'Suchergebnisse'

    1.3 Erweitertes 'Jetzt' und 'Nächste'
    1.4 Menü '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 Funktionen erreicht werden können (die vorgegebene Zuweisung kann per Setup angepasst werden).

  1.1 Menü Befehle
Dieses Menü zeigt Befehle an, die auf den ausgewählten Menüeintrag angewandt werden können. Es gibt 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 aktuellen Sendung als Suchbegriff (um eine manuelle Erfassung zu vermeiden).

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

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 reccmds.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 Anmerkungen 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-Eintrags.

    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. Umschließ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 Ausdrü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 installiert.

    Unscharf
        Vergleicht den Suchbegriff anhand des Levenshtein-Distanz-Algorithmus. 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 Inhaltskennungen in Gruppen gegliedert sind, lässt sich alternativ festlegen, dass mindestens eine Übereinstimmung in jeder genutzten Gruppe vorliegen muss (ODER-Verknüpfung innerhalb einer Gruppe, UND-Verknüpfung zwischen den Gruppen).

    Besondere Merkmale von Sendungen (wie etwa Originalsprache oder schwarzweiß) werden zudem in einer von diesem Ähnlichkeitsschema abweichenden 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 Kategorien' 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 Kategorie' festlegt werden, dass schon die Übereinstimmung einer einzigen Kategorie ausreichend soll.

    Vorsicht: Ohne weiter eingrenzende Suchkriterien können die beiden alternativen 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 Bereichseinstellungen 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 verworfen.

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ü listet 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 'benutzerdefiniert' lässt sich über die Taste 'Blau' ein Zeitfenster einstellen, 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 gewechselt 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 gespeichert wird, wie etwa '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. Sie enthält jeweils ein Verzeichnis 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 verglichen werden soll.

Untertitel vergleichen
    Legt fest, 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 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 Inhaltsbeschreibung 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 anhand 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 Wiederholungen 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 unterschiedlich, 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 Bedingungen:

    •   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 erweitern, beispielsweise 'Nachmittag', 'Abend' oder 'Nacht'. Bereits verstrichene Zeiten werden übersprungen, sodass man etwa am Abend kein 'Nachmittag' 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' einblenden.

Des Weiteren kann in den Einstellungen ein Favoriten-Menü zugeschaltet werden. Für eine Suche lässt sich mittels 'Im Favoriten-Menü verwenden' festgelegen, dass die Suchergebnisse dort angezeigt werden sollen. Das Favoriten-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 wechseln.

    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 beschleunigen. 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 benutzerdefinierten 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 Fernbedienung 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'.

Zeit
    Uhrzeit, 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 erweitertes Timer-Editieren-Menü, das einen Verzeichniseintrag, benutzerdefinierte Wochentage und die Vervollständigung um Untertitel anbietet. Falls man einen gepatchten VDR verwendet, der ebenfalls ein erweitertes Timer-Editieren-Menü-Menü anbietet und lieber dieses verwenden 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~%Category%~%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: 'intelligent' versucht anhand der Länge einer Sendung festzustellen, ob ein Untertitel 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 hinterlegt 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 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-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. Standardmäß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 verwendet 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-Updates 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 Konflikt 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 Konflikte 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-Programmierung 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 Aufnahme erfolgen soll. Im Falle eines Konflikts wird dann sofort eine OSD-Meldung angezeigt. Diese erscheint aber nur, wenn der Konflikt innerhalb 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 Konfliktprüfung erfolgen soll. Bei relevanten Konflikten erfolgt eine Benachrichtigung 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-Benachrichtigungen über Timer-Konflikte gewünscht sind. Die Benachrichtigung 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 Konfigurationsverzeichnis 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 Benutzeraktionen 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 Benachrichtigungen werden nur versandt, wenn sich bei den Konflikten Veränderungen ergeben haben.

    Hinweis: Hierfür muss in den Einstellungen der Timer-Konfliktprüfung die Option 'Nach jedem Suchtimer-Update' oder 'alle ... Minuten' aktiviert 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 Authentifizierung erfordert.

Passwort
    Hier bitte das Passwort angeben, falls das E-Mail-Konto eine Authentifizierung 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-Konfigurationsdateien 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 Testfunktion 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 Hintergrund 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 Option '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 Feature '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 Einstellmö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 Übereinstimmung, einschließlich der Schreibweise. Die Beschreibung einer Sendung stellt jedoch eine Ausnahme dar: Hier wird zunächst alles aus dem Text eliminiert, was eine erweiterte Kategorie darstellen könnte, wie etwa 'Bewertung: Tagestipp'. Eine solche erweiterte Kategorie entspricht einer Zeile, die mit bis zu 40 Zeichen beginnt, von einem ':' gefolgt wird und dann maximal 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 unterschiedlich gewertet. Andernfalls erfolgt eine Prüfung per Levenshtein-Distanz-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 Kombination 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 Wiederholung 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-Optionen 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 Beschreibung 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 "erweiterten EPG-Informationen", der versucht, diese Information aus der Inhaltsbeschreibung 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 relativ 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 anhand 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 enthalten 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 Konfigurationsverzeichnis 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 folgendermaß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 Verwendung.

5. Ersetzen des Standard-Programm-Menüs
Um das Plugin als Ersatz für das über die Taste 'Grün' aufgerufene Standard-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 Hauptmenü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üdarstellung; 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 epgsearchuservars.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 Projekts 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ö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 <https://www.gnu.org/licenses/old-licenses/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), epgsearchcats.conf(5), epgsearchchangrps.conf(5), epgsearchcmds.conf(5), epgsearchdirs.conf(5), epgsearchdone.data(5), epgsearchmenu.conf(5), epgsearchswitchtimer.conf(5), epgsearchuservars.conf(5)