epgsearchcats.conf(5)        EPGSearch Version 2.4.6       epgsearchcats.conf(5)

NAME
     epgsearchcats.conf – Erweiterte EPG-Informationen

BESCHREIBUNG
     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.  Mit Tools wie tvmovie2vdr oder epg4vdr können derar‐
     tige 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 an‐
     hand  der  Datei  epgsearchcats.conf   im   Konfigurationsverzeichnis   von
     EPGSearch  entsprechende  Einstellungen  vorliegen.  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.  Siehe  auch
     createcats(1) für weitergehende Informationen zu seiner Verwendung.

FORMAT
     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

BEISPIEL
       1|Kategorie|Kategorie|Information,Kinder,Musik,Serie,Show,Spielfilm,Sport|2
       2|Genre|Genre|Abenteuer,Action,Wirtschaft,Wissen,Zeichentrick|2
       3|Format|Video-Format|16:9,4:3|2
       4|Audio|Audio-Format|Dolby Surround,Dolby,Stereo|2
       5|Jahr|Jahr||2
       6|Besetzung|Besetzung||2
       7|Regisseur|Regisseur||2
       8|Moderation|Moderation||2
       9|Bewertung|Bewertung|Großartig,Wertvoll,Gelungen,Annehmbar,Schwach|2
       10|Altersfreigabe|FSK|6,12,16,18|2
       12|Themen|Themen||4
       13|Staffel,%02i|Staffel||14
       14|Staffel,%02i|Staffel ab||13
       15|Episode,%02i|Episode||14

     Die   Kennungen  13  und  14  beziehen  sich  auf  dieselbe  EPG-Kategorie,
     definieren aber unterschiedliche Menünamen für  verschiedene  Suchmodi.  Da
     die  Auswertungsreihenfolge  nicht  garantiert  ist,  sollten deren Formate
     identisch  sein,  um  unerwartete  Darstellung  bei  Verwendung  der  Kate‐
     gorievariablen zu vermeiden.

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), createcats(1), epgsearchcats.conf(5)

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