epgsearchcats.conf(5)      Epgsearch Version 0.9.22      epgsearchcats.conf(5)



NAME
       epgsearchcats.conf - Configuration of the additional EPG information

DESCRIPTION
       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.

SYNTAX
        ID|category name|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'
        - 'name in menu' is the name displayed in epgsearch.
        - 'values' is an optional list of possible values
        - 'searchmode' specifies the search mode:
          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

EXAMPLE
       (Lines are shortened for correct displaying)

       Example for EPG from Hrzu, 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|Groartig 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

SEE ALSO
       epgsearch(1), "epgsearchcats.conf(5)", createcats(1)

AUTHOR (man pages)
       Mike Constabel <epgsearch (at) constabel (dot) net>

REPORT BUGS
       Bug reports (german):

       <http://www.vdr-developer.org/mantisbt/>

       Mailing list:

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

COPYRIGHT and LICENSE
       Copyright (c) 2005-2007 Christian Wieninger

       <http://www.cwieninger.de.vu/>

       This  is free software.  You may redistribute copies of it under the
       terms of the GNU General Public License
       <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to the
       extent permitted by law.



perl v5.8.8                       2007-05-02             epgsearchcats.conf(5)
