<?xml version="1.0" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<title>Standards, Environments and Macros</title>
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:root@localhost" />
</head>
<body id="_podtop_">
<table border="0" width="100%" cellspacing="0" cellpadding="3">
<tr><td class="_podblock_" style="background-color: #cccccc; color: #000" valign="middle">
<big><strong><span class="_podblock_"> Standards, Environments and Macros</span></strong></big>
</td></tr>
</table>
<a href="#_podtop_"><h1 id="NAME">NAME</h1></a>
<pre><code> icewm-keys - icewm keys configuration file</code></pre>
<a href="#_podtop_"><h1 id="SYNOPSIS">SYNOPSIS</h1></a>
<dl>
<dt id="ICEWM_PRIVCFG-keys"><i>$ICEWM_PRIVCFG/keys</i></dt>
<dd>
</dd>
<dt id="XDG_CONFIG_HOME-icewm-keys"><i>$XDG_CONFIG_HOME/icewm/keys</i></dt>
<dd>
</dd>
<dt id="HOME-.icewm-keys"><i>$HOME/.icewm/keys</i></dt>
<dd>
</dd>
<dt id="etc-icewm-keys"><i>/etc/icewm/keys</i></dt>
<dd>
</dd>
<dt id="usr-share-icewm-keys"><i>/usr/share/icewm/keys</i></dt>
<dd>
</dd>
</dl>
<a href="#_podtop_"><h1 id="DESCRIPTION">DESCRIPTION</h1></a>
<p>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 <i>keys</i> file.</p>
<p>Global keybindings to launch applications, which need not be window manager related. Each non-empty line starts with the word <code>key</code>. After one or more spaces follows a double-quoted string of the bound X11 key combination like <code>Alt+Ctrl+Shift+X</code>. Then after at least one space follows a shell command line which will be executed by <b>icewm</b> whenever this key combination is pressed. For example, the following line creates a hotkey to reload the <b>icewm</b> configuration:</p>
<pre><code> key "Ctrl+Shift+r" pkill -x -HUP icewm</code></pre>
<a href="#_podtop_"><h1 id="FORMAT">FORMAT</h1></a>
<p>The syntax of the <i>keys</i> file is as follows:</p>
<ul>
<dl>
<dt id="key-key_combination-program-options"><b>key</b> <b>"</b><i>key_combination</i><b>"</b> <i>program</i> <i>options</i></dt>
<dd>
</dd>
</dl>
</ul>
<p>Where,</p>
<dl>
<dt id="key"><b>key</b></dt>
<dd>
<p>The literal string keyword.</p>
</dd>
<dt id="switchkey"><b>switchkey</b></dt>
<dd>
<p>The literal string keyword, used as alternative to <code>key</code> to build menu-like quickswitch popups.</p>
</dd>
<dt id="key_combination"><i>key_combination</i></dt>
<dd>
<p>Any combination of keys, separated by plus-sign (<code>+</code>).</p>
</dd>
<dt id="program-options"><i>program</i> <i>options</i></dt>
<dd>
<p><i>program</i> 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 <b>switchkey</b> keyword, the <i>program</i> must print on standard output the contents of the popup like it would be used for dynamic menus.</p>
<p><i>options</i> is the options and arguments passed to the <i>program</i> verbatim.</p>
</dd>
</dl>
<a href="#_podtop_"><h1 id="EXAMPLES">EXAMPLES</h1></a>
<p>Following is the example <i>keys</i> file that ships with <a href="icewm.1.html">icewm(1)</a>:</p>
<pre><code> # 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 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</code></pre>
<a href="#_podtop_"><h1 id="FILES">FILES</h1></a>
<p>Locations for the <i>keys</i> file are as follows:</p>
<dl>
<dt id="ICEWM_PRIVCFG-keys1"><i>$ICEWM_PRIVCFG/keys</i></dt>
<dd>
</dd>
<dt id="XDG_CONFIG_HOME-icewm-keys1"><i>$XDG_CONFIG_HOME/icewm/keys</i></dt>
<dd>
</dd>
<dt id="HOME-.icewm-keys1"><i>$HOME/.icewm/keys</i></dt>
<dd>
</dd>
<dt id="etc-icewm-keys1"><i>/etc/icewm/keys</i></dt>
<dd>
</dd>
<dt id="usr-share-icewm-keys1"><i>/usr/share/icewm/keys</i></dt>
<dd>
</dd>
</dl>
<a href="#_podtop_"><h1 id="SEE-ALSO">SEE ALSO</h1></a>
<p><a href="icewm.1.html">icewm(1)</a>.</p>
<a href="#_podtop_"><h1 id="AUTHOR">AUTHOR</h1></a>
<p>Brian Bidulock <a href="mailto:bidulock@openss7.org">mailto:bidulock@openss7.org</a>.</p>
<a href="#_podtop_"><h1 id="LICENSE">LICENSE</h1></a>
<p><b>IceWM</b> is licensed under the GNU Library General Public License. See the <i>COPYING</i> file in the distribution.</p>
<table border="0" width="100%" cellspacing="0" cellpadding="3">
<tr><td class="_podblock_" style="background-color: #cccccc; color: #000" valign="middle">
<big><strong><span class="_podblock_"> Standards, Environments and Macros</span></strong></big>
</td></tr>
</table>
</body>
</html>
distrib
>
Mageia
>
7
>
armv7hl
>
media
>
core-release
>
by-pkgid
>
402607c61c3b7824dac91e3798227f4a
>
files
>
40
