4mepgsearchuservars.conf24m(5)   Epgsearch Version 2.4.4  4mepgsearchuservars.conf24m(5)

1mNAME0m
       epgsearchuservars.conf - User defined variables

1mDESCRIPTION0m
       In this file you can defines variables which then can be used in
       epgsearch in any play where variables are possible.

1mSYNTAX0m
       Variables looks like %Variablename%.

       "Variablename" can be consist of any alphanumerical character. Space
       and special characters are not allowed.

       The variable names are case-insensitive.

       Examples for possible names:

        %Series% %DocuVar1% %ThemesSubtitleDate1%

   1mAssignment0m
        %Series%=New series~Thriller

       The variable %Series% will be assigned with the string "New
       series~Thriller".

       Assignments are always strings. Spaces stay spaces.

        %Path%=%Series%

       The variable %Path% gets the content of the variable %Series%.

       You can do nearly everything:

        %Path%=%Serie%~Lost

       The variable %Path% contains now the string "New series~Thriller~Lost".

   1mControl structures0m
       You can use simple "if then else" constructions.

       These constructions cannot contain strings, only variables.  Spaces are
       ignored.

        %Foo%=Other

        %Variable%=%Path% ? %Path% : %Foo%

       If %Path% is not empty, assign the content of %Path% to %Variable%,
       otherwise the content of %Foo%.

       "%Path% ?" means "not empty?". You can use other checks.

        %Variable%=%Path%!=5 ? %Path% : %Foo%

       "%Path%!=5 ?" means "is %Path% equal 5?"

       You can also compare variables.

        %Five%=5

        %Variable%=%Path%!=%Five% ? %Path% : %Foo%

       Other possible checks:

        ==   equal
        !=   not equal

   1mCalling a system command0m
       You can call external commands. The returned string will be assigned to
       a variable

        %Result%=system(scriptname,%Variable1% %Variable2% -f %Variable3% --dir=%Variable4% --dummy)

       Calls the script "scriptname" with the parameters "%Variable1%",
       "%Variable2%", etc. The result will be stored in %Result%.

       You can use as many variables as you want.

       If needed, epgsearch will quote the variable.

       The script must return a string 1mwithout 22mline break!

       If the script returns nothing, an empty string will be assigned to the
       Variable %Result%.

   1mPossible variables0m
       The following variables exist:

        %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
        %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%   - epgsearch config directory (e.g. /etc/vdr/plugins/epgsearch)

       See also "epgsearchcats.conf(5)".

1mEXAMPLES0m
        # 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%

1mSEE ALSO0m
       epgsearch(1), "epgsearchcats.conf(5)"

1mAUTHOR (man pages)0m
       Mike Constabel <epgsearch (at) constabel (dot) net>

1mREPORT BUGS0m
       Bug reports (german):

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

       Mailing list:

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

1mCOPYRIGHT and LICENSE0m
       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.

perl v5.40.1                      2025-10-30         4mepgsearchuservars.conf24m(5)
