epgsearchcats.conf - Man Page

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.
   Episode,%02i
 - '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.

 1|Category|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|Dolby Surround,Dolby,Hoerfilm,Stereo|2

 5|Year|Jahr||2

 6|Cast|Besetzung||2

 7|Director|Regisseur||2

 8|Moderator|Moderation||2

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

 10|FSK|FSK|6,12,16,18|2

 11|Country|Land||2

 12|Episode|Episode||4

 13|Themes|Thema||4

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

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

Bug reports (german):

<http://projects.vdr-developer.org/projects/plg-epgsearch>

Mailing list:

<http://www.vdr-developer.org/mailman/listinfo/epgsearch>

Copyright (C) 2004-2010 Christian Wieninger

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Or, point your browser to http://www.gnu.org/licenses/old-licenses/gpl-2.0.html

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm.

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