sxhkd

Start sxhkd with default configuration

$ sxhkd &

$ sxhkd -c [~/.config/sxhkd/custom_sxhkdrc] &

$ sxhkd -s [/tmp/sxhkd.fifo] &

$ sxhkd -r [/tmp/sxhkd.log] &

$ pkill -USR1 sxhkd

$ pkill -USR2 sxhkd

$ sxhkd -t 3 &

sxhkd [-hv] [-m count] [-t timeout] [-c configfile] [**-r** redirfile] [-s statusfifo] [configfile...]

sxhkd (Simple X Hotkey Daemon) listens for keyboard and mouse events on X11 and executes commands defined in its configuration file. It is window manager agnostic and commonly used with tiling window managers like bspwm.
Configuration is read from ~/.config/sxhkd/sxhkdrc by default. Each binding consists of a hotkey line followed by a command line (indented with whitespace). Modifiers include super, alt, ctrl, shift, and mod1-mod5.
Key features include chorded bindings (sequences like super + a ; b), key release events (prefix keysym with @), and pointer buttons (button1-button24). Sequences with {a,b,c} expand to multiple bindings.
Commands execute via $SXHKD_SHELL or $SHELL. Send SIGUSR1 to reload configuration and SIGUSR2 to toggle hotkey grabbing.

-h

Display help and exit

Display version and exit

Read configuration from specified file instead of default

Redirect command output to specified file

Write status information to specified FIFO

Chord chain timeout in seconds

Handle first count mapping notify events (for keyboard layout changes)

~/.config/sxhkd/sxhkdrc

Default configuration file defining hotkey bindings and their associated commands.

sxhkd only works on X11; it does not support Wayland. Keysym names are determined by xev. Some key combinations may conflict with window managers or other applications grabbing the same keys.

sxhkd was created by Bastien Dejean (baskerville), the same developer behind bspwm. It was first released around 2013 as a standalone hotkey daemon that could work with any window manager, addressing the need for a simple, scriptable keybinding system independent of the window manager.

xev(1), xdotool(1), bspwm(1), xbindkeys(1)