Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ICEWM-KEYS(5)	      Standards, Environments and Macros	 ICEWM-KEYS(5)

NAME
	icewm-keys - icewm keys	configuration file

SYNOPSIS
	$ICEWM_PRIVCFG/keys
	$XDG_CONFIG_HOME/icewm/keys
	$HOME/.icewm/keys
	/usr/local/etc/icewm/keys
	/usr/local/share/icewm/keys

DESCRIPTION
       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 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"	   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.

FORMAT
       The syntax of the keys file is as follows:

	   key "key_combination" program options

       Where,

       key The literal string keyword.

       switchkey
	   The literal string keyword, used as alternative to "key" to build
	   menu-like quickswitch popups.

       key_combination
	   A combination of modifiers and a key, separated by plus-sign	("+").

       program options
	   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.

EXAMPLES
       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 /usr/local/etc/icewm 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 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 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 https://www.google.com
	   key "XF86Eject" eject

	   # display and select	monitor	setup configurations
	   switchkey "Super+p" icewm-menu-xrandr

FILES
       Locations for the keys file are as follows:

	$ICEWM_PRIVCFG/keys
	$XDG_CONFIG_HOME/icewm/keys
	$HOME/.icewm/keys
	/usr/local/etc/icewm/keys
	/usr/local/share/icewm/keys

       The locations are searched in the order listed; the first file found is
       read and	the remainder ignored.

SEE ALSO
       icewm(1).

AUTHOR
       Brian Bidulock <mailto:bidulock@openss7.org>.

LICENSE
       IceWM is	licensed under the GNU Library General Public License.	See
       the COPYING file	in the distribution.

icewm 2.5.0			  2021-06-26			 ICEWM-KEYS(5)

NAME | SYNOPSIS | DESCRIPTION | FORMAT | EXAMPLES | FILES | SEE ALSO | AUTHOR | LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=icewm-keys&sektion=5&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help