Your company here — click to reach over 10,000 unique daily visitors

epgsearchcats.conf - Man Page

Configuration of the additional EPG information


Some EPG providers deliver additional EPG information like the type of event, the video and audio format, cast,...

Using tvm2vdr or epg4vdr you can import this into vdr.  To use this information with search timers one has to configure it with the file epgsearchcats.conf in your plugins config directory.

Sample files for epgsearchcats.conf are delivered with the plugin in the directory 'conf'.

Simply copy the one that fits for you to your plugins config directory with filename epgsearchcats.conf and then have a look to the search timers edit menu (after a restart of VDR).

Since setting up a new epgsearchcats.conf is a lot of work, I've added a small tool 'createcats', that makes the biggest part of the job. It should have been compiled with the plugin and exists in the sources directory.

See createcats(1) for information about how to use it.

Internals: epgsearch scans the summary of an event for the category name followed by ': ' for all categories that have a corresponding value set in the search timer. The search is case sensitive regarding the category name as also the value.


 ID|category name(,format)|name in menu|values separated by ','(option)|searchmode(option)

 - 'ID' should be a unique positive integer
   (changing the id later on will force you to re-edit your search timers!)
 - 'category name' is the name as delivered by the EPG provider, e.g. 'Genre'
   you can optionally provide a format specifier for numeric values, e.g.
 - 'name in menu' is the name displayed in epgsearch.
 - 'values' is an optional list of possible values
 - 'searchmode' specifies the search mode:
   text comparison:
    0  - the whole term must appear as substring
    1  - all single terms (delimiters are ',', ';', '|' or '~')
         must exist as substrings. This is the default search mode.
    2  - at least one term (delimiters are ',', ';', '|' or '~')
         must exist as substring.
    3  - matches exactly
    4  - regular expression
   numerical comparison:
    10 - less
    11 - less or equal
    12 - greater
    13 - greater or equal
    14 - equal
    15 - not equal


(Lines are shortened for correct displaying)

Example for EPG from H�rzu, downloaded from epgdata.com with tvmovie2vdr.




 4|Audio|Audio|Dolby Surround,Dolby,Hoerfilm,Stereo|2





 9|Rating|Bewertung|Gro�artig besonders wertvoll,Annehmbar,Schwach|2





See Also

epgsearch(1), epgsearchcats.conf(5), createcats(1)

AUTHOR (man pages)

Mike Constabel <epgsearch (at) constabel (dot) net>

Report Bugs

Bug reports (german):


Mailing list:


Referenced By

createcats(1), epgsearch(1), epgsearch(4), epgsearchdirs.conf(5), epgsearchuservars.conf(5).

2024-07-15 perl v5.40.0 Epgsearch Version 2.4.1