@ -331,12 +331,17 @@ runtime.
Binds _key combo_ to execute the sway command _command_ when pressed. You
Binds _key combo_ to execute the sway command _command_ when pressed. You
may use XKB key names here (*xev*(1) is a good tool for discovering these).
may use XKB key names here (*xev*(1) is a good tool for discovering these).
With the flag _--release_, the command is executed when the key combo is
With the flag _--release_, the command is executed when the key combo is
released. Unless the flag _--locked_ is set, the command will not be run
released. If _input-device_ is given, the binding will only be executed for
when a screen locking program is active. If _input-device_ is given, the
that input device and will be executed instead of any binding that is
binding will only be executed for that input device and will be executed
generic to all devices. By default, if you overwrite a binding, swaynag
instead of any binding that is generic to all devices. By default, if you
will give you a warning. To silence this, use the _--no-warn_ flag.
overwrite a binding, swaynag will give you a warning. To silence this, use
the _--no-warn_ flag.
Unless the flag _--locked_ is set, the command will not be run when a
screen locking program is active. If there is a matching binding with
and without _--locked_, the one with will be preferred when locked and the
one without will be preferred when unlocked. If there are matching bindings
and one has both _--input-device_ and _--locked_ and the other has neither,
the former will be preferred even when unlocked.
Bindings to keysyms are layout-dependent. This can be changed with the
Bindings to keysyms are layout-dependent. This can be changed with the
_--to-code_ flag. In this case, the keysyms will be translated into the
_--to-code_ flag. In this case, the keysyms will be translated into the
@ -380,10 +385,13 @@ runtime.
respectively. _toggle_ is also supported to run a command both when the
respectively. _toggle_ is also supported to run a command both when the
switch is toggled on or off.
switch is toggled on or off.
Unless the flag _--locked_ is set, the command will not be run
Unless the flag _--locked_ is set, the command will not be run when a
when a screen locking program is active. By default, if you
screen locking program is active. If there is a matching binding with
overwrite a binding, swaynag will give you a warning. To silence this, use
and without _--locked_, the one with will be preferred when locked and the
the _--no-warn_ flag.
one without will be preferred when unlocked.
By default, if you overwrite a binding, swaynag will give you a warning. To
silence this, use the _--no-warn_ flag.
Example:
Example:
```
```