epgsearch.conf(5)            EPGSearch Version 2.4.6           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  um‐
     fasst 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 un‐
         definiertem Verhalten führen.

     5 – Start vor [HHMM]
         Integer mit HH =  0..23,  MM  =  0..59;  andere  Werte  können  zu  un‐
         definiertem 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  Kanalken‐
             nungen     müssen     der     VDR-Notation    entsprechen    (bspw.
             'S19.2E-1-1019-10301').

             Achtung: Nach einer Änderung der Kanalreihenfolge sollten die Bere‐
             ichseinstellungen 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 un‐
         definiertem Verhalten führen.

     15 – Maximale Dauer [HHMM]
         Integer mit HH =  0..23,  MM  =  0..59;  andere  Werte  können  zu  un‐
         definiertem 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 = Sam‐
             stag.

         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 Enumer‐
             ationswert 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-Verzeich‐
         nisses 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 epgsearch‐
             cats.conf angegeben.

         28.2 – Kategoriedaten
             Kommaseparierte  Liste  von  Werten,  wie  für die EPG-Kategorie in
             epgsearchcats.conf angegeben. Leerzeichen vor und nach  Kategoriew‐
             erten  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  un‐
         gleich 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 un‐
         scharfe 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) in‐
         nerhalb 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  au‐
         tomatisch löschen' = 1.

     47 – Nach ... Tagen nach erster Aufnahme löschen
         Integer  im Wertebereich von 0 bis 999; nur relevant für 'Suchtimer au‐
         tomatisch 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 inner‐
         halb 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 inner‐
         halb  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 teil‐
         weise übereinstimmenden Kategorien. Ohne andere ausreichend einschränk‐
         ende  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  er‐
         forderliche  Ü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  zweis‐
         tellige  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 allge‐
         meine  Charakterisierung  dieser  Gruppe  (bspw.  0x10  = Film, Drama),
         wohingegen die Werte  1..15  eine  untergeordnete,  feinere  Charakter‐
         isierung  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 zweistelli‐
         gen 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, verwen‐
         den aber dennoch die Einstellung aus Feld 56 zur Überprüfung der beson‐
         deren  Merkmale.   Daher  können  Kombinationen wie 'UND' für die Kate‐
         goriengruppen 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  (Grup‐
         pen 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  Aus‐
         nahme 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  Aufnahmeverze‐
     ichnis,  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 er‐
     forderlich 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 Feldw‐
     ert  herum  verworfen. Dies bedeutet jedoch, dass Strings nicht mit Leerze‐
     ichen beginnen oder enden können.

     Hinweis: Strings in Feldern dürfen nicht in einfachen  oder  doppelten  An‐
     fü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 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(1), epgsearch(4)

perl v5.40.1                       2026-04-19                  epgsearch.conf(5)
