1epgsearchmenu.conf(5)       Epgsearch Version 2.4.1      epgsearchmenu.conf(5)
2
3
4

NAME

6       epgsearchmenu.conf - Customizing the EPG menus
7

DESCRIPTION

9       The file epgsearchmenu.conf in your epgsearch config directory is used
10       to store the entries for customizing the EPG menus. You specify the
11       look of each menu (What's on now, What's on next, What's on at ...,
12       Schedule, Search results, Favorites) with a separate line.
13

EXAMPLE

15        MenuWhatsOnNow=%chnr%:3|%progrt2s%:5| %time% %t_status%:8|%category%:6| %title% ~ %subtitle%:35
16        MenuWhatsOnNext=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
17        MenuWhatsOnElse=%chnr%:3|%time% %t_status%:8|%category%:8| %title% ~ %subtitle%:35
18        MenuSchedule=%time% %t_status%:8|%genre%:14| %title% ~ %subtitle%:35
19        MenuSearchResults=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon% %subtitle%:35
20        MenuFavorites=%chnr%:3|%datesh% %time% %t_status%:14|%genre%:8| %title%%colon%%subtitle%:35
21

SYNTAX

23       E.g. the entry 'MenuWhatsOnNow' tells epgsearch how you would like to
24       build a line for the menu 'What's on now'. This would create a menu
25       line starting with the channel number, followed by a progress bar in
26       text2skin style, a space of one char, the start time, the timer status,
27       the EPG category (like "movie") and finally the title and subtitle.
28
29       The values for MenuWhatsOnNext, MenuWhatsOnElse, MenuSchedule,
30       MenuSearchResults, MenuFavorites specify the menu 'What's on next',
31       'What's on at ...', 'Schedule', 'Search results' and 'Favorites'
32       respectively. If you do not specify one entry, epgsearch uses its
33       default menu look.
34
35       'MenuSearchResults' has something special: If you want to have
36       different layouts for your search results depending on the search, you
37       can use more then one menu template. Simply define e.g. an additional
38
39        MenuSearchResultsTip of the Day=%chnr%:3|%time_w%:4|%t_status%:3|%genre%:10|%title%%colon% %subtitle%:35
40
41       This will produce an additional menu item "Result menu layout" in the
42       edit menu of a search where you can choose between the default menu
43       template and your own templates. In the example above you will get "Tip
44       of the Day" as selection entry, since epgsearch simply cuts the leading
45       "MenuSearchResults". When you display the search results the chosen
46       template will be used instead of the default one.
47
48       The following variables exist:
49
50        %time%           - start time in format HH:MM
51        %date%           - start date in format TT.MM.YY
52        %datesh%         - start date in format TT.MM.
53        %time_w%         - weekday name
54        %time_d%         - start day in format TT
55        %time_lng%       - start time in seconds since 1970-01-01 00:00
56        %title%          - title
57        %subtitle%       - subtitle
58        %t_status%       - timer status ('T', 't', 'R')
59        %v_status%       - VPS status
60        %r_status%       - running status
61        %status%         - complete status, the same as
62                           '%t_status%%v_status%%r_status%'
63        %colon%          - the sign ':'
64        %<epg-category>% - a value from the extended EPG categories, specified in
65                           epgsearchcats.conf, like %genre% or %category%
66
67       for the 'Whats on...' and 'Search results' menu there is also:
68
69        %chnr%           - channel number
70        %chsh%           - the short channel name
71        %chlng%          - the 'normal' channel name
72        %chdata%         - VDR's internal channel representation (e.g. 'S19.2E-1-1101-28106')
73        %progr%          - graphical progress bar (not for menu 'Search results')
74        %progrT2S%       - progress bar in text2skin style (not for menu 'Search results')
75
76       the variables are not case sensitive.
77
78       An entry consists of up to 6 tables separated with '|'. The last entry
79       of each table should declare the table width in chars, separated with
80       ':'.
81
82       If you use a separator like '~', '-' or '#' to separate items like
83       title or subtitle, e.g. %title% ~ %subtitle%, and the subtitle is
84       empty, then epgsearch will try to fix this automatically to avoid a
85       trailing separator.
86
87       You should vary the tab width values to fit your needs, since the look
88       often depends on the selected skin. epgsearchmenu.conf is not reloaded
89       with every plugin call, since this is only useful when testing the conf
90       file. To activate the permanent reload for testing your conf, pass the
91       new start parameter '-r' or '--reloadmenuconf' in your runvdr.
92
93       There's a sample epgsearchmenu.conf in the subdirectory "conf". For a
94       quick try copy it to your epgsearch config directory (e.g.
95       /etc/vdr/plugins/epgsearch).
96
97       To enable icons from the VDRSymbols font simply put the line
98
99        WarEagleIcons=1
100
101       to epgsearchmenu.conf. The VDRSymbols font is available at
102       +http://andreas.vdr-developer.org/fonts/download.html
103
104       NOTE: As long as there is a file epgsearchmenu.conf with an entry for a
105       special menu, all setup settings regarding the look of this menu are
106       ignored.
107

SEE ALSO

109       epgsearch(1)
110

AUTHOR (man pages)

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

REPORT BUGS

115       Bug reports (german):
116
117       <http://projects.vdr-developer.org/projects/plg-epgsearch>
118
119       Mailing list:
120
121       <http://www.vdr-developer.org/mailman/listinfo/epgsearch>
122
124       Copyright (C) 2004-2010 Christian Wieninger
125
126       This program is free software; you can redistribute it and/or modify it
127       under the terms of the GNU General Public License as published by the
128       Free Software Foundation; either version 2 of the License, or (at your
129       option) any later version.
130
131       This program is distributed in the hope that it will be useful, but
132       WITHOUT ANY WARRANTY; without even the implied warranty of
133       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
134       General Public License for more details.
135
136       You should have received a copy of the GNU General Public License along
137       with this program; if not, write to the Free Software Foundation, Inc.,
138       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA Or, point
139       your browser to http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
140
141       The author can be reached at cwieninger@gmx.de
142
143       The project's page is at http://winni.vdr-developer.org/epgsearch
144
145       The MD5 code is derived from the RSA Data Security, Inc. MD5 Message-
146       Digest Algorithm.
147
148
149
150perl v5.36.0                      2022-08-04             epgsearchmenu.conf(5)
Impressum