ICEWM-KEYS(5) | Standards, Environments and Macros | ICEWM-KEYS(5) |
icewm-keys - icewm keys configuration file
$ICEWM_PRIVCFG/keys $XDG_CONFIG_HOME/icewm/keys $HOME/.icewm/keys /etc/X11/icewm/keys /usr/share/icewm/keys
Global keybindings to launch applications, which need not be window manager related. If you are looking for ways to disable icewm's grabbing of default key combinations, please read icewm-preferences(5) instead.
Each non-empty line starts with the word "key". 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 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" icesh restart
See the output of "xmodmap -pk" for a list of keystroke names. To bind the mouse use "Pointer_Button1" for button 1, and so on. The command "icesh keys" instructs icewm to reload this file.
The syntax of the keys file is as follows:
Where,
options are the options and arguments passed to the program.
Following is the example keys file that ships with icewm(1):
# This is an example for IceWM's hotkey definition file. # # 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 https://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 whilst 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 https://www.google.com key "XF86Eject" eject # display and select monitor setup configurations switchkey "Super+p" icewm-menu-xrandr
Following shows how to add mouse button bindings on the root window to change the current workspace rolling the mouse wheel on the desktop:
key "Pointer_Button4" icesh goto prev key "Pointer_Button5" icesh goto next
These are key bindings for single window tile operations to replace the KeyWinArrange key bindings from the preferences file:
key "Ctrl+Alt+KP_Home" icesh -f sizeto 49% 49% top left key "Ctrl+Alt+KP_Up" icesh -f sizeto 100% 49% top left key "Ctrl+Alt+KP_Prior" icesh -f sizeto 49% 49% top right key "Ctrl+Alt+KP_Right" icesh -f sizeto 49% 100% top right key "Ctrl+Alt+KP_Next" icesh -f sizeto 49% 49% bottom right key "Ctrl+Alt+KP_Down" icesh -f sizeto 100% 49% bottom left key "Ctrl+Alt+KP_End" icesh -f sizeto 49% 49% bottom left key "Ctrl+Alt+KP_Left" icesh -f sizeto 49% 100% top left key "Ctrl+Alt+KP_Begin" icesh -f sizeto 49% 49% center
Locations for the keys file are as follows:
$ICEWM_PRIVCFG/keys $XDG_CONFIG_HOME/icewm/keys $HOME/.icewm/keys /etc/X11/icewm/keys /usr/share/icewm/keys
The locations are searched in the order listed; the first file found is read and the remainder ignored.
Brian Bidulock <mailto:bidulock@openss7.org>.
IceWM is licensed under the GNU Library General Public License. See the COPYING file in the distribution.
2023-02-05 | icewm 3.3.1 |