icewm-keys - icewm keys configuration file
Global key bindings to launch applications (not window manager related).
IceWM allows launching of arbitrary programs with any key combination.
This is configured in the
Global keybindings to launch applications, which need not be window
manager related. Each non-empty line starts with the word
After one or more spaces follows a double-quoted string of the bound X11
key combination like
Alt+Ctrl+Shift+X. Then after at least one space
follows a shell command line which will be executed by icewm whenever
this key combination is pressed. For example, the following line
creates a hotkey to reload the icewm configuration:
key "Ctrl+Shift+r" pkill -x -HUP icewm
The syntax of the
keys file is as follows:
- key “key_combination“ program options
The literal string keyword.
The literal string keyword, used as alternative to
key to build
menu-like quickswitch popups.
Any combination of keys, separated by plus-sign (
program is the name of the executable or full path to the executable file that will be run in response to selecting the menu item. When used with the switchkey keyword, the program must print on standard output the contents of the popup like it would be used for dynamic menus.
options is the options and arguments passed to the program verbatim.
Following is the example
keys file that ships with icewm(1):
# This is an example for IceWM's hotkey definition file. # # Place your variants in @CFGDIR@ or in $HOME/.icewm # since modifications to this file will be discarded when # you (re)install icewm. # # A list of all valid keyboard symbols can be found in # /usr/include/X11/keysym.h, keysymdefs.h, XF86keysym.h, # ... You'll have to omit XK_ prefixs and to replace # XF86XK_ prefixes by XF86. Valid modifiers are Alt, # Ctrl, Shift, Meta, Super and Hyper. # key "Alt+Ctrl+t" xterm key "Alt+Ctrl+b" xdg-open about:blank key "Alt+Ctrl+s" xdg-open http://www.google.com key "Super+KP_Subtract" amixer sset PCM 5%- key "Super+KP_Add" amixer sset PCM 5%+ # "Multimedia key" bindings for XFree86. Gather the # keycodes of your advanced function keys by watching the # output of the xev command whilest pressing those keys # and map those symbols by using xmodmap. key "XF86AudioLowerVolume" amixer sset PCM 5%- key "XF86AudioRaiseVolume" amixer sset PCM 5%+ key "XF86AudioMute" amixer sset PCM 0% key "XF86HomePage" xdg-open about:blank key "XF86Search" xdg-open http://www.google.com key "XF86Eject" eject # display and select monitor setup configurations switchkey "Super+p" icewm-menu-xrandr
Locations for the
keys file are as follows:
IceWM is licensed under the GNU Library General Public License.
COPYING file in the distribution.