shell
git clone https://github.com/fritzrehde/watchbind.git
cd watchbind
cargo build
shell
cargo install watchbind
To be added.
There are several ways to customize the settings:
1. The command line options override all other settings (i.e. all toml and default settings).
2. A toml config file, specified with watchbind --config-file <FILE>, overrides all default settings (Example: test-config.toml).
On the command line, you can specify keybindings with the option --bind "KEY:OPS[,KEY:OPS]*", where OPS is a list of operations OP that are bound to KEY.
One KEY can be bound to multiple operations, therefore, the syntax for each list of operations (OPS) is OP[+OP]*.
The operations are seperated by + and executed in succession (one after the other).
TLDR: operations are seperated by +, keybindings are seperated by ,
In a toml config file, specify keybindings like so:
toml
[keybindings]
"KEY" = [ "OP" ]
"KEY" = [ "OP", "OP", "OP" ]
"KEY" = [
"OP",
"OP"
]
This syntax differs from the command-line syntax because using the toml array feature is more expressive and more native to the toml file format.
Furthermore, this allows you to use the + character in your commands.
You can find some keybinding examples in test-config.toml.
All supported KEY values
esc
enter
left
right
up
down
home
end
pageup
pagedown
backtab
backspace
del
delete
insert
ins
f1
f2
f3
f4
f5
f6
f7
f8
f9
f10
f11
f12
space
tab
[any single character]
All supported OP values
sh
exit
reload
unselect
next
previous
first
last
COMMAND # blocks watchbind until finished executing
COMMAND & # executed as background process
COMMAND will be executed in a subshell that has the environment variable LINE set to the currently selected line.
Foreground colors, background colors and boldness of the selected line and all unselected lines can be customized.
All supported COLOR values
white
black
red
green
yellow
blue
magenta
cyan
gray
dark_gray
light_red
light_green
light_yellow
light_blue
light_magenta
light_cyan
If you want to use pipes in your command on the command line, make sure to escape the pipe symbol like so:
watchbind ls \| grep "test"
or put quotes around the command
watchbind "ls | grep test"
Otherwise, the shell will think you want to pipe the output of watchbind ls to grep test.
The commands you bind to keys will be executed in a subshell using sh -c.
This means you can run a command like
watchbind --bind "enter:notify-send \$LINE" ls
and the environment variable $LINE will contain the selected line.
But note that
watchbind --bind "enter:notify-send $LINE" ls
will not work as expected, because $LINE will be replaced in the shell you are running the watchbind command from.