diff options
author | wm4 <wm4@nowhere> | 2019-11-23 00:39:07 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2019-11-23 01:18:49 +0100 |
commit | f379cf0bf89ca369e6cea957ef20e9e6579ec230 (patch) | |
tree | f69961fb3f6e23370d168d818a5db862949e43b6 /DOCS/man | |
parent | 251069d9ea481c14e418a63bfb2a471314fd4764 (diff) | |
download | mpv-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/man')
-rw-r--r-- | DOCS/man/input.rst | 37 |
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 ---------------------------------------------- |