epgsearch.conf(5)

NAME
epgsearch.conf – Suchen und Suchtimer

BESCHREIBUNG
Die in EPGSearch angelegten Suchen und Suchtimer werden in dieser Datei gespeichert.

Diese Datei sollte nicht manuell bearbeitet werden. Nutzen Sie stattdessen die Menüs des Plugins, seine SVDRP-Schnittstelle oder zusätzliche Frontends (wie etwa live) zum Erstellen, Bearbeiten oder Löschen von Suchen und Suchtimern.

FORMAT
Jede Zeile der Datei repräsentiert eine Suche oder einen Suchtimer und umfasst die folgenden Felder:

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

2 – Suchbegriff ("Abfrage")
    String zur Festlegung des Suchbegriffs.

3 – Uhrzeit verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

4 – Start nach [HHMM]
    Integer mit HH = 0..23, MM = 0..59; andere Werte können zu undefiniertem Verhalten führen.

5 – Start vor [HHMM]
    Integer mit HH = 0..23, MM = 0..59; andere Werte können zu undefiniertem Verhalten führen.

6 – Kanal verwenden
    Enumeration mit den Werten 0 = nein, 1 = Bereich, 2 = Kanalgruppe, 3 = ohne PayTV.

7 – Kanalauswahl
    wenn 'Kanal verwenden' = 1:
        String mit 'KanalID' oder 'MinKanalID'|'MaxKanalID'; die Kanalkennungen müssen der VDR-Notation entsprechen (bspw. 'S19.2E-1-1019-10301').

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

    wenn 'Kanal verwenden' = 2:
        String mit dem Namen einer zuvor erstellten Kanalgruppe.

8 – Groß/Kleinschreibung beachten
    Flag mit den Werten 0 = nein, 1 = ja.

9 – Suchmodus
    Enumeration mit den folgenden Werten:

    0 = Ausdruck
    1 = alle Worte
    2 = ein Wort
    3 = exakt
    4 = regulärer Ausdruck
    5 = unscharf (Toleranz im Feld 42; nicht verfügbar für erweiterte EPG-Kategorien)

    Siehe auch "Ablauf des Suchvorgangs" in epgsearch(4) bezüglich der Frage, wie sich diese Einstellungen auf die Suche auswirken.

10 – Titel verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

11 – Untertitel verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

12 – Beschreibung verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

13 – Dauer verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

14 – Minimale Dauer [HHMM]
    Integer mit HH = 0..23, MM = 0..59; andere Werte können zu undefiniertem Verhalten führen.

15 – Maximale Dauer [HHMM]
    Integer mit HH = 0..23, MM = 0..59; andere Werte können zu undefiniertem Verhalten führen.

16 – Als Suchtimer verwenden
    Enumeration den folgenden Werten:

    0 = nein
    1 = ja
    2 = Zeitspanne (Felder 48 und 49)

17 – Wochentag verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

18 – Wochentag
    Integer im Wertebereich von −127 bis 6. Die Bedeutung ist zweigeteilt:

    wenn Wt ≥ 0: ein einzelner Wochentag
        Enumeration mit den Werten 0 = Sonntag, 1 = Montag, ..., 6 = Samstag.

    wenn Wt < 0: eine Auswahl von Wochentagen
        Integer, in dem die Bits von −Wt die Wochentage darstellen. Die Bitmasken ergeben sich aus der Verschiebung von 0x01 um den Enumerationswert eines Wochentages:

        0x01 = Sonntag
        0x02 = Montag
        0x04 = Dienstag
        0x08 = Mittwoch
        0x10 = Donnerstag
        0x20 = Freitag
        0x40 = Samstag

        Um die gewünschten Wochentage zu kodieren, muss der aus den ODER-verknüpften Bitmasken resultierende Wert negiert werden.

        Beispiel: −67 (negiert: 0b01000011 = 0x40 | 0x02 | 0x01) kodiert Samstag, Montag und Sonntag

19 – Serienaufnahme
    Flag mit den Werten 0 = nein, 1 = ja.

20 – Aufnahmeverzeichnis
    String mit dem Namen eines Verzeichnisses unterhalb des Video-Verzeichnisses des VDR, jedoch ohne den Pfad zu diesem Video-Verzeichnis.

21 – Priorität der Aufzeichnung
    Integer im Wertebereich von 0 bis 99.

22 – Lebensdauer der Aufzeichnung [Tage]
    Integer im Wertebereich von 0 bis 99.

23 – Vorlauf zum Timer-Beginn [Minuten]
    Integer mit einem positiven Wert.

24 – Nachlauf am Timer-Ende [Minuten]
    Integer mit einem positiven Wert.

25 – VPS verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

26 – Aktion
    Enumeration mit den folgenden Werten:

    0 = aufnehmen
    1 = per OSD ankündigen (kein Timer)
    2 = nur umschalten (kein Timer)
    3 = per OSD ankündigen und umschalten (kein Timer)
    4 = per E-Mail ankündigen
    5 = deaktiviert

27 – Erweiterte EPG-Informationen verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

28 – Erweiterte EPG-Kategoriedaten
    Liste der erweiterten EPG-Kategoriedaten, jeweils dargestellt durch ein Tupel aus:

    28.1 – Kennung
        Eindeutige Kennung der erweiterten EPG-Kategorie, wie in epgsearchcats.conf angegeben.

    28.2 – Kategoriedaten
        Kommaseparierte Liste von Werten, wie für die EPG-Kategorie in epgsearchcats.conf angegeben. Leerzeichen vor und nach Kategoriewerten werden ignoriert. Ist in einem Wert ein ':' enthalten, wie etwa in '16:9', muss es als '!^colon^!' kodiert werden.

    Das Zeichen '|' trennt benachbarte Kategorientupel, während '#' die Kennungen und Kategorienamen trennt.

    Beispiel: '1#Film, Serie|2#Horror|8#16!^colon^!9'

29 – Wiederholungen vermeiden
    Flag mit den Werten 0 = nein, 1 = ja.

30 – Erlaubte Wiederholungen
    Integer im Wertebereich von 0 bis 99.

31 – Titel vergleichen (für den Test auf Wiederholungen)
    Flag mit den Werten 0 = nein, 1 = ja.

32 – Untertitel vergleichen (für den Test auf Wiederholungen)
    Enumeration mit den Werten 0 = nein, 1 = ja, 2 = falls vorhanden.

33 – Beschreibung vergleichen (für den Test auf Wiederholungen)
    Flag mit den Werten 0 = nein, 1 = ja.

34 – Kategorien vergleichen (für den Test auf Wiederholungen)
    Integer, in dem jedes Bit eine erweiterte EPG-Kategorie repräsentiert. Die erste in epgsearchcats.conf angegebene EPG-Kategorie wird durch Bit 0 (0x01) dargestellt, die zweite durch Bit 1 (0x02) usw. Ein Wert ungleich Null aktiviert den Vergleich.

    Hinweis: Die Kennungen der erweiterten EPG-Kategorien (Feld 1 eines EPG-Kategorieeintrags) sind für die Kodierung des Bitfelds nicht von Bedeutung. Änderungen der EPG-Kategorien erfordern gegebenenfalls eine Aktualisierung von Suchtimern.

35 – Nur innerhalb von ... Tagen
    Integer im Wertebereich von 0 bis 999.

36 – Aufzeichnungen nach ... Tagen löschen
    Integer im Wertebereich von 0 bis 999.

37 – Bis zu ... Aufzeichnungen behalten
    Integer im Wertebereich von 0 bis 999.

38 – Umschalten ... Minuten vor Start
    Integer im Wertebereich von 0 bis 99; nur relevant für 'Aktion' = 2.

39 – Pause, wenn ... Aufzeichnungen existieren
    Integer im Wertebereich von 0 bis 999.

40 – Ausschlusslisten verwenden
    Enumeration mit den Werten 0 = nur globale, 1 = Auswahl, 2 = alle, 3 = keine.

41 – Genutzte Ausschlusslisten
    Liste mit Kennungen von Ausschlusslisten, jeweils per '|' getrennt; nur relevant für 'Ausschlusslisten verwenden' = 1.

42 – Unschärfetoleranz
    Integer im Wertebereich von 1 bis 9, der als Schwellwert für die unscharfe Suche dient; nur relevant für 'Suchmodus' = 5.

43 – Im Favoriten-Menü verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

44 – Layout der Suchergebnisse im Favoriten-Menü
    Integer, der auf eine in epgsearchmenu.conf spezifizierte Vorlage für Suchergebnisse verweist. Der Wert ist der Index (beginnend bei 0) innerhalb aller Einträge mit dem Präfix 'MenuSearchResults'; Details finden sich unter "Anpassen der EPG-Menüs" in epgsearch(4).

    Hinweis: Dieses Feld ist nur relevant, wenn mehrere Vorlagen für Suchergebnisse vorliegen.

45 – Suchtimer automatisch löschen
    Enumeration mit den folgenden Werten:

    0 = nicht löschen
    1 = nach einer Anzahl von Aufnahmen löschen (Feld 46)
    2 = nach einer Anzahl von Tagen nach der ersten Aufnahme löschen (Feld 47)

46 – Nach ... Aufnahmen löschen
    Integer im Wertebereich von 0 bis 999; nur relevant für 'Suchtimer automatisch löschen' = 1.

47 – Nach ... Tagen nach erster Aufnahme löschen
    Integer im Wertebereich von 0 bis 999; nur relevant für 'Suchtimer automatisch löschen' = 2.

48 – Erster Tag (als Suchtimer verwenden ab)
    Datum und Zeit in Epoch-Notation (Sekunden seit dem 01.01.1970, 00:00 UTC), ab wann der Suchtimer aktiv ist; ein Wert von 0 deaktiviert die Prüfung.

    Hinweis: Jeder beliebige Epoch-Wert ist zulässig. Liegt die Zeit innerhalb eines Tages (anstelle von Mitternacht), bleibt der Timer inaktiv, bis diese Zeit erreicht ist.

49 – Letzter Tag (als Suchtimer verwenden bis)
    Datum und Zeit in Epoch-Notation (Sekunden seit dem 01.01.1970, 00:00 UTC), bis wann der Suchtimer aktiv ist; ein Wert von 0 deaktiviert die Prüfung.

    Hinweis: Jeder beliebige Epoch-Wert ist zulässig. Liegt die Zeit innerhalb eines Tages (anstelle von Mitternacht), bleibt der Timer aktiv, bis diese Zeit erreicht ist.

50 – Übereinstimmung von erweiterten EPG-Kategorien
    Enumeration mit den folgenden Werten:

    0 = alle Kategorien
    1 = alle außer fehlende Kategorien
    2 = mindestens eine Kategorie

    Erlaubt die Berücksichtigung von Sendungen mit fehlenden oder nur teilweise übereinstimmenden Kategorien. Ohne andere ausreichend einschränkende Kriterien könnte dies jedoch zu einer enormen Anzahl von Suchergebnissen führen.

51 – Ton anschalten
    Flag mit den Werten 0 = nein, 1 = ja; nur relevant für 'Aktion' = 2 oder 3.

52 – Minimale Übereinstimmung in Prozent
    Integer im Wertebereich von 1 bis 100, der festlegt, wie groß die erforderliche Übereinstimmung beim Vergleich der Beschreibungen von Sendungen mindestens sein muss, um Wiederholungen zu vermeiden; nur relevant für 'Beschreibung vergleichen' = 1.

53 – Inhaltskennungen
    String mit zu prüfenden Inhaltskennungen. Eine Inhaltskennung ist ein Wert von 0 bis 255 (siehe DIN EN 300 468, Tabelle 18), der als zweistellige Hexadezimalzahl kodiert ist. Das obere Nibble (Bits [7..4]) repräsentiert eine Gruppe von Inhalten, das untere Nibble (Bits [3..0]) eine Kennung für einen bestimmten Inhalt innerhalb dieser Gruppe. Die erste Kennung einer Gruppe mit dem Wert 0 ist üblicherweise eine allgemeine Charakterisierung dieser Gruppe (bspw. 0x10 = Film, Drama), wohingegen die Werte 1..15 eine untergeordnete, feinere Charakterisierung darstellen (wie 0x11 = Detektiv, Thriller; 0x14 = Komödie). Die Inhaltsgruppe 11 (besondere Merkmale) entspricht jedoch nicht diesem Schema (wie etwa ersichtlich anhand von 0xB0 = Originalsprache; 0xB1 = schwarzweiß), weshalb für deren Inhaltskennungen eine eigene Art der Übereinstimmung gewählt werden kann.

    Die zu prüfenden Inhaltskennungen sind die Verkettung ihrer zweistelligen Hexadezimalzahlen ohne Trennzeichen.

    Beispiel: Die Inhaltskennungen 17 (Detektiv, Thriller), 20 (Komödie) und 176 (Originalsprache) werden als '1114B0' kodiert.

    Die Felder 55 (Inhaltskategorien) und 56 (besondere Merkmale) legen fest, wann eine Sendung den ausgewählten Inhaltskennungen entspricht.

    Ein leerer String bewirkt, dass Inhaltskennungen nicht geprüft werden.

54 – Zeitpunkt vergleichen (für den Test auf Wiederholungen)
    Enumeration mit den Werten 0 = nein, 1 = gleicher Tag, 2 = gleiche Woche, 3 = gleicher Monat.

55 – Übereinstimmung von Inhaltskategorien
    Enumeration mit den folgenden Werten:

    0 = alle gewählten Kennungen
    1 = eine der gewählten Kennungen
    2 = eine gewählte Kennung je Gruppe

    Die Optionen 0 und 1 prüfen über alle Kategoriengruppen hinweg, verwenden aber dennoch die Einstellung aus Feld 56 zur Überprüfung der besonderen Merkmale. Daher können Kombinationen wie 'UND' für die Kategoriengruppen und 'ODER' innerhalb der besonderen Merkmale auftreten und umgekehrt.

    Option 2 hingegen verwendet einen zweistufigen Ansatz: Zunächst werden die Kategoriengruppen mit ausgewählten Inhaltskennungen geprüft (Gruppen ohne ausgewählte Inhaltskennungen entfallen). Eine Kategoriengruppe stimmt überein, wenn eine Sendung mindestens eine der für die Gruppe gewählten Inhaltskennungen enthält ('eine gewählte', ODER), mit Ausnahme der Gruppe der besonderen Merkmale, die stets die Einstellung aus Feld 56 verwendet. Abschließend müssen alle geprüften Kategoriengruppen übereinstimmen ('je Gruppe', UND).

    Nur relevant, wenn 'Inhaltskennungen' nicht leer ist.

56 – Übereinstimmung besonderer Inhaltsmerkmale
    Enumeration mit den Werten 0 = alle gewählten Kennungen, 1 = eine der gewählten Kennungen; nur relevant, wenn 'Inhaltskennungen' nicht leer ist.

57 – Altersfreigabe verwenden
    Flag mit den Werten 0 = nein, 1 = ja.

58 – Minimale Altersfreigabe
    Integer im Wertebereich von 0 bis 18.

59 – Maximale Altersfreigabe
    Integer im Wertebereich von 0 bis 18.

Der Eintrag eines Suchtimers wird als gültig betrachtet, wenn er mindestens die ersten 11 Felder abdeckt.

Die Felder ("Parameter") eines Suchtimers sind durch ':' getrennt. Daher wird ein ':' in Strings, wie etwa dem Suchbegriff oder dem Aufnahmeverzeichnis, durch '|' kodiert. Sollte ein '|' ebenfalls Teil des Strings sein, wie beispielsweise in regulären Ausdrücken, wird es durch '!^pipe^!' kodiert (was zwar unschön, aber aus Gründen der Abwärtskompatibilität erforderlich ist).

Felder, die von einem anderen Feld abhängen und aufgrund der Einstellung dieses Feldes belanglos sind, können (und sollten) leer gelassen werden. Beispielsweise kann ein Suchtimer ohne Zeitbeschränkung die Felder 'Start nach' und 'Start vor' leer lassen:

    1:Meine Lieblingsserie: 0::: 0::0:0
                            ^^^^

Darüber hinaus werden führende und nachfolgende Leerzeichen um einen Feldwert herum verworfen. Dies bedeutet jedoch, dass Strings nicht mit Leerzeichen beginnen oder enden können.

Hinweis: Strings in Feldern dürfen nicht in einfachen oder doppelten Anführungszeichen eingeschlossen werden, auch wenn dies in der Beschreibung so dargestellt sein sollte. Diese Zeichen wurden bei der Kompilierung dieser Man-Page eingefügt.

EXAMPLE
 1:Columbo:0:::2:Öffentlich-Rechtlich:1:3:1:0:0:0:::1:0:0:1:%Category%~%Genre%:50:99:10:60:0:0:0::1:0:1:1:0:0:0:0:0
 2:Schwarzenegger:0:::2:Hauptsender:0:0:0:0:0:0:::0:0:0:0:%Category%~%Genre%:50:99:10:10:0:0:1:1#|2#|3#|4#|5#|6#Arnold Schwarzenegger|7#|8#|9#|10#|11#|12#|13#:1:0:1:0:0:0:0:0:0

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(1), epgsearch(4)