.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "epgsearchmenu.conf 5" .TH epgsearchmenu.conf 5 "2015-03-23" "perl v5.24.1" "Epgsearch Version 1.0.1.beta5" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" epgsearchmenu.conf \- Customizing the EPG menus .SH "DESCRIPTION" .IX Header "DESCRIPTION" The file \fIepgsearchmenu.conf\fR in your epgsearch config directory is used to store the entries for customizing the \s-1EPG\s0 menus. You specify the look of each menu (What's on now, What's on next, What's on at ..., Schedule, Search results, Favorites) with a separate line. .SH "EXAMPLE" .IX Header "EXAMPLE" .Vb 6 \& 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 .Ve .SH "SYNTAX" .IX Header "SYNTAX" E.g. the entry 'MenuWhatsOnNow' tells epgsearch how you would like to build a line for the menu 'What's on now'. This would create a menu line starting with the channel number, followed by a progress bar in text2skin style, a space of one char, the start time, the timer status, the \s-1EPG\s0 category (like \*(L"movie\*(R") and finally the title and subtitle. .PP The values for MenuWhatsOnNext, MenuWhatsOnElse, MenuSchedule, MenuSearchResults, MenuFavorites specify the menu 'What's on next', 'What's on at ...', 'Schedule', 'Search results' and 'Favorites' respectively. If you do not specify one entry, epgsearch uses its default menu look. .PP \&'MenuSearchResults' has something special: If you want to have different layouts for your search results depending on the search, you can use more then one menu template. Simply define e.g. an additional .PP .Vb 1 \& MenuSearchResultsTip of the Day=%chnr%:3|%time_w%:4|%t_status%:3|%genre%:10|%title%%colon% %subtitle%:35 .Ve .PP This will produce an additional menu item \*(L"Result menu layout\*(R" in the edit menu of a search where you can choose between the default menu template and your own templates. In the example above you will get \*(L"Tip of the Day\*(R" as selection entry, since epgsearch simply cuts the leading \*(L"MenuSearchResults\*(R". When you display the search results the chosen template will be used instead of the default one. .PP The following variables exist: .PP .Vb 10 \& %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 (\*(AqT\*(Aq, \*(Aqt\*(Aq, \*(AqR\*(Aq) \& %v_status% \- VPS status \& %r_status% \- running status \& %status% \- complete status, the same as \& \*(Aq%t_status%%v_status%%r_status%\*(Aq \& %colon% \- the sign \*(Aq:\*(Aq \& %% \- a value from the extended EPG categories, specified in \& epgsearchcats.conf, like %genre% or %category% .Ve .PP for the 'Whats on...' and 'Search results' menu there is also: .PP .Vb 6 \& %chnr% \- channel number \& %chsh% \- the short channel name \& %chlng% \- the \*(Aqnormal\*(Aq channel name \& %chdata% \- VDR\*(Aqs internal channel representation (e.g. \*(AqS19.2E\-1\-1101\-28106\*(Aq) \& %progr% \- graphical progress bar (not for menu \*(AqSearch results\*(Aq) \& %progrT2S% \- progress bar in text2skin style (not for menu \*(AqSearch results\*(Aq) .Ve .PP the variables are not case sensitive. .PP An entry consists of up to 6 tables separated with '|'. The last entry of each table should declare the table width in chars, separated with ':'. .PP If you use a separator like '~', '\-' or '#' to separate items like title or subtitle, e.g. \f(CW%title\fR% ~ \f(CW%subtitle\fR%, and the subtitle is empty, then epgsearch will try to fix this automatically to avoid a trailing separator. .PP You should vary the tab width values to fit your needs, since the look often depends on the selected skin. epgsearchmenu.conf is not reloaded with every plugin call, since this is only useful when testing the conf file. To activate the permanent reload for testing your conf, pass the new start parameter '\-r' or '\-\-reloadmenuconf' in your runvdr. .PP There's a sample \fIepgsearchmenu.conf\fR in the subdirectory \*(L"conf\*(R". For a quick try copy it to your epgsearch config directory (e.g. /etc/vdr/plugins/epgsearch). .PP To enable icons from the VDRSymbols font simply put the line .PP .Vb 1 \& WarEagleIcons=1 .Ve .PP to \fIepgsearchmenu.conf\fR. The VDRSymbols font is available at +http://andreas.vdr\-developer.org/fonts/download.html .PP \&\s-1NOTE:\s0 As long as there is a file epgsearchmenu.conf with an entry for a special menu, all setup settings regarding the look of this menu are ignored. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\f(CWepgsearch(1)\fR .SH "AUTHOR (man pages)" .IX Header "AUTHOR (man pages)" Mike Constabel .SH "REPORT BUGS" .IX Header "REPORT BUGS" Bug reports (german): .PP .PP Mailing list: .PP .SH "COPYRIGHT and LICENSE" .IX Header "COPYRIGHT and LICENSE" Copyright (C) 2004\-2010 Christian Wieninger .PP This program is free software; you can redistribute it and/or modify it under the terms of the \s-1GNU\s0 General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. .PP This program is distributed in the hope that it will be useful, but \s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of \&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE. \s0 See the \&\s-1GNU\s0 General Public License for more details. .PP You should have received a copy of the \s-1GNU\s0 General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA\s0 Or, point your browser to http://www.gnu.org/licenses/old\-licenses/gpl\-2.0.html .PP The author can be reached at cwieninger@gmx.de .PP The project's page is at http://winni.vdr\-developer.org/epgsearch .PP The \s-1MD5\s0 code is derived from the \s-1RSA\s0 Data Security, Inc. \s-1MD5\s0 Message-Digest Algorithm.