summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2019-11-23 00:39:07 +0100
committerwm4 <wm4@nowhere>2019-11-23 01:18:49 +0100
commitf379cf0bf89ca369e6cea957ef20e9e6579ec230 (patch)
treef69961fb3f6e23370d168d818a5db862949e43b6 /DOCS
parent251069d9ea481c14e418a63bfb2a471314fd4764 (diff)
downloadmpv-f379cf0bf89ca369e6cea957ef20e9e6579ec230.tar.bz2
mpv-f379cf0bf89ca369e6cea957ef20e9e6579ec230.tar.xz
command, input: add input-bindings property
Read-only information about all bindings. Somewhat hoping someone can make a nice GUI-like overlay thing for it, which provides information about mapped keys.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/input.rst37
1 files changed, 37 insertions, 0 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 0ef5f9bb72..3788c4fd61 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -2641,6 +2641,43 @@ Property list
information, but it's a valid feature request to extend this property if
needed.)
+``input-bindings``
+ Return list of current input key bindings. This returns an array of maps,
+ where each map node represents a binding for a single key/command. This map
+ has the following entries:
+
+ ``key``
+ The key name. This is normalized and may look slightly different from
+ how it was specified in the source (e.g. in input.conf).
+
+ ``cmd``
+ The command mapped to the key. (Currently, this is exactly the same
+ string as specified in the source. It's possible that it will be
+ normalized in the future.)
+
+ ``is_weak``
+ If set to true, any existing and active user bindings will take priority.
+
+ ``owner``
+ If this entry exists, the name of the script (or similar) which added
+ this binding.
+
+ ``section``
+ Name of the section this binding is part of. This is a rarely used
+ mechanism. This entry may be removed or change meaning in the future.
+
+ ``priority``
+ A number. Bindings with a higher value are preferred over bindings
+ with a lower value. If the value is negative, this binding is inactive
+ and will not be triggered by input. Note that mpv does not use this
+ value internally, and matching of bindings may work slightly differently
+ in some cases. In addition, this value is dynamic and can change around
+ at runtime.
+
+ This property is read-only, and change notification is not supported.
+ Currently, there is no mechanism to change key bindings at runtime, other
+ than scripts adding or removing their own bindings.
+
Inconsistencies between options and properties
----------------------------------------------