summaryrefslogtreecommitdiff
path: root/vdr.5
diff options
context:
space:
mode:
authorKlaus Schmidinger <vdr@tvdr.de>2002-12-01 10:48:08 +0100
committerKlaus Schmidinger <vdr@tvdr.de>2002-12-01 10:48:08 +0100
commit816e6847aac13ad51bf7d569b90be5f7fbe5c027 (patch)
tree779f79053d895066de16044c73bff327a9209d4c /vdr.5
parent125872e75f48af908bd008037226bbddb62666c1 (diff)
downloadvdr-816e6847aac13ad51bf7d569b90be5f7fbe5c027.tar.gz
vdr-816e6847aac13ad51bf7d569b90be5f7fbe5c027.tar.bz2
Macros in 'keymacros.conf' can now use "@plugin" to directly access the main menu function of a given plugin
Diffstat (limited to 'vdr.5')
-rw-r--r--vdr.519
1 files changed, 16 insertions, 3 deletions
diff --git a/vdr.5 b/vdr.5
index 66ce4a15..8a76fdd9 100644
--- a/vdr.5
+++ b/vdr.5
@@ -8,7 +8,7 @@
.\" License as specified in the file COPYING that comes with the
.\" vdr distribution.
.\"
-.\" $Id: vdr.5 1.15 2002/11/29 14:13:40 kls Exp $
+.\" $Id: vdr.5 1.16 2002/12/01 10:34:40 kls Exp $
.\"
.TH vdr 5 "24 Nov 2002" "1.2.0" "Video Disk Recorder Files"
.SH NAME
@@ -363,13 +363,26 @@ this remote control delivers when the given key is pressed.
The file \fIkeymacros.conf\fR contains user defined macros that will be executed
whenever the given key is pressed. The format is
-\fBmacrokey key1 key2 key3...\fR
+\fBmacrokey [@plugin] key1 key2 key3...\fR
where \fBmacrokey\fR is the key that shall initiate execution of this macro
and can be one of \fIRed\fR, \fIGreen\fR, \fIYellow\fR, \fIBlue\fR or
\fIUser1\fR...\fIUser9\fR. The rest of the line consists of a set of
keys, which will be executed just as if they had been pressed in the given
-sequence. Note that the color keys will only execute their macro function
+sequence. The optional \fB@plugin\fR can be used to automatically select
+the given plugin from the main menu (provided that plugin has a main menu
+entry). \fBplugin\fR is the name of the plugin, exactly as given in the -P
+option when starting VDR. There can be only one \fB@plugin\fR per key macro,
+and it implicitly adds an \fIOk\fR key to the macro definition (in order to
+actually select the plugins main menu entry), which counts against the total
+number of keys in the macro. For instance
+
+\fBUser1 @abc Down Down Ok\fR
+
+would call the main menu function of the "abc" plugin and execute two "Down"
+key presses, followed by "Ok".
+.br
+Note that the color keys will only execute their macro function
in "normal viewing" mode (i.e. when no other menu or player is active). The
\fIUser1\fR...\fIUser9\fR keys will always execute their macro function.
There may be up to 15 keys in such a key sequence.