# This is a comment # Every new hotkey starts with one of these markers: # - -> normal matching # * -> fuzzy matching # Normal matching means that the keys need to be pressed in the same order as # they are declared, whereas fuzzy matching means that they can be pressed in # any order. # Leading or trailing whitespaces are ignored, whitespaces between the marker # And the ':' are also ignored, the general syntax for a hotkey is: # marker keys: command # Whitespaces after the ':' count as that counts as the executed command for # the hotkey. # Commads are expanded using wordexp(3) so "|&;<>(){}" as well as unescaped # newlines are forbidden and will result in error, read the manpage for # wordexp(3) for more info about the possible word expansion capabilities. # Possible keys are taken directly from linux's input.h header file, those # include normal keys, multimedia keys and special keys, for the full list # of available keys either refer to the header file or this project's hkd.c # source file. Keys as specified by the kernel are named "KEY_", in this # configuration file only the is required. # Key names are always capitalized and do not differenciate between upper or # lower case, as such hotkeys that require a capitalized letter need to include # RIGHTSHIFT or LEFTSHIFT in the keys section. # Keys are intended as a list of comma separated strings. # Examples: # - LEFALT,LEFTSHIFT,S: ~/screenshot.sh -c # * LEFTMETA,1,D: $SCRIPTDIR/wonkyscript # - LEFTMETA,LEFTALT,LEFTSHIFT,S: shutdown now # Aliases are a way to give a name to a possibly complex, long or recurring # command, to declaring aliases is similar to declaring an hotkey, you must # start the line with '@' to indicate an alias, give it a name (mind that this # is case sensitive), and a command after a ':', just like in hotkeys. # To use an alias in an hotkey you have to replace the ':' before the command # with '<' to indicate that the following string is an alias and not a command. # Aliases have to be declared before using them, they can also be concatenated. # Examples: # @ term : alacritty # @ volumeup: amixer -q sset Master 3%+ # - leftmeta, p < term # - VOLUMEUP < volumeup