SYNOPSIS

DESCRIPTION

sxhkd is a simple X hotkey daemon with a powerful and compact configuration syntax.

OPTIONS

-h

Print the synopsis to standard output and exit.

-v

Print the version information to standard output and exit.

-mCOUNT

Handle the first
COUNT
mapping notify events.

-tTIMEOUT

Timeout in seconds for the recording of chord chains.

-cCONFIG_FILE

Read the main configuration from the given file.

-rREDIR_FILE

Redirect the commands output to the given file.

-oMOTION_SOCKET

Write motion messages to the given SOCKET.

-gMOTION_MSG_TPL

Motion messages template.

-sSTATUS_FIFO

Output status information to the given FIFO.

-fFREQUENCY

Set the maximum frequency for motion events.

BEHAVIOR

sxhkd is a daemon that listens to keyboard events and execute commands.

It reads its configuration file from $XDG_CONFIG_HOME/sxhkd/sxhkdrc by default, or from the given file if the -c option is used.

Additional configuration files can be passed as arguments.

If sxhkd receives a SIGUSR1 (resp. SIGUSR2) signal, it will reload its configuration file (resp. toggle the grabbing state of all its bindings).

The commands are executed via SHELL-cCOMMAND (hence you can use environment variables).

SHELL will be the content of the first defined environment variable in the following list: SXHKD_SHELL, SHELL.

If you have a non-QWERTY keyboard or a non-standard layout configuration, you should provide a COUNT of 1 to the -m option or -1 (interpreted as infinity) if you constantly switch from one layout to the other (sxhkd ignores all mapping notify events by default because the majority of those events are pointless).