NAME

epgsearchcats.conf

+ |Genre: Action
+ -m N, --minappearance=N    the minimum number a category has to appear
+                            to be used
+ -v N, --maxvalues=N        values of a category are omitted if they exceed
+                            this number
+ -l N, --maxlength=N        the maximum length of a text to be accepted
+                            as a category value
+ -h, --help                 this help
+ - Commands for EPG entries with 5 built-in commands like 'show repeats',
+   'create search'. One can add own commands for other needs, like adding a
+   VDRAdmin auto-timer.
+ - Add up to 4 user-defined times to 'now' and 'next' and an optional
+   favorites menu
+ - Searching the EPG: Create reusable queries, which can also be used
+   as 'search timers'.
+ - Search timers: Search for broadcasts in the background and add a
+   timer if one matches (similar to VDRAdmin's auto-timers) or simply
+   make an announcement about it via OSD
+ - Avoid double recordings of the same event
+   * timer preview
+   * recognition of broken recordings
+   * fuzzy event comparison
+ - Progress bar in 'What's on now' and 'What's on next'
+ - Shift the time displayed by key press, e.g. 'What's on now' + 30 minutes
+ - Start menu can be setup between 'Schedule' or 'What's on now'
+ - background check for timer conflicts with a timer conflict manager
+ - detailed EPG menu (summary) allows jumping to the next/previous
+   event
+ - support for extended EPG info for search timers
+ - extension of the timer edit menu with a directory item, user
+   defined weekday selection and a subtitle completion.
+ - Timer conflict check, informs you over the OSD about conflicts
+ - Timer conflict menu, show detailed information about the conflicts
+   and let you resolve them
+ - Email notifications about search timer updates and timer conflicts
+ 1.    Description
+ 1.1     Menu commands
+ 1.2     Menu search
+ 1.2.1     Menu edit search
+ 1.2.2     Menu search results
+ 1.3     Extended 'now' and 'next'
+ 1.4     Menu setup
+ 2.    Search timers
+ 2.1     'Avoid repeats' - internals
+ 2.2     How do we compare two events?
+ 2.3     How and when do we compare?
+ 3.    Usage from other plugins or scripts
+ 4.    Using extended EPG info
+ 5.    Replacing the standard schedule menu
+ 6.    Add-ons
+ - Repeats: Searches for repeats
+ - Record
+ - Switch
+ - Create search
+   Switches to search menu and adds a new search with the name of the current
+   item (to avoid editing the name manually)
+ - Search in recordings:
+   Search the recordings for a broadcast with the same name
+ - Mark as 'already recorded':
+   This puts the selected event in the file epgsearchdone.data and instructs
+   epgsearch to avoid recording this event if an according search timer is set
+   to "avoid repeats". An already created timer will be automatically removed
+   with the next search timer update.
+ - Add/Remove to/from switch list?:
+   Controls the switch list. If there is an event in the switch list, epgsearch
+   will announce it and switch to the event before it starts. To access the
+   complete switch list, call 'Search/Actions/Switch list'.
+ - Create blacklist:
+   A blacklist is used to ignore events when using search timers. A search
+   timer can be setup to ignore events from arbitrary blacklists.
+ $1: the title of the EPG entry
+ $2: the start time of the EPG entry as time_t value (like in the 
+     shutdown script)
+ $3: the end time
+ $4: the channel number of the EPG entry
+ $5: the long channel name of the EPG entry
+ $6: the subtitle of the EPG entry, "" if not present
+ * after x recordings, or
+ * after x days after the first recording
+  - created a new timer
+  - modified an existing timer
+  - deleted a timer, that was void because of EPG changes or other user
+    actions.
+  - sendEmail.pl: this is a simply script shipped with epgsearch, that allows
+    mail delivery also on systems without a configured mail server. Please
+    copy it to your $PATH
+  - sendmail: requires a properly configured mail system
+ ID|category name|name in menu|values separated by ','(option)|search mode(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
+ - 'search mode' 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
+ Green   @epgsearch
+ Green @launcher x
+ Gree Schedule
+ 1.  Using variables in the directory entry of a search timer
+ 2.  The format of epgsearch.conf
+ 3.  Description of the search process
+ 4.  How do Search Timers work?
+ 5.  How to trigger a search timer update?
+ 6.  The sources of the 'Select directory' menu
+ 7.  Language dependent commands for EPG
+ 8.  Usage from other plugins or scripts
+ 9.  SVDRP interface
+ 10. Customizing the EPG menus
+ 11. Working with the timer conflict menu
+ 12. User defined variables
+ 13. Email notifications
+ 1|Category|Kategorie|Information,Kinder,Musik,Serie,Show,Spielfilm,Sport|3
+ My Movies~%Category%
+ Childrens Movies~%category%
+ %CATEGORY%~%genre%
+ %Category%~%Genre%~%Title%~%Subtitle%
+ %Category%~%Genre%
+ (with 'serial recording' set to 'yes').
+ %Category%~%Genre%~%Title%~%Episode%~%Subtitle%
+  1 - unique search timer id
+  2 - the search term
+  3 - use time? 0/1
+  4 - start time in HHMM 
+  5 - stop time in HHMM 
+  6 - use channel? 0 = no,  1 = Interval, 2 = Channel group, 3 = FTA only
+  7 - if 'use channel' = 1 then channel id[|channel id] in vdr format,
+      one entry or min/max entry separated with |, if 'use channel' = 2
+      then the channel group name     
+  8 - match case? 0/1 
+  9 - search mode:
+       0 - the whole term must appear as substring
+       1 - all single terms (delimiters are blank,',', ';', '|' or '~') 
+          must exist as substrings.
+       2 - at least one term (delimiters are blank, ',', ';', '|' or '~') 
+           must exist as substring.
+       3 - matches exactly
+       4 - regular expression
+       5 - fuzzy searching (specify tolerance in parameter 42, not available
+           for EPG categories)
+ 10 - use title? 0/1
+ 11 - use subtitle? 0/1
+ 12 - use description? 0/1
+ 13 - use duration? 0/1
+ 14 - min duration in minutes
+ 15 - max duration in minutes
+ 16 - use as search timer? 0/1/2 (with 2 one can specify time margins in 
+      parameter 48/49 where the search timer is active)
+ 17 - use day of week? 0/1
+ 18 - day of week (0 = Sunday, 1 = Monday...;      
+      -1 Sunday, -2 Monday, -4 Tuesday, ...; -7 Sun, Mon, Tue)
+ 19 - use series recording? 0/1
+ 20 - directory for recording
+ 21 - priority of recording
+ 22 - lifetime of recording
+ 23 - time margin for start in minutes
+ 24 - time margin for stop in minutes
+ 25 - use VPS? 0/1
+ 26 - action:
+       0 = create a timer
+       1 = announce only via OSD (no timer)
+       2 = switch only (no timer)
+ 27 - use extended EPG info? 0/1
+ 28 - extended EPG info values. This entry has the following format
+      (delimiter is '|' for each category, '#' separates id and value):
+      1 - the id of the extended EPG info category as specified in
+          epgsearchcats.conf
+      2 - the value of the extended EPG info category
+          (a ':' will be translated to "!^colon^!", e.g. in "16:9")
+ 29 - avoid repeats? 0/1
+ 30 - allowed repeats
+ 31 - compare title when testing for a repeat? 0/1     
+ 32 - compare subtitle when testing for a repeat? 0/1     
+ 33 - compare description when testing for a repeat? 0/1     
+ 34 - compare extended EPG info when testing for a repeat?
+      This entry is a bit field of the category IDs.
+ 35 - accepts repeats only within x days
+ 36 - delete a recording automatically after x days
+ 37 - but keep this number of recordings anyway
+ 38 - minutes before switch (if action = 2)
+ 39 - pause if x recordings already exist
+ 40 - blacklist usage mode (0 none, 1 selection, 2 all)
+ 41 - selected blacklist IDs separated with '|'
+ 42 - fuzzy tolerance value for fuzzy searching
+ 43 - use this search in favorites menu (0 no, 1 yes)
+ 44 - number of the search menu template to use (only available if multiple
+      search result templates are defined in epgsearchmenu.conf)
+ 45 - auto deletion mode (0 don't delete search timer, 1 delete after given
+      count of recordings, 2 delete after given days after first recording)
+ 46 - count of recordings after which to delete the search timer
+ 47 - count of days after the first recording after which to delete the search
+      timer
+ 48 - first day where the search timer is active (see parameter 16)
+ 49 - last day where the search timer is active (see parameter 16)
+ 50 - ignore missing EPG categories? 0/1
+ 51 - unmute sound if off when used as switch timer
+ title~subtitle~description
+ touch /path_to_file/.epgsearchupdate
+   * current recording directories
+   * current timer directories
+   * directories used in search timers
+   * directories specified in F<epgsearchdirs.conf>,
+     see C<epgsearchdirs.con(5)>
+  { "eng,dos",
+    "deu,ger",
+    "slv",
+    "ita",
+    "dut,nla,nld",
+    "por",
+    "fra,fre",
+    "nor",
+    "fin,smi",
+    "pol",
+    "esl,spa",
+    "ell,gre",
+    "sve,swe",
+    "rom,rum",
+    "hun",
+    "cat,cln",
+    "rus",
+    "hrv",
+    "est",
+    "dan",
+  }
+ Search=your search term
+ Searchmode=x  // 0=phrase, 1=and, 2=or, 3=regular expression
+ ChannelNr=x   // add this line, to search on a specific channel
+ UseTitle=x    // 1(default) or 0
+ UseSubtitle=x // 1(default) or 0
+ UseDescr=x    // 1(default) or 0
+ svdrpsend.pl HITK green
+ - searching the EPG for some criteria and display the result list
+ - extended timer edit menu
+ svdrpsend.pl PLUG epgsearch LSTS
+ * 'LSTS [ID]' to list all searches, or the one with the passed ID
+   (format is the same as epgsearch.conf)
+ * 'NEWS <settings>' to add a new search
+   REMARK: the value of element ID is ignored. epgsearch will always
+   assign the next free ID
+ * 'DELS <ID>' to delete the search with ID
+ * 'EDIS <settings>' to modify an existing search
+ * 'UPDS [OSD]' to update the search timers. Passing the optional keyword
+   'OSD' pops up an OSD message after the update has finished.
+ * 'MODS ID ON|OFF' turns on/off the option 'Use as search timer'.
+ * 'UPDD' to reload the file epgsearchdone.data, e.g. after an
+   external tool has modified it.
+ * 'SETS <ON|OFF>' to temporarily activate or cancel the search timer background
+   thread. 
+ * 'FIND <settings>' for searching the EPG
+   input is the same as with 'NEWS'. output is a list of found events formatted
+   as 'NEWT' lines. So they can be immediately used to create a new timer for
+   an event.
+ * 'QRYS < ID(s) >' to get the results for a search with the given
+   ID. Multiple IDs can also be passed and have to be separated with '|'. 
+   The results are formatted like this:
+   search ID    : // the ID of the corresponding search timer
+   event ID     : // VDR event ID
+   title        : // event title, any ':' will be converted to '|'
+   episode name : // event short text, any ':' will be converted to '|'
+   event start  : // event start in seconds since 1970-01-01
+   event stop   : // event stop in seconds since 1970-01-01
+   channel      : // channel ID in VDR's internal representation (e.g. 'S19.2E-1-1101-28106')
+   timer start  : // timer start in seconds since 1970-01-01 (only valid if timer flag is > 0)
+   timer stop   : // timer stop in seconds since 1970-01-01 (only valid if timer flag is > 0)
+   timer file   : // timer file (only valid if timer flag is > 0)
+   timer flag   : // 0 = no timer needed, 1 = has timer, 2 timer planned for next update)
+ * 'QRYS <settings>' to get the results for a search with the given search
+   settings. 
+ * 'QRYF [hours]' to get the results for the favorites menu, see QRYS for
+   result format. The optional parameter specifies the number of hours to
+   evaluate and defaults to 24h.
+ * 'LSTC [channel group name]'
+   list all channel groups or if given the one with name 'group name'
+ * 'NEWC <channel group settings>'
+   create a new channel group, format as in epgsearchchangrps.conf
+ * 'EDIC <channel group settings>'
+   modify an existing channel group, format as in epgsearchchangrps.conf
+ * 'DELC <channel group name>'
+   delete an existing channel group
+ * 'RENC <old channel group name|new channel group name>'
+   rename an existing channel group
+ * 'LSTB [ID]' to list all blacklists, or the one with the passed ID
+   (format is the same as epgsearchblacklists.conf)
+ * 'NEWB <settings>' to add a new blacklist
+   REMARK: the value of element ID is ignored. epgsearch will always
+   assign the next free ID
+ * 'DELB <ID>' to delete the blacklist with ID
+ * 'EDIB <settings>' to modify an existing blacklist
+ * 'LSTT [ID]' to list all search templates, or the one with the passed ID
+   (format is the same as epgsearch.conf)
+ * 'NEWT <settings>' to add a new search template
+   REMARK: the value of element ID is ignored. epgsearch will always
+   assign the next free ID
+ * 'DELT <ID>' to delete the search template with ID
+ * 'EDIT <settings>' to modify an existing search template
+ * 'DEFT [ID]' returns the ID of the default search template. When passing an
+   ID it activates the corresponding template as default.
+ * 'LSTE [ID] to get the extended EPG categories defined in epgsearchcats.conf
+   or the one with the given ID. (format is the same as epgsearchcats.conf)
+ * 'SETP [option]' returns the current value of the given setup option or a
+   list of all options with their current values.
+   The following options can be accessed:
+    - ShowFavoritesMenu
+    - UseSearchTimers
+ * 'LSCC [REL]' returns the current timer conflicts. With the option 'REL' only
+   relevant conflicts are listed. The result list looks like this for example 
+   when we have 2 timer conflicts at one time:
+   1190232780:152|30|50#152#45:45|10|50#152#45
+   '1190232780' is the time of the conflict in seconds since 1970-01-01. It's 
+   followed by list of timers that have a conflict at this time:
+   '152|30|50#152#45' is the description of the first conflicting timer. Here:
+   '152' is VDR's timer id of this timer as returned from VDR's LSTT command
+   '30' is the percentage of recording that would be done (0...100)
+   '50#152#45' is the list of concurrent timers at this conflict
+   '45|10|50#152#45' describes the next conflict
+ MenuWhatsOnNow=%chnr%:3|%progrt2s%:5| %time% %t_status%:8|%category%:6| %title% ~ %subtitle%:35
+ MenuWhatsOnNext=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
+ MenuWhatsOnElse=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
+ MenuSchedule=%time% %t_status%:8|%genre%:14| %title% ~ %subtitle%:35
+ MenuSearchResults=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon% %subtitle%:35
+ MenuFavorites=%chnr%:3|%time%:6|%timespan%:7|%t_status%:14|%genre%:8| %title%%colon%%subtitle%:35
+ MenuSearchResultsTip of the Day=%chnr%:3|%time_w%:4|%t_status%:3|%genre%:10|%title%%colon% %subtitle%:35
+ %time%           - start time in format HH:MM
+ %timeend%        - end time in format HH:MM
+ %date%           - start date in format TT.MM.YY
+ %datesh%         - start date in format TT.MM.
+ %time_w%         - weekday name
+ %time_d%         - start day in format TT
+ %time_lng%       - start time in seconds since 1970-01-01 00:00
+ %timespan%       - timespan from now to the beginning of an event, e.g. 'in 15m'
+                    or the time an event is already running, e.g. '10m'. 
+ %length%         - length in seconds
+ %title%          - title
+ %subtitle%       - subtitle
+ %summary%        - summary
+ %htmlsummary%    - summary, where all CR are replaced with '<br />'
+ %eventid%        - numeric event ID
+ %t_status%       - timer status ('T', 't', 'R')
+ %v_status%       - VPS status
+ %r_status%       - running status
+ %status%         - complete status, the same as
+                    '%t_status%%v_status%%r_status%'
+ %<epg-category>% - a value from the extended EPG categories, specified in
+                    epgsearchcats.conf, like %genre% or %category%
+ %chnr%           - channel number
+ %chsh%           - the short channel name (>=vdr-1.3.15)
+ %chlng%          - the 'normal' channel name
+ %chdata%         - VDR's internal channel representation (e.g. 'S19.2E-1-1101-28106')
+ %progr%          - graphical progress bar (not for menu 'Search results')
+ %progrT2S%       - progress bar in text2skin style (not for menu 'Search results')
+ %colon%          - the sign ':'
+ %datenow%        - current date in format TT.MM.YY
+ %dateshnow%      - current date in format TT.MM.
+ %timenow%        - current time in format HH:MM
+ %videodir%       - VDR video directory (e.g. /video)
+ %plugconfdir%    - VDR plugin config directory (e.g. /etc/vdr/plugins)
+ %epgsearchdir%   - epgsearchs config directory (e.g. /etc/vdr/plugins/epgsearch)
+ WarEagleIcons=1
+ - searching a repeat for an event
+ - disabling a timer
+ - deleting a timer
+ - changing the timers start- or stop-time or its priority
+ - executing any other commands on this timer
+ %Series% %DocuVar1% %ThemesSubtitleDate1%
+ %Series%=New series~Thriller
+ %Path%=%Series%
+ %Path%=%Serie%~Lost
+ %Foo%=Other
+ %Variable%=%Path% ? %Path% : %Foo%
+ %Variable%=%Path%!=5 ? %Path% : %Foo%
+ %Five%=5
+ %Variable%=%Path%!=%Five% ? %Path% : %Foo%
+ ==   equal
+ !=   not equal
+ %uservar%=system(scriptname[, parameters])
+ %myVar%=system(/usr/local/bin/myscript.sh, -t %title% -s %subtitle% -u %myOtherVar%) 
+ 
+The script must return a string B<without> line break!
+ # Weekday, Date, Time   
+ %DateStr%=%time_w% %date% %time%
+ # Themes or Subtitle or Date
+ %ThemesSubtitleDate1%=%Subtitle% ? %Subtitle% : %DateStr%
+ %ThemesSubtitleDate%=%Themes% ? %Themes% : %ThemesSubtitleDate1%
+ # Calls this script to get a recording path
+ %DocuScript%=system(doku.pl, -t %Title% -s %Subtitle% -e %Episode% -th %Themes% -c %Category% -g %Genre%)
+ %Docu%=%DocuScript%
+  - epgsearchupdmail.templ (for search timer update notifications)
+  - epgsearchconflmail.templ (for timer conflict notifications)
+  - "subject" to be used as mail subject
+  - "mailbody" the body of the mail:
+    put '%update.newtimers%' in the place where the list of new timers should
+    appear. The same for %update.modtimers% and %update.deltimers% for the
+    list of changed or deleted timers.
+  - "timer" the description of one timer. This section is used to display one
+    timer within a timer list, e.g. in %update.newtimers%
+  - %update.newtimers%      - will be replaced with the list of new timers
+                              created with this update. The timers are
+                              displayed as defined in the section '<timer>'
+  - %update.countnewtimers% - the number of new timers
+  - %update.modtimers%      - same as %update.newtimers% but for modified
+                              timers. 
+  - %update.countmodtimers% - the number of modified timers
+  - %update.deltimers%      - same as %update.newtimers% but for deleted
+                              timers. (Note: a deleted timer has eventually
+                              no event assigned to it. So all event variables
+                              within the timer section will be substituted to
+                              an empty string.)
+  - %update.countdeltimers% - the number of deleted timers
+  - %colon%                 - the sign ':'
+  - %datenow%               - current date in format TT.MM.YY
+  - %dateshnow%             - current date in format TT.MM.
+  - %timenow%               - current time in format HH:MM
+  - %timer.date%            - date of the timer
+  - %timer.start%           - start time of the timer
+  - %timer.stop%            - stop time of the timer
+  - %timer.file%            - recording directory of the timer
+  - %timer.chnr%            - channel number 
+  - %timer.chsh%            - short channel name
+  - %timer.chlng%           - channel name
+  - %timer.search%          - name of the search timer, that created the timer
+  - %timer.searchid%        - id of the search timer, that created the timer
+  - any event variable (as in '10. Customizing the EPG menus')
+  - any extended EPG variable as defined in epgsearchcats.conf
+  - any user variable (as in '12. User defined variables')
+  - "subject" to be used as mail subject
+  - "mailbody" the body of the mail. Put %conflict.conflicts% in the place
+    where the list of conflict times should appear (Note: there can be more
+    than one timer conflict at the same time!). A conflict time uses the
+    section 'conflictsat' to display its content.
+  - "conflictsat" the description of one time where one or more conflicts
+    exists. Put %conflict.confltimers% in the place where the list of conflict
+    timers should appear.
+  - "confltimer" the description of one conflicting timer
+  - %conflict.count%        - complete number of timer conflicts
+  - %conflict.conflicts%    - list of times with conflicting timers
+  - %conflict.date%         - date of the conflict
+  - %conflict.time%         - time of the conflict
+  - %conflict.confltimers%  - list of conflicting timers for this time
+  1 - unique search timer id
+  2 - the search term
+  3 - use time? 0/1
+  4 - start time in HHMM
+  5 - stop time in HHMM
+  6 - use channel? 0 = no,  1 = Interval, 2 = Channel group, 3 = FTA only
+  7 - if 'use channel' = 1 then channel id[|channel id] in VDR format, 
+      one entry or min/max entry separated with |, if 'use channel' = 2
+      then the channel group name
+  8 - match case? 0/1
+  9 - search mode:
+      0 - the whole term must appear as substring
+      1 - all single terms (delimiters are blank,',', ';', '|' or '~')
+          must exist as substrings.
+      2 - at least one term (delimiters are blank, ',', ';', '|' or '~')
+          must exist as substring.
+      3 - matches exactly   
+      4 - regular expression
+ 10 - use title? 0/1      
+ 11 - use subtitle? 0/1   
+ 12 - use description? 0/1
+ 13 - use duration? 0/1
+ 14 - min duration in minutes 
+ 15 - max duration in minutes 
+ 16 - use as search timer? 0/1
+ 17 - use day of week? 0/1
+ 18 - day of week (0 = Sunday, 1 = Monday...; 
+      -1 Sunday, -2 Monday, -4 Tuesday, ...; -7 Sun, Mon, Tue)
+ 19 - use series recording? 0/1
+ 20 - directory for recording
+ 21 - priority of recording
+ 22 - lifetime of recording
+ 23 - time margin for start in minutes
+ 24 - time margin for stop in minutes
+ 25 - use VPS? 0/1
+ 26 - action:
+      0 = create a timer
+      1 = announce only via OSD (no timer)
+      2 = switch only (no timer)
+ 27 - use extended EPG info? 0/1
+ 28 - extended EPG info values. This entry has the following format
+      (delimiter is '|' for each category, '#' separates id and value):
+      1 - the id of the extended EPG info category as specified in
+          epgsearchcats.conf
+      2 - the value of the extended EPG info category
+          (a ':' will be translated to "!^colon^!", e.g. in "16:9")
+ 29 - avoid repeats? 0/1
+ 30 - allowed repeats
+ 31 - compare title when testing for a repeat? 0/1        
+ 32 - compare subtitle when testing for a repeat? 0/1     
+ 33 - compare description when testing for a repeat? 0/1  
+ 34 - compare extended EPG info when testing for a repeat?
+      This entry is a bit field of the category IDs.
+ 35 - accepts repeats only within x days
+ 36 - delete a recording automatically after x days
+ 37 - but keep this number of recordings anyway
+ 38 - minutes before switch (if action = 2)
+ 39 - pause if x recordings already exist
+ 40 - blacklist usage mode (0 none, 1 selection, 2 all)
+ 41 - selected blacklist IDs separated with '|'
+ 42 - fuzzy tolerance value for fuzzy searching
+ 43 - use this search in favorites menu (0 no, 1 yes)
+ 44 - id of a menu search template
+ 45 - auto deletion mode (0 don't delete search timer, 1 delete after given
+      count of recordings, 2 delete after given days after first recording)
+ 46 - count of recordings after which to delete the search timer
+ 47 - count of days after the first recording after which to delete the search
+      timer
+ 48 - first day where the search timer is active (see parameter 16)
+ 49 - last day where the search timer is active (see parameter 16)
+ 50 - ignore missing EPG categories? 0/1
+ 51 - unmute sound if off when used as switch timer
+ #version 2 - DON'T TOUCH THIS!
+ 1:Kommissar Beck:0:::2:�ffRecht:0:0: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:* S�gebrecht: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#Marianne S�gebrecht|7#|8#|9#|10#|11#|12#|13#:1:0:1:0:0:0:0:0:0
+ 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:
+   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
+ 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
+ Private|S19.2E-133-33-46|S19.2E-133-33-51
+ ProsiebenSat.1|S19.2E-133-33-46|S19.2E-133-33-47
+ RTL World|S19.2E-1-1089-12003||S19.2E-1-1089-12090
+   * current recording directories
+   * current timer directories
+   * directories used in search timers
+   * directories specified in F<epgsearchdirs.conf>
+ %time%           - start time in format HH:MM
+ %date%           - start date in format TT.MM.YY
+ %datesh%         - start date in format TT.MM.
+ %time_w%         - weekday name
+ %time_d%         - start day in format TT
+ %time_lng%       - start time in seconds since 1970-01-01 00:00
+ %title%          - title
+ %subtitle%       - subtitle
+ %Category%~%Genre%
+ %Category%~%Genre%~%Title%~%Episode%: %Subtitle%
+ Information~Nature~%Title%~%Episode%: %Subtitle%
+ %Series%
+ Movie~Action
+ Movie~Docu
+ Movie~Thriller
+ Music
+ Sports
+ MenuWhatsOnNow=%chnr%:3|%progrt2s%:5| %time% %t_status%:8|%category%:6| %title% ~ %subtitle%:35
+ MenuWhatsOnNext=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
+ MenuWhatsOnElse=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
+ MenuSchedule=%time% %t_status%:8|%genre%:14| %title% ~ %subtitle%:35
+ MenuSearchResults=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon% %subtitle%:35
+ MenuFavorites=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon%%subtitle%:35
+ MenuSearchResultsTip of the Day=%chnr%:3|%time_w%:4|%t_status%:3|%genre%:10|%title%%colon% %subtitle%:35
+ %time%           - start time in format HH:MM   
+ %date%           - start date in format TT.MM.YY
+ %datesh%         - start date in format TT.MM.
+ %time_w%         - weekday name
+ %time_d%         - start day in format TT
+ %time_lng%       - start time in seconds since 1970-01-01 00:00
+ %title%          - title   
+ %subtitle%       - subtitle
+ %t_status%       - timer status ('T', 't', 'R')
+ %v_status%       - VPS status
+ %r_status%       - running status
+ %status%         - complete status, the same as
+                    '%t_status%%v_status%%r_status%'
+ %colon%          - the sign ':'
+ %<epg-category>% - a value from the extended EPG categories, specified in
+                    epgsearchcats.conf, like %genre% or %category%
+ %chnr%           - channel number
+ %chsh%           - the short channel name (>=vdr-1.3.15)
+ %chlng%          - the 'normal' channel name
+ %chdata%         - VDR's internal channel representation (e.g. 'S19.2E-1-1101-28106')
+ %progr%          - graphical progress bar (not for menu 'Search results')
+ %progrT2S%       - progress bar in text2skin style (not for menu 'Search results')
+ WarEagleIcons=1
+ 1 - Channel
+ 2 - Event ID
+ 3 - Start time
+ 4 - Minutes to switch before event
+ 5 - Only inform via OSD
+ 6 - unmute sound if off
+ S19.2E-1-1089-12060:52221:1153322700:1:0
+ %Series% %DocuVar1% %ThemesSubtitleDate1%
+ %Series%=New series~Thriller
+ %Path%=%Series%
+ %Path%=%Serie%~Lost
+ %Foo%=Other
+ %Variable%=%Path% ? %Path% : %Foo%
+ %Variable%=%Path%!=5 ? %Path% : %Foo%
+ %Five%=5
+ %Variable%=%Path%!=%Five% ? %Path% : %Foo%
+ ==   equal
+ !=   not equal
+ %Result%=system(scriptname,%Variable1% %Variable2% -f %Variable3% --dir=%Variable4% --dummy)
+ %time%           - start time in format HH:MM
+ %timeend%        - end time in format HH:MM
+ %date%           - start date in format TT.MM.YY
+ %datesh%         - start date in format TT.MM.   
+ %time_w%         - weekday name
+ %time_d%         - start day in format TT
+ %time_lng%       - start time in seconds since 1970-01-01 00:00
+ %title%          - title
+ %subtitle%       - subtitle
+ %summary%        - summary
+ %htmlsummary%    - summary, where all CR are replaced with '<br />'
+ %eventid%        - numeric event ID
+ %<epg-category>% - a value from the extended EPG categories, specified in
+                    F<epgsearchcats.conf>, like %genre% or %category%
+ %chnr%           - channel number
+ %chsh%           - the short channel name (>=vdr-1.3.15)
+ %chlng%          - the 'normal' channel name
+ %chdata%         - VDR's internal channel representation (e.g. 'S19.2E-1-1101-28106')
+ %colon%          - the sign ':'
+ %datenow%        - current date in format TT.MM.YY
+ %dateshnow%      - current date in format TT.MM.
+ %timenow%        - current time in format HH:MM
+ %videodir%       - VDR video directory (e.g. /video)
+ %plugconfdir%    - VDR plugin config directory (e.g. /etc/vdr/plugins)
+ %epgsearchdir%   - epgsearchs config directory (e.g. /etc/vdr/plugins/epgsearch)
+ # Weekday, Date, Time   
+ %DateStr%=%time_w% %date% %time%
+ # Themes or Subtitle or Date
+ %ThemesSubtitleDate1%=%Subtitle% ? %Subtitle% : %DateStr%
+ %ThemesSubtitleDate%=%Themes% ? %Themes% : %ThemesSubtitleDate1%
+ # Calls this script to get a recording path
+ %DocuScript%=system(doku.pl,%Title%,%Subtitle%,%Episode%,%Themes%,%Category%,%Genre%)
+ %Docu%=%DocuScript%
+  1 - title
+  2 - short text
+  3 - channel ID
+  4 - start time
+  5 - next announce time
+  1 - channel-ID
+  2 - start time
+  3 - stop time
+  4 - search timer ID
+  5 - event title
+  6 - event episode