| 1 |
.\" -*- mode: troff; coding: utf-8 -*- |
| 2 |
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45) |
| 3 |
.\" |
| 4 |
.\" Standard preamble: |
| 5 |
.\" ======================================================================== |
| 6 |
.de Sp \" Vertical space (when we can't use .PP) |
| 7 |
.if t .sp .5v |
| 8 |
.if n .sp |
| 9 |
.. |
| 10 |
.de Vb \" Begin verbatim text |
| 11 |
.ft CW |
| 12 |
.nf |
| 13 |
.ne \\$1 |
| 14 |
.. |
| 15 |
.de Ve \" End verbatim text |
| 16 |
.ft R |
| 17 |
.fi |
| 18 |
.. |
| 19 |
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. |
| 20 |
.ie n \{\ |
| 21 |
. ds C` "" |
| 22 |
. ds C' "" |
| 23 |
'br\} |
| 24 |
.el\{\ |
| 25 |
. ds C` |
| 26 |
. ds C' |
| 27 |
'br\} |
| 28 |
.\" |
| 29 |
.\" Escape single quotes in literal strings from groff's Unicode transform. |
| 30 |
.ie \n(.g .ds Aq \(aq |
| 31 |
.el .ds Aq ' |
| 32 |
.\" |
| 33 |
.\" If the F register is >0, we'll generate index entries on stderr for |
| 34 |
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
| 35 |
.\" entries marked with X<> in POD. Of course, you'll have to process the |
| 36 |
.\" output yourself in some meaningful fashion. |
| 37 |
.\" |
| 38 |
.\" Avoid warning from groff about undefined register 'F'. |
| 39 |
.de IX |
| 40 |
.. |
| 41 |
.nr rF 0 |
| 42 |
.if \n(.g .if rF .nr rF 1 |
| 43 |
.if (\n(rF:(\n(.g==0)) \{\ |
| 44 |
. if \nF \{\ |
| 45 |
. de IX |
| 46 |
. tm Index:\\$1\t\\n%\t"\\$2" |
| 47 |
.. |
| 48 |
. if !\nF==2 \{\ |
| 49 |
. nr % 0 |
| 50 |
. nr F 2 |
| 51 |
. \} |
| 52 |
. \} |
| 53 |
.\} |
| 54 |
.rr rF |
| 55 |
.\" ======================================================================== |
| 56 |
.\" |
| 57 |
.IX Title "ICEWM 1" |
| 58 |
.TH ICEWM 1 2026-01-18 "icewm\ 4.0.0" "User Commands" |
| 59 |
.\" For nroff, turn off justification. Always turn off hyphenation; it makes |
| 60 |
.\" way too many mistakes in technical documents. |
| 61 |
.if n .ad l |
| 62 |
.nh |
| 63 |
.SS NAME |
| 64 |
.IX Subsection "NAME" |
| 65 |
.Vb 1 |
| 66 |
\& icewm \- lightweight X11 window manager |
| 67 |
.Ve |
| 68 |
.SS SYNOPSIS |
| 69 |
.IX Subsection "SYNOPSIS" |
| 70 |
\&\fBicewm\fR [\fIOPTIONS\fR] |
| 71 |
.SS DESCRIPTION |
| 72 |
.IX Subsection "DESCRIPTION" |
| 73 |
\&\fBicewm\fR is a small and fast window manager for the X11 window system. It |
| 74 |
is best started by \fBicewm\-session\fR\|(1), which also starts \fBicewmbg\fR\|(1). |
| 75 |
.PP |
| 76 |
\&\fBicewm\fR is called \fIre-parenting\fR, because it draws frames around |
| 77 |
application windows. Drag this frame with the mouse, to move or resize |
| 78 |
a window. |
| 79 |
.PP |
| 80 |
Because windows may overlap, \fBicewm\fR is also a stacking window manager. |
| 81 |
Many windows may exist, some hidden behind others. |
| 82 |
.PP |
| 83 |
\&\fBicewm\fR supports a configurable number of virtual desktops. These are |
| 84 |
called workspaces. Related windows are grouped on a dedicated workspace. |
| 85 |
By switching between workspaces, the user can attend to different tasks, |
| 86 |
while keeping oversight. This is supported by a task bar and a pager. |
| 87 |
.PP |
| 88 |
The installation comes with several themes. Choose a theme via a menu. |
| 89 |
Install extra themes automatically with the \fB\-\-install\fR option. |
| 90 |
.PP |
| 91 |
\&\fBicewm\fR is compliant with the ICCCM and EWMH window manager specifications. |
| 92 |
.SS PROGRAMS |
| 93 |
.IX Subsection "PROGRAMS" |
| 94 |
The \fBicewm\fR package includes several programs: |
| 95 |
.IP \fBicewm\fR\|(1) 4 |
| 96 |
.IX Item "icewm" |
| 97 |
The actual window manager. It positions application windows on screen |
| 98 |
and decorates them with borders. It gives input focus to the current |
| 99 |
active application. \fBicewm\fR supports different focus modes, which are |
| 100 |
explained below. It draws a small task bar at the bottom of the screen, |
| 101 |
that gives easy access to programs, to virtual desktops, to active |
| 102 |
applications, and to a small set of monitoring applets. |
| 103 |
.IP \fBicewmbg\fR\|(1) 4 |
| 104 |
.IX Item "icewmbg" |
| 105 |
The background setting application. It can assign plain background color |
| 106 |
or images in different formats to the X background. Each workspace can |
| 107 |
have its own background. It supports semitransparency. Semitransparent |
| 108 |
background image and colour can be configured. When the background image |
| 109 |
has changed then \fBicewmbg\fR\|(1) can be notified to update the background. |
| 110 |
Multi-head monitor setups are fully supported. See the \fBicewmbg\fR\|(1). |
| 111 |
.IP \fBicewm\-session\fR\|(1) 4 |
| 112 |
.IX Item "icewm-session" |
| 113 |
\&\fBicewm\-session\fR\|(1) is the preferred program to start the IceWM system. |
| 114 |
It first loads additional environment variables from the optional |
| 115 |
\&\fIenv\fR file. Then it starts \fBicewmbg\fR\|(1) and \fBicewm\fR. It also runs |
| 116 |
the \fIstartup\fR script and implements basic session management. |
| 117 |
On termination the \fIshutdown\fR script will be run first, then |
| 118 |
\&\fBicewm\-session\fR\|(1) will terminate \fBicewm\fR and \fBicewmbg\fR\|(1). |
| 119 |
\&\fBicewm\-session\fR\|(1) will also start the optional \fBicesound\fR\|(1) |
| 120 |
if you give it the \fB\-\-sound\fR option. See \fBicewm\-session\fR\|(1). |
| 121 |
.IP \fBicesh\fR\|(1) 4 |
| 122 |
.IX Item "icesh" |
| 123 |
A powerful tool to control window properties and to interact with the |
| 124 |
window manager. It is typically used in shell scripts. See \fBicesh\fR\|(1). |
| 125 |
.IP \fBicehelp\fR\|(1) 4 |
| 126 |
.IX Item "icehelp" |
| 127 |
A small document browser that is used by \fBicewm\fR to display the |
| 128 |
\&'IceWM manual' and some man pages. |
| 129 |
.IP \fBicewmhint\fR\|(1) 4 |
| 130 |
.IX Item "icewmhint" |
| 131 |
A utility for passing IceWM-specific window options to \fBicewm\fR. |
| 132 |
The options are used to configure the first application that is started |
| 133 |
subsequently. See \fBicewmhint\fR\|(1). |
| 134 |
.IP \fBicesound\fR\|(1) 4 |
| 135 |
.IX Item "icesound" |
| 136 |
Plays audio files on GUI events that are raised by \fBicewm\fR. |
| 137 |
It supports ALSA, AO and OSS. See the \fBicesound\fR\|(1) man page. |
| 138 |
.IP \fBicewm\-menu\-fdo\fR\|(1) 4 |
| 139 |
.IX Item "icewm-menu-fdo" |
| 140 |
Generate an \fBicewm\fR menu with executable desktop applications |
| 141 |
according to XDG specifications. See the \fBicewm\-menu\-fdo\fR\|(1) man page. |
| 142 |
.IP \fBicewm\-set\-gnomewm\fR\|(1) 4 |
| 143 |
.IX Item "icewm-set-gnomewm" |
| 144 |
Configures GNOME to start IceWM instead of its own WM. |
| 145 |
.SS OPTIONS |
| 146 |
.IX Subsection "OPTIONS" |
| 147 |
.SS "COMMON OPTIONS" |
| 148 |
.IX Subsection "COMMON OPTIONS" |
| 149 |
Each of the IceWM executables supports the following options: |
| 150 |
.IP "\fB\-c\fR, \fB\-\-config\fR=\fIFILE\fR" 4 |
| 151 |
.IX Item "-c, --config=FILE" |
| 152 |
Use \fIFILE\fR as the source of configuration options. By default \fBicewm\fR |
| 153 |
looks for a file named \fIpreferences\fR. This is a readable text file |
| 154 |
that can be modified with the help of a text editor. |
| 155 |
.IP "\fB\-t\fR, \fB\-\-theme\fR=\fINAME\fR" 4 |
| 156 |
.IX Item "-t, --theme=NAME" |
| 157 |
Use \fINAME\fR as the name of the \fBicewm\fR theme to use. A theme defines |
| 158 |
the look and feel of \fBicewm\fR, like colors, fonts and buttons. |
| 159 |
.IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4 |
| 160 |
.IX Item "-d, --display=DISPLAY" |
| 161 |
Connect to the X11 server on \fIDISPLAY\fR. By default |
| 162 |
the environment variable \f(CW\*(C`DISPLAY\*(C'\fR is used. |
| 163 |
.IP "\fB\-o\fR, \fB\-\-output=FILE\fR" 4 |
| 164 |
.IX Item "-o, --output=FILE" |
| 165 |
Redirect all output to \fIFILE\fR. |
| 166 |
A leading tilde or environment variable is expanded. |
| 167 |
.IP \fB\-\-sync\fR 4 |
| 168 |
.IX Item "--sync" |
| 169 |
This option specifies to use a slower synchronous communication mode |
| 170 |
with the X11 server. This is irrelevant for normal use. |
| 171 |
.IP "\fB\-h\fR, \fB\-\-help\fR" 4 |
| 172 |
.IX Item "-h, --help" |
| 173 |
Gives a complete list of all the available command-line options with |
| 174 |
some very brief explanation. |
| 175 |
.IP "\fB\-V\fR, \fB\-\-version\fR" 4 |
| 176 |
.IX Item "-V, --version" |
| 177 |
Shows the software release version for this program. |
| 178 |
.SS "ICEWM OPTIONS" |
| 179 |
.IX Subsection "ICEWM OPTIONS" |
| 180 |
The \fBicewm\fR program supports some additional options: |
| 181 |
.IP "\fB\-a\fR, \fB\-\-alpha\fR" 4 |
| 182 |
.IX Item "-a, --alpha" |
| 183 |
Use a 32\-bit visual for translucency. This can also be set in |
| 184 |
the preferences file as \f(CW\*(C`Alpha=1\*(C'\fR. |
| 185 |
.IP \fB\-\-replace\fR 4 |
| 186 |
.IX Item "--replace" |
| 187 |
Instructs \fBicewm\fR to replace an existing window manager. Provided that |
| 188 |
the window manager being replaced is ICCCM 2.0 compliant, once it |
| 189 |
notices that it is to be replaced it will cease operations and typically |
| 190 |
stop execution. This allows \fBicewm\fR to establish itself as the only |
| 191 |
active window manager. |
| 192 |
.IP "\fB\-r\fR, \fB\-\-restart\fR" 4 |
| 193 |
.IX Item "-r, --restart" |
| 194 |
Tell \fBicewm\fR to restart itself. This reloads the configuration from |
| 195 |
file. If no window manager is active, then it starts one. |
| 196 |
.IP "\fB\-s\fR, \fB\-\-splash\fR=\fIIMAGE\fR" 4 |
| 197 |
.IX Item "-s, --splash=IMAGE" |
| 198 |
Briefly show \fIIMAGE\fR on startup in the center of the screen. |
| 199 |
This can also be set in the preferences file as Splash=\f(CW\*(C`image.jpg\*(C'\fR. |
| 200 |
.IP \fB\-\-configured\fR 4 |
| 201 |
.IX Item "--configured" |
| 202 |
Shows a list of configuration options that were enabled when \fBicewm\fR |
| 203 |
was compiled from source code. This can be helpful if one suspects some |
| 204 |
functionality may be missing. |
| 205 |
.IP \fB\-\-directories\fR 4 |
| 206 |
.IX Item "--directories" |
| 207 |
Gives a list of directories where \fBicewm\fR will look for configuration |
| 208 |
data. This list is printed in the actual order in which \fBicewm\fR uses |
| 209 |
it to search for configuration files. |
| 210 |
.IP "\fB\-l\fR, \fB\-\-list\-themes\fR" 4 |
| 211 |
.IX Item "-l, --list-themes" |
| 212 |
\&\fBicewm\fR will search all the configuration directories for theme files |
| 213 |
and print a list of all found themes. |
| 214 |
.IP "\fB\-i\fR, \fB\-\-install\fR=\fITHEME\fR" 4 |
| 215 |
.IX Item "-i, --install=THEME" |
| 216 |
Install \fITHEME\fR from icewm-extra and exit. When \fITHEME\fR is \fIlist\fR, |
| 217 |
print a listing of available themes to install. This option requires |
| 218 |
the presence of the \fIlzip\fR, \fItar\fR and \fIwget\fR or \fIcurl\fR commands. |
| 219 |
.IP "\fB\-p\fR, \fB\-\-postpreferences\fR" 4 |
| 220 |
.IX Item "-p, --postpreferences" |
| 221 |
This gives a long list of all the internal \fBicewm\fR options with their |
| 222 |
actual values after \fBicewm\fR has processed all of the configuration and |
| 223 |
theme files. In some advanced scenarios this can be helpful to inspect |
| 224 |
which configuration was chosen or whether option formatting was correct. |
| 225 |
.IP \fB\-\-rewrite\-preferences\fR 4 |
| 226 |
.IX Item "--rewrite-preferences" |
| 227 |
Overwrite an existing preferences file with an icewm default preferences, |
| 228 |
but preserve all modifications insofar they deviate from the defaults. |
| 229 |
.IP \fB\-\-extensions\fR 4 |
| 230 |
.IX Item "--extensions" |
| 231 |
Give a list of the current X extensions, their versions and status. |
| 232 |
.IP \fB\-\-trace\fR=\fIconf\fR,\fIfont\fR,\fIicon\fR,\fIprog\fR,\fIsystray\fR 4 |
| 233 |
.IX Item "--trace=conf,font,icon,prog,systray" |
| 234 |
Enable tracing of the paths that are used to load configuration, |
| 235 |
fonts, icons, executed programs, and/or system tray applets. |
| 236 |
.SS USAGE |
| 237 |
.IX Subsection "USAGE" |
| 238 |
.SS TASKBAR |
| 239 |
.IX Subsection "TASKBAR" |
| 240 |
On startup \fBicewm\fR launches the task bar at the bottom of the screen. |
| 241 |
The task bar consists from left to right of the following components: |
| 242 |
.PP |
| 243 |
The \fIMenu\fR button in the lower left corner gives access to the \fBicewm\fR |
| 244 |
root menu. This menu has sub-menus to start applications, to control |
| 245 |
\&\fBicewm\fR settings, and the \fBicewm\fR \fILogout\fR menu. |
| 246 |
.PP |
| 247 |
The \fIShow Desktop\fR button unmaps all application windows to fully |
| 248 |
uncover the desktop. |
| 249 |
.PP |
| 250 |
The \fIWindow List Menu\fR button gives access to a menu with a list of |
| 251 |
active windows for the current workspace and a list of workspaces |
| 252 |
with sub-menus for their active application windows. |
| 253 |
.PP |
| 254 |
The \fIToolbar\fR is a list of icons for applications that are defined in |
| 255 |
the toolbar configuration file. |
| 256 |
.PP |
| 257 |
The \fIWorkspace Pane\fR shows one button for each workspace. The current |
| 258 |
workspace is indicated by a pressed button. Clicking another workspace |
| 259 |
switches to that workspace. Press left mouse, then the Shift key, then |
| 260 |
release the left mouse, takes the current window to that workspace. |
| 261 |
Press left, then Alt, then release left, moves only the focused window |
| 262 |
to other workspace, without changing the current workspace. |
| 263 |
.PP |
| 264 |
The workspaces are defined in the \fIpreferences\fR file. To change a name |
| 265 |
for only this session, double-click, edit the name and hit Enter. |
| 266 |
When \f(CW\*(C`PagerShowPreview\*(C'\fR is turned on, a small graphical window summary |
| 267 |
for each workspace is shown. They support drag-and-drop: dragging a |
| 268 |
Firefox tab to a workspace button changes the current workspace. |
| 269 |
Then releasing it moves that tab to a new window in that workspace. |
| 270 |
.PP |
| 271 |
The \fITask Pane\fR consists of a list of wide buttons for each application |
| 272 |
that is running on the current workspace, or all workspaces if |
| 273 |
\&\f(CW\*(C`TaskBarShowAllWindows=1\*(C'\fR. Each task button shows the |
| 274 |
application icon and the application title. The active application is |
| 275 |
indicated by a pressed button. This is the application that has input |
| 276 |
focus. Clicking another button activates that application: it is |
| 277 |
brought to the foreground and receives input focus. Clicking the button |
| 278 |
of an active application minimizes it. To minimize an inactive application, |
| 279 |
click its button while \f(CW\*(C`Ctrl\*(C'\fR is down. |
| 280 |
.PP |
| 281 |
The window buttons can be dragged with the left mouse button to rearrange |
| 282 |
their order. A window can be closed with \f(CW\*(C`Alt\*(C'\fR + middle button, lowered |
| 283 |
with \f(CW\*(C`Ctrl\*(C'\fR + middle button, or brought to the current workspace with |
| 284 |
\&\f(CW\*(C`Shift\*(C'\fR + middle button when \f(CW\*(C`TaskBarShowAllWindows=1\*(C'\fR. |
| 285 |
.PP |
| 286 |
If there are not many application buttons then a stretch of plain task |
| 287 |
bar is visible. Clicking on it with the right mouse button gives the |
| 288 |
task bar menu. Even with a full task pane, this menu can be usually |
| 289 |
accessed by right-clicking the bottom right corner of the taskbar. |
| 290 |
.PP |
| 291 |
The \fITray Applet\fR shows system tray objects. |
| 292 |
.PP |
| 293 |
The \fIAPM Applet\fR shows battery power status. |
| 294 |
.PP |
| 295 |
The \fINet Applet\fR shows network activity. Network devices to monitor |
| 296 |
are given by the \f(CW\*(C`NetworkStatusDevice\*(C'\fR option. |
| 297 |
.PP |
| 298 |
The \fIMemory Applet\fR monitors memory usage. |
| 299 |
.PP |
| 300 |
The \fICPU Applet\fR monitors processor utilization. |
| 301 |
.PP |
| 302 |
The \fIMailbox Applet\fR monitors mailbox status changes. |
| 303 |
See the section MAILBOX MONITORING below. |
| 304 |
.PP |
| 305 |
The \fIClock Applet\fR shows the current time and date. It is configured |
| 306 |
by the \f(CW\*(C`TimeFormat\*(C'\fR option. |
| 307 |
.PP |
| 308 |
The \fITask Bar Collapse\fR button collapses the task bar and hides it. |
| 309 |
.PP |
| 310 |
Not all \fBicewm\fR applets may show up on the task bar. They must have |
| 311 |
been enabled during configuration of the \fBicewm\fR software. Their |
| 312 |
appearance is also controlled by options in the \fIpreferences\fR file. |
| 313 |
.SS "INPUT FOCUS" |
| 314 |
.IX Subsection "INPUT FOCUS" |
| 315 |
Of all visible windows only one can be the active window. This is the |
| 316 |
window that has input focus. It is the primary receiver of keyboard |
| 317 |
and mouse events and hence one can interact with the application that |
| 318 |
created that window. A primary task of a window manager is to allow the |
| 319 |
user to switch input focus between different windows. The primary means |
| 320 |
to do this is the mouse pointer. By moving the mouse pointer over the |
| 321 |
screen to another window, and perhaps also by clicking on a window, |
| 322 |
input focus can be directed. |
| 323 |
.PP |
| 324 |
The \f(CW\*(C`FocusMode\*(C'\fR option controls the way \fBicewm\fR gives input focus to |
| 325 |
applications. It is initialized by the \fIfocus_mode\fR configuration |
| 326 |
file. The focus mode is set via the \fIFocus\fR menu. \fBicewm\fR supports |
| 327 |
six focus models: |
| 328 |
.IP "\fB1. Click-to-focus\fR" 4 |
| 329 |
.IX Item "1. Click-to-focus" |
| 330 |
The default focus mode. In this mode changing input focus requires to |
| 331 |
click a window with the left mouse button. The window is raised if |
| 332 |
needed. When an application requests focus its task pane button |
| 333 |
flashes. This gives the option to honor this request or to ignore it. |
| 334 |
When a new application window appears it automatically receives focus. |
| 335 |
Also when a hidden application raises to the front it receives focus. |
| 336 |
.IP "\fB2. Sloppy-mouse-focus\fR" 4 |
| 337 |
.IX Item "2. Sloppy-mouse-focus" |
| 338 |
Sets input focus merely by moving the mouse pointer over a window. It |
| 339 |
is called sloppy, because if the mouse then leaves the window and moves |
| 340 |
to the desktop background the input focus remains with the last active |
| 341 |
window. When a window receives focus it is raised. When an application |
| 342 |
requests focus its task pane button flashes. A new application or an |
| 343 |
application that raises to the front automatically receives focus. |
| 344 |
.IP "\fB3. Explicit-focus\fR" 4 |
| 345 |
.IX Item "3. Explicit-focus" |
| 346 |
Focus is even more user-controlled than \fBClick-to-focus\fR. When a |
| 347 |
window receives focus it is not raised by default, unless the frame |
| 348 |
border is clicked. No flashing occurs when an application requests |
| 349 |
focus. When a new application window appears it does not receive focus. |
| 350 |
Only by explicit clicking on a window is focus directed. |
| 351 |
.IP "\fB4. Strict-mouse-focus\fR" 4 |
| 352 |
.IX Item "4. Strict-mouse-focus" |
| 353 |
Like \fBSloppy\fR but focus remains with the last window. New applications |
| 354 |
don't receive focus and are mapped behind other windows. When an |
| 355 |
application raises to the front it still does not get focus. |
| 356 |
.IP "\fB5. Quiet-sloppy-focus\fR" 4 |
| 357 |
.IX Item "5. Quiet-sloppy-focus" |
| 358 |
Like \fBSloppy\fR but no disturbing flashing occurs on the task bar when an |
| 359 |
application requests focus. |
| 360 |
.IP "\fB6. Custom-mode\fR" 4 |
| 361 |
.IX Item "6. Custom-mode" |
| 362 |
A focus mode that is defined by the following ten options: |
| 363 |
\&\f(CW\*(C`ClickToFocus\*(C'\fR, |
| 364 |
\&\f(CW\*(C`FocusOnAppRaise\*(C'\fR, |
| 365 |
\&\f(CW\*(C`RequestFocusOnAppRaise\*(C'\fR, |
| 366 |
\&\f(CW\*(C`RaiseOnFocus\*(C'\fR, |
| 367 |
\&\f(CW\*(C`RaiseOnClickClient\*(C'\fR, |
| 368 |
\&\f(CW\*(C`FocusChangesWorkspace\*(C'\fR, |
| 369 |
\&\f(CW\*(C`FocusOnMap\*(C'\fR, |
| 370 |
\&\f(CW\*(C`FocusOnMapTransient\*(C'\fR, |
| 371 |
\&\f(CW\*(C`FocusOnMapTransientActive\*(C'\fR, |
| 372 |
\&\f(CW\*(C`MapInactiveOnTop\*(C'\fR. |
| 373 |
.Sp |
| 374 |
All non-Custom focus modes override these ten options. |
| 375 |
.PP |
| 376 |
Apart from the mouse, \fBicewm\fR supports changing input focus in two |
| 377 |
ways by keyboard. By pressing \f(CW\*(C`Alt+Esc\*(C'\fR or \f(CW\*(C`Alt+Shift+Esc\*(C'\fR, |
| 378 |
input focus is immediately changed to the next or previous window, |
| 379 |
which will be raised to make it fully visible. The other method |
| 380 |
involves the quick switch. |
| 381 |
.SS "QUICK SWITCH" |
| 382 |
.IX Subsection "QUICK SWITCH" |
| 383 |
The \fBQuickSwitch\fR is a means to quickly and interactively change |
| 384 |
the input focus to another window. It is activated by pressing the |
| 385 |
\&\f(CW\*(C`Alt+Tab\*(C'\fR or \f(CW\*(C`Alt+Shift+Tab\*(C'\fR key combination. A window pops up |
| 386 |
in the centre of the screen with a list of windows to choose from. |
| 387 |
A narrow band indicates a selection: the candidate window that will |
| 388 |
be activated to receive input focus when the Alt key is released. |
| 389 |
.PP |
| 390 |
The selection can be changed by repeatedly pressing the Tab key, while |
| 391 |
keeping the Alt key down. If a Shift key is also down, the direction of |
| 392 |
traversal is reversed. Or use the scroll wheel of the mouse. Or use |
| 393 |
one of the digit keys to select the corresponding window from the list. |
| 394 |
By pressing the first letter of the application class name, the next |
| 395 |
such application is selected. All navigation keys are also supported. |
| 396 |
.PP |
| 397 |
To make a selected window the active window, just release the Alt key, |
| 398 |
or hit the Return key, or click on it. To cancel the QuickSwitch, |
| 399 |
press Escape or click outside of the QuickSwitch window. |
| 400 |
.PP |
| 401 |
A selected window can be closed by Delete, \f(CW\*(C`Alt+F4\*(C'\fR, or the middle |
| 402 |
mouse button. The right mouse button opens the system menu for the |
| 403 |
selected window. While the QuickSwitch window is up, one can still |
| 404 |
change workspace with the usual workspace hotkeys. |
| 405 |
.PP |
| 406 |
The QuickSwitch has three distinct modes: vertical, horizontal and |
| 407 |
preview. The window list can include all windows or be limited to |
| 408 |
the current workspace. There is an option to raise the selected |
| 409 |
candidate. See the many preferences available for the QuickSwitch. |
| 410 |
.PP |
| 411 |
The preview mode shows a small preview window for every application |
| 412 |
window that has been shown earlier by icewm. When the preview quick |
| 413 |
switch is active, this preview is continuously updated. This mode works |
| 414 |
best with a desktop background manager that updates the \f(CW\*(C`_XROOTPMAP_ID\*(C'\fR |
| 415 |
property on the root window, such as \fBicewmbg\fR\|(1), \fBnitrogen\fR\|(1), |
| 416 |
\&\fBhsetroot\fR\|(1) or \fBfeh\fR\|(1). |
| 417 |
.SS "WINDOW PLACEMENT" |
| 418 |
.IX Subsection "WINDOW PLACEMENT" |
| 419 |
A second important task of a window manager is to place new windows on |
| 420 |
the screen. By default \fBicewm\fR chooses a placement with minimal |
| 421 |
overlap, but this is determined by the \f(CW\*(C`SmartPlacement\*(C'\fR option in the |
| 422 |
\&\fIpreferences\fR file. If \f(CW\*(C`SmartPlacement\*(C'\fR is turned off then windows |
| 423 |
are placed in sequence from left to right and top to bottom. One can |
| 424 |
also turn on \f(CW\*(C`ManualPlacement\*(C'\fR. Then new windows appear initially in |
| 425 |
the top left corner and the mouse cursor changes into a fist. By moving |
| 426 |
the fist cursor to a suitable location and clicking the new window will |
| 427 |
appear at the mouse click location. |
| 428 |
.SS "WINDOW LAYERS" |
| 429 |
.IX Subsection "WINDOW LAYERS" |
| 430 |
Windows can overlap. Which window appears on top is determined by three |
| 431 |
features. Newer windows appear over older windows. By clicking on a |
| 432 |
window it is raised to the top. But both are overruled by the window |
| 433 |
layer. Windows can be placed in different layers via the \fILayers\fR |
| 434 |
menu. Click with the right mouse button on the window frame and select |
| 435 |
\&\fILayer\fR. From there choose one of seven window layers. These are |
| 436 |
ordered from higher to lower. Windows in higher layers appear over |
| 437 |
windows in lower layers. |
| 438 |
.PP |
| 439 |
There are 16 layers in total, but most are seldom or never used. They |
| 440 |
are numbered from zero for the lowest layer to fifteen for the topmost. |
| 441 |
Their names with their layer number are: Desktop (0), Below (2), Normal |
| 442 |
(4), OnTop (6), Dock (8), AboveDock (10), Menu (12), Fullscreen (14) and |
| 443 |
AboveAll (15). By default every window appears in the \fINormal\fR layer. |
| 444 |
Then \fIBelow\fR and \fIOnTop\fR are used frequently to position windows below |
| 445 |
or above most others. Icewm menus appear in the \fIMenu\fR layer and the |
| 446 |
\&\fIFullscreen\fR layer is reserved for windows in the fullscreen mode. The |
| 447 |
default layer for each application can be set with a \fIwinoption\fR. |
| 448 |
.PP |
| 449 |
Windows placed in the \fIDock\fR layer can be set to be always visible by |
| 450 |
setting the \f(CW\*(C`LimitByDockLayer\*(C'\fR preference to 1. Then other windows are |
| 451 |
preferably not placed over such windows, unless they have explicit |
| 452 |
positioning information to do so. Maximized windows also don't overlap |
| 453 |
with these \fIDockLayer\fR windows. The \fIDoNotCover\fR winoption is similar. |
| 454 |
.SS "DOCKED APPLICATIONS" |
| 455 |
.IX Subsection "DOCKED APPLICATIONS" |
| 456 |
Icewm has native support for Window Maker dockapps. |
| 457 |
It has a Dock container called \fBDockApps\fR, which appears automatically |
| 458 |
when dockapps are started. The position and layer of this container are |
| 459 |
controlled by the \f(CW\*(C`DockApps\*(C'\fR preference. It is a space separated list |
| 460 |
of keywords. The keywords \f(CW\*(C`right, left, center, down, high\*(C'\fR control the |
| 461 |
position, while \f(CW\*(C`above, dock, ontop, normal, below, desktop\*(C'\fR set the |
| 462 |
layer. When \fBDockApps\fR is set to the empty string, support for dockapps |
| 463 |
is disabled. The dockapps in the container can be controlled using the |
| 464 |
mouse when the \fBCtrl\fR key is pressed down. Drag with the left mouse |
| 465 |
button, close with the middle mouse button, select a menu with the right |
| 466 |
mouse button and rotate with the scroll wheel. |
| 467 |
.PP |
| 468 |
If maximizing a window should not overlap the \fIDockApps\fR container, put |
| 469 |
it in the \fIdock\fR layer and set the preference \fBLimitByDockLayer=1\fR. |
| 470 |
.SS "TABBED WINDOWS" |
| 471 |
.IX Subsection "TABBED WINDOWS" |
| 472 |
A window frame may contain multiple client windows. Only one client can |
| 473 |
be visible, while the others are hidden. This is called tabbing. This |
| 474 |
can be helpful to reduce the number of visible windows. To create a tab, |
| 475 |
drag the title bar with the middle mouse button, while holding down a |
| 476 |
shift key, onto the title bar of another frame. The two title bars will |
| 477 |
start to flash to indicate that they can merge. Release the mouse button |
| 478 |
to merge the client of the upper window to the lower frame. Now the |
| 479 |
lower frame will have multiple clients, called tabs. The title bar will |
| 480 |
show a vertical bar with triple dots to indicate this. |
| 481 |
To change the current tab either: |
| 482 |
.IP \(bu 4 |
| 483 |
Click on the triple dots next to the vertical bar. |
| 484 |
.IP \(bu 4 |
| 485 |
Use \f(CW\*(C`KeyWinNext=Alt+F6\*(C'\fR to select the next tab. |
| 486 |
.IP \(bu 4 |
| 487 |
Use \f(CW\*(C`KeyWinPrev=Alt+Shift+F6\*(C'\fR for the previous tab. |
| 488 |
.IP \(bu 4 |
| 489 |
Use the QuickSwitch. |
| 490 |
.IP \(bu 4 |
| 491 |
Use the window list window. |
| 492 |
.IP \(bu 4 |
| 493 |
Use a submenu in the window menu. |
| 494 |
.PP |
| 495 |
To change the mouse binding for creating tabs, modify |
| 496 |
\&\fBMouseWinTabbing\fR=\f(CW\*(C`Shift+Pointer_Button2\*(C'\fR. Another |
| 497 |
useful setting is \fBMouseWinTabbing\fR=\f(CW\*(C`Pointer_Button1\*(C'\fR. |
| 498 |
.PP |
| 499 |
\&\f(CW\*(C`Alt+F4\*(C'\fR closes all tabs. To close just the active tab add to \f(CW\*(C`keys\*(C'\fR: |
| 500 |
.PP |
| 501 |
.Vb 1 |
| 502 |
\& key "Ctrl+Shift+F4" icesh \-f close |
| 503 |
.Ve |
| 504 |
.PP |
| 505 |
To move the active tab to its own window frame by key, add to \f(CW\*(C`keys\*(C'\fR: |
| 506 |
.PP |
| 507 |
.Vb 1 |
| 508 |
\& key "Alt+u" icesh \-f untab |
| 509 |
.Ve |
| 510 |
.PP |
| 511 |
To open all chrome windows in the same frame add this to \f(CW\*(C`winoptions\*(C'\fR: |
| 512 |
.PP |
| 513 |
.Vb 1 |
| 514 |
\& google\-chrome.frame: chrome |
| 515 |
.Ve |
| 516 |
.SS WORKSPACES |
| 517 |
.IX Subsection "WORKSPACES" |
| 518 |
\&\fBicewm\fR supports multiple virtual desktops called workspaces. A |
| 519 |
workspace is like a screen where a subset of all application windows are |
| 520 |
mapped. Thanks to multiple workspaces we can more easily manage a |
| 521 |
large number of applications. The number of workspaces and their names |
| 522 |
are configurable in the \fIpreferences\fR file through the |
| 523 |
\&\f(CW\*(C`WorkspaceNames\*(C'\fR option. By default four workspaces are created |
| 524 |
with the names 1, 2, 3 and 4 thus: |
| 525 |
.PP |
| 526 |
.Vb 1 |
| 527 |
\& WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 " |
| 528 |
.Ve |
| 529 |
.PP |
| 530 |
This syntax is typical for \fBicewm\fR options that receive multiple |
| 531 |
values. It is a list of comma-separated values each of which can be |
| 532 |
quoted. |
| 533 |
.PP |
| 534 |
The workspaces are visible on the toolbar. One can switch to a |
| 535 |
different workspace by pressing the workspace button in the toolbar, |
| 536 |
but after becoming familiar with the 'keyboard shortcuts' below one will |
| 537 |
want to use a hotkey to choose a workspace. If the \f(CW\*(C`EdgeSwitch\*(C'\fR |
| 538 |
options is enabled in the \fIpreferences\fR file (with sub-options |
| 539 |
\&\f(CW\*(C`HorizontalEdgeSwitch\*(C'\fR and \f(CW\*(C`VerticalEdgeSwitch\*(C'\fR) then one can move to |
| 540 |
the next or previous workspace by moving the mouse to the edge of the |
| 541 |
screen. The \f(CW\*(C`ContinuousEdgeSwitch\*(C'\fR option enables continuous movement |
| 542 |
to subsequent workspaces. The \f(CW\*(C`EdgeSwitchDelay\*(C'\fR option says how long |
| 543 |
to wait before a change of workspace occurs. |
| 544 |
.PP |
| 545 |
To move an application window to a different workspace one can use a |
| 546 |
keyboard shortcut. Another option is to select the \fIMove To\fR submenu |
| 547 |
in the window menu of the window frame. |
| 548 |
.SS "DRAG AND DROP" |
| 549 |
.IX Subsection "DRAG AND DROP" |
| 550 |
The task bar supports drag and drop operations. When a drag |
| 551 |
is in progress, the destination window can be activated by |
| 552 |
hovering the drag icon over the task button for that window. |
| 553 |
Alternatively, the current workspace can be changed by |
| 554 |
hovering the drag icon over the desired workspace button. |
| 555 |
When edge switching is enabled, the current workspace can |
| 556 |
also be changed by bringing the drag icon to the screen edge. |
| 557 |
.SS "ADDRESS BAR" |
| 558 |
.IX Subsection "ADDRESS BAR" |
| 559 |
The task bar contains a command-line prompt called the address bar, |
| 560 |
if \fBEnableAddressBar\fR=1. It is always shown when \fBShowAddressBar\fR=1, |
| 561 |
otherwise it is activated by \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+space\*(C'\fR. |
| 562 |
In it a shell command can be typed. On \fIEnter\fR it is executed by the |
| 563 |
\&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR. On \fIControl+Enter\fR this command is |
| 564 |
executed in a new terminal as given by \fBTerminalCommand\fR. |
| 565 |
\&\fIEscape\fR cancels editing the address bar command. |
| 566 |
.PP |
| 567 |
Commands are executed relative to the working directory of icewm. |
| 568 |
This is shown by \f(CW\*(C`pwd\*(C'\fR. Change it with \f(CW\*(C`cd\*(C'\fR. Without argument \f(CW\*(C`cd\*(C'\fR |
| 569 |
defaults to the home directory. With one argument it is changed. |
| 570 |
This argument is expanded when it starts with a dollar or tilde. |
| 571 |
When it is equal to \f(CW\*(C`\-\*(C'\fR, it reverts to the previous directory. |
| 572 |
.PP |
| 573 |
The address bar has a history that is navigable by \fIUp\fR and \fIDown\fR. |
| 574 |
This history is saved in a file \fIahistory\fR in your icewm directory |
| 575 |
and restored when icewm starts. |
| 576 |
.PP |
| 577 |
Completion is supported using \fITab\fR or \fICtrl+I\fR. The leading command |
| 578 |
is completed from directories in your PATH, while file arguments are |
| 579 |
expanded from the location in the file system. In addition usernames |
| 580 |
and environment variables can also be expanded. For example, \f(CW\*(C`echo $TMP\*(C'\fR |
| 581 |
and \fITab\fR may expand to \f(CW\*(C`echo $TMPDIR\*(C'\fR and \f(CW\*(C`echo ~ro\*(C'\fR and \fITab\fR may |
| 582 |
expand to \f(CW\*(C`echo ~root\*(C'\fR. |
| 583 |
.PP |
| 584 |
The address bar implements cut/copy/paste and these editing operations: |
| 585 |
.IP "Ctrl+a: select all" 4 |
| 586 |
.IX Item "Ctrl+a: select all" |
| 587 |
.PD 0 |
| 588 |
.IP "Ctrl+backslash: deselect all" 4 |
| 589 |
.IX Item "Ctrl+backslash: deselect all" |
| 590 |
.IP "Ctrl+u: delete selected or to line start" 4 |
| 591 |
.IX Item "Ctrl+u: delete selected or to line start" |
| 592 |
.IP "Ctrl+v: paste selected" 4 |
| 593 |
.IX Item "Ctrl+v: paste selected" |
| 594 |
.IP "Ctrl+w: delete selected or previous word" 4 |
| 595 |
.IX Item "Ctrl+w: delete selected or previous word" |
| 596 |
.IP "Ctrl+x: cut selection" 4 |
| 597 |
.IX Item "Ctrl+x: cut selection" |
| 598 |
.IP "Ctrl+c: copy selection" 4 |
| 599 |
.IX Item "Ctrl+c: copy selection" |
| 600 |
.IP "Ctrl+i: completion" 4 |
| 601 |
.IX Item "Ctrl+i: completion" |
| 602 |
.IP "Ctrl+Left: back a word" 4 |
| 603 |
.IX Item "Ctrl+Left: back a word" |
| 604 |
.IP "Ctrl+Right: forward a word" 4 |
| 605 |
.IX Item "Ctrl+Right: forward a word" |
| 606 |
.IP "Ctrl+Shift+Backspace: delete to beginning" 4 |
| 607 |
.IX Item "Ctrl+Shift+Backspace: delete to beginning" |
| 608 |
.IP "Ctrl+Shift+Delete: delete to end" 4 |
| 609 |
.IX Item "Ctrl+Shift+Delete: delete to end" |
| 610 |
.IP "Ctrl+Delete: delete word" 4 |
| 611 |
.IX Item "Ctrl+Delete: delete word" |
| 612 |
.IP "Ctrl+Backspace: delete previous word" 4 |
| 613 |
.IX Item "Ctrl+Backspace: delete previous word" |
| 614 |
.IP "Shift+Delete: cut selection" 4 |
| 615 |
.IX Item "Shift+Delete: cut selection" |
| 616 |
.IP "Shift+Insert: paste selected" 4 |
| 617 |
.IX Item "Shift+Insert: paste selected" |
| 618 |
.IP "Tab: completion" 4 |
| 619 |
.IX Item "Tab: completion" |
| 620 |
.IP "Left: move cursor left" 4 |
| 621 |
.IX Item "Left: move cursor left" |
| 622 |
.IP "Right: move cursor right" 4 |
| 623 |
.IX Item "Right: move cursor right" |
| 624 |
.IP "Home: move cursor to line start" 4 |
| 625 |
.IX Item "Home: move cursor to line start" |
| 626 |
.IP "End: move cursor to line end" 4 |
| 627 |
.IX Item "End: move cursor to line end" |
| 628 |
.IP "Delete: delete next character" 4 |
| 629 |
.IX Item "Delete: delete next character" |
| 630 |
.IP "Backspace: delete previous character" 4 |
| 631 |
.IX Item "Backspace: delete previous character" |
| 632 |
.PD |
| 633 |
.SS "WINDOW LIST" |
| 634 |
.IX Subsection "WINDOW LIST" |
| 635 |
The window list window shows a list of all workspaces. For each |
| 636 |
workspace it shows the window titles of the windows that are mapped |
| 637 |
on it. The bottom entry reads \f(CW\*(C`All Workspaces\*(C'\fR. It holds the sticky |
| 638 |
windows. These windows are mapped in all workspaces. |
| 639 |
.PP |
| 640 |
The window list window is normally hidden. Choose one of the following |
| 641 |
four methods to make it visible: |
| 642 |
.IP \(bu 4 |
| 643 |
Select the bottom window list menu entry. |
| 644 |
.IP \(bu 4 |
| 645 |
Press the \f(CW\*(C`KeySysWindowList=Ctrl+Alt+Esc\*(C'\fR key. |
| 646 |
.IP \(bu 4 |
| 647 |
Press the right Windows key if \f(CW\*(C`Win95Keys=1\*(C'\fR |
| 648 |
.IP \(bu 4 |
| 649 |
Press the \f(CW\*(C`DesktopWinListButton=2\*(C'\fR mouse button in the root window. |
| 650 |
.IP \(bu 4 |
| 651 |
Press the middle mouse button in a workspace button on the task bar. |
| 652 |
.PP |
| 653 |
A single-click on a window entry selects it. A group of windows can |
| 654 |
be selected by \f(CW\*(C`Shift+Pointer_Button1\*(C'\fR or by dragging with the left |
| 655 |
mouse button. Use \f(CW\*(C`Ctrl+Pointer_Button1\*(C'\fR to individually select |
| 656 |
windows in a multi-selection. A right mouse click over a selection |
| 657 |
will popup the system menu for this selection. To close the selected |
| 658 |
windows, press \f(CW\*(C`Delete\*(C'\fR. Press \f(CW\*(C`Shift+Delete\*(C'\fR to forcefully kill them. |
| 659 |
Right mouse click below the sticky windows for a menu with window |
| 660 |
arranging actions. |
| 661 |
.PP |
| 662 |
Double-click on a workspace to switch to it. Double-click on a window |
| 663 |
to activate it. Or navigate by arrow keys and press Enter. |
| 664 |
The space bar toggles a selection of a window. \f(CW\*(C`Ctrl+a\*(C'\fR and \f(CW\*(C`Ctrl+/\*(C'\fR |
| 665 |
will select the entire list of windows. \f(CW\*(C`Ctrl+\e\e\*(C'\fR deselects everything. |
| 666 |
Press the first letter of a window title to navigate to it and select |
| 667 |
it. If titles of multiple windows start with the same letter then |
| 668 |
repeatedly pressing the first letter cycles over those windows. |
| 669 |
\&\f(CW\*(C`Home\*(C'\fR selects the first entry and \f(CW\*(C`End\*(C'\fR the last. \f(CW\*(C`PageUp\*(C'\fR and |
| 670 |
\&\f(CW\*(C`PageDown\*(C'\fR move up or down by ten entries. Combine this with the |
| 671 |
\&\f(CW\*(C`Shift\*(C'\fR key to extend a selection over the range of motion. |
| 672 |
.SS "SYSTEM DIALOG" |
| 673 |
.IX Subsection "SYSTEM DIALOG" |
| 674 |
The system dialog offers quick access to a set of general controls. |
| 675 |
It can lock the screen, suspend the system, logout or cancel a pending |
| 676 |
logout, reboot the system, shutdown the system, show the window list, |
| 677 |
restart icewm, show the about dialog, reload the winoptions file or |
| 678 |
the keys file. It is activated by \fBKeySysDialog\fR=\f(CW\*(C`Ctrl+Alt+Del\*(C'\fR. |
| 679 |
To cancel it, hit the Escape key. |
| 680 |
.SS "MAILBOX MONITORING" |
| 681 |
.IX Subsection "MAILBOX MONITORING" |
| 682 |
The task bar can show one or more icons to reflect the status of a |
| 683 |
mailbox. The mailbox can be a local file or a remote POP or IMAP |
| 684 |
account. For this a couple of options must be set. First, |
| 685 |
\&\fITaskBarShowMailboxStatus\fR must be enabled, which it is by default. |
| 686 |
Then the location of the mailbox must be set. Icewm first looks for |
| 687 |
\&\fIMailBoxPath\fR in preferences. If this is unset, it looks at the |
| 688 |
environment variables \f(CW\*(C`MAILPATH\*(C'\fR and \f(CW\*(C`MAIL\*(C'\fR. \fIMailBoxPath\fR may |
| 689 |
contain a space-separated list of mailboxes, while \f(CW\*(C`MAILPATH\*(C'\fR may |
| 690 |
contain a colon-separated list of mailboxes. If a mailbox starts |
| 691 |
with a slash \f(CW\*(C`/\*(C'\fR, then it is a local file, otherwise a URL. |
| 692 |
These are six examples of possible mailboxes: |
| 693 |
.PP |
| 694 |
.Vb 6 |
| 695 |
\& file:///var/spool/mail/captnmark |
| 696 |
\& file:///home/captnmark/Maildir/ |
| 697 |
\& pop3://markus:%2f%40%[email protected]/ |
| 698 |
\& pop3s://markus:[email protected]/ |
| 699 |
\& imap://mathias@localhost/INBOX.Maillisten.icewm\-user |
| 700 |
\& imaps://mathias:[email protected]/INBOX |
| 701 |
.Ve |
| 702 |
.PP |
| 703 |
The POP3S and IMAPS schemes use \f(CW\*(C`openssl\*(C'\fR for TLS/SSL encryption. |
| 704 |
Note that for IceWM to access Gmail you must first configure |
| 705 |
your Gmail account to enable POP3 or IMAP access. |
| 706 |
Make sure you have secure file permissions on your IceWM |
| 707 |
preferences file and the directory that contains it. |
| 708 |
.PP |
| 709 |
Reserved characters in the password, like \fIslash\fR, \fIat\fR and \fIcolon\fR |
| 710 |
can be specified using escape sequences with a hexadecimal encoding |
| 711 |
like \f(CW%2f\fR for the slash or \f(CW%40\fR for the at sign. |
| 712 |
For example, to hex-encode \f(CW\*(C`!p@a%s&s~\*(C'\fR use this Perl snippet: |
| 713 |
.PP |
| 714 |
.Vb 2 |
| 715 |
\& perl \-e \*(Aqforeach(split("", $ARGV[0])) { printf "%%%02x", ord($_); }; |
| 716 |
\& print "\en";\*(Aq \*(Aq!p@a%s&s~\*(Aq |
| 717 |
.Ve |
| 718 |
.PP |
| 719 |
Which will print: |
| 720 |
.PP |
| 721 |
.Vb 1 |
| 722 |
\& %21%40%23%24%25%5e%26%2a%7e |
| 723 |
.Ve |
| 724 |
.PP |
| 725 |
This is the hex-encoded password. However, it is unwise to store a |
| 726 |
password in your preferences. Consider a wallet extension for IceWM. |
| 727 |
.PP |
| 728 |
IceWM will check a mailbox periodically. The period in seconds can |
| 729 |
be set by the \fIMailCheckDelay\fR option, which is 30 seconds by default. |
| 730 |
.PP |
| 731 |
Whenever new mail arrives, the mailbox icon will be highlighted. |
| 732 |
The color will indicate if the mail has been read or not. Hovering |
| 733 |
the mouse over the mailbox icon will show a tooltip with more details. |
| 734 |
A command can be also be run on new mail. Set the \fINewMailCommand\fR |
| 735 |
option. Its environment will have these variables set by IceWM: |
| 736 |
.IP ICEWM_MAILBOX 4 |
| 737 |
.IX Item "ICEWM_MAILBOX" |
| 738 |
The mailbox index number of \fIMailBoxPath\fR starting from 1. |
| 739 |
.IP ICEWM_COUNT 4 |
| 740 |
.IX Item "ICEWM_COUNT" |
| 741 |
The total number of messages in this mailbox. |
| 742 |
.IP ICEWM_UNREAD 4 |
| 743 |
.IX Item "ICEWM_UNREAD" |
| 744 |
The number of unread messages in this mailbox. |
| 745 |
.SS "KEYBOARD LAYOUT SWITCHING" |
| 746 |
.IX Subsection "KEYBOARD LAYOUT SWITCHING" |
| 747 |
To control keyboard layouts on the task bar, define in \fIpreferences\fR |
| 748 |
the option \fBKeyboardLayouts\fR to a comma-separated list of your |
| 749 |
preferred keyboard layouts. For example: |
| 750 |
.PP |
| 751 |
.Vb 1 |
| 752 |
\& KeyboardLayouts = "de", "fr", "jp" |
| 753 |
.Ve |
| 754 |
.PP |
| 755 |
A keyboard layout can simply be a name. Usually this is a two-letter |
| 756 |
country code. See the directory \fI/usr/share/X11/xkb/symbols\fR for |
| 757 |
a list of available keyboard layouts for your system. If it is |
| 758 |
enclosed in double quotes, it can also be a space-separated list of |
| 759 |
command-line arguments to an invocation of the \f(CW\*(C`setxkbmap\*(C'\fR program. |
| 760 |
.PP |
| 761 |
The first layout is the default. It will be installed when icewm starts. |
| 762 |
The task bar will show the current keyboard layout. If an icon can |
| 763 |
be found for the first two letters of the layout, then that icon |
| 764 |
will be shown. Otherwise the first two letters of the name of the |
| 765 |
layout will be shown. |
| 766 |
.PP |
| 767 |
Click on the current keyboard layout to cycle through all the |
| 768 |
available keyboard layouts, or use the \fBKeySysKeyboardNext\fR key. |
| 769 |
Click with the right mouse button to open a menu of all available |
| 770 |
keyboard layouts. |
| 771 |
.PP |
| 772 |
It is also possible to configure a default keyboard layout for |
| 773 |
each program individually in the \fBicewm\-winoptions\fR\|(5) file. |
| 774 |
Whenever such a program receives input focus, icewm will install |
| 775 |
this configured keyboard layout automatically. The keyboard status |
| 776 |
on the task bar will be updated to reflect this. |
| 777 |
.PP |
| 778 |
Please note that for keyboard layout switching to work, the |
| 779 |
\&\f(CW\*(C`setxkbmap\*(C'\fR program must be installed. To see your current |
| 780 |
keyboard layout settings, do \f(CW\*(C`setxkbmap \-query\*(C'\fR. |
| 781 |
.SS "KEYBOARD SHORTCUTS" |
| 782 |
.IX Subsection "KEYBOARD SHORTCUTS" |
| 783 |
\&\fBicewm\fR supports a large number of hotkeys to activate some behaviour |
| 784 |
with a single key combination. These are all configurable in the |
| 785 |
\&\fIpreferences\fR file. Here we give their preferences name, followed by |
| 786 |
their default value in double quotes, and a short descriptions of their |
| 787 |
effect. |
| 788 |
.PP |
| 789 |
Note that all use one or more key modifiers. Icewm supports the |
| 790 |
following modifiers: Alt, AltGr, Ctrl, Hyper, Meta, Shift, Super. |
| 791 |
Setting \fBModSuperIsCtrlAlt=1\fR makes the Super modifier an alias |
| 792 |
for Ctrl+Alt. |
| 793 |
.ie n .IP "\fBKeyWinRaise\fR=""Alt+F1""" 4 |
| 794 |
.el .IP \fBKeyWinRaise\fR=\f(CWAlt+F1\fR 4 |
| 795 |
.IX Item "KeyWinRaise=Alt+F1" |
| 796 |
Raises the window that currently has input focus. |
| 797 |
.ie n .IP "\fBKeyWinOccupyAll\fR=""Alt+F2""" 4 |
| 798 |
.el .IP \fBKeyWinOccupyAll\fR=\f(CWAlt+F2\fR 4 |
| 799 |
.IX Item "KeyWinOccupyAll=Alt+F2" |
| 800 |
Makes the active window occupy all workspaces. |
| 801 |
.ie n .IP "\fBKeyWinLower\fR=""Alt+F3""" 4 |
| 802 |
.el .IP \fBKeyWinLower\fR=\f(CWAlt+F3\fR 4 |
| 803 |
.IX Item "KeyWinLower=Alt+F3" |
| 804 |
Lowers the window that currently has input focus. |
| 805 |
.ie n .IP "\fBKeyWinClose\fR=""Alt+F4""" 4 |
| 806 |
.el .IP \fBKeyWinClose\fR=\f(CWAlt+F4\fR 4 |
| 807 |
.IX Item "KeyWinClose=Alt+F4" |
| 808 |
Closes the active window. |
| 809 |
.ie n .IP "\fBKeyWinRestore\fR=""Alt+F5""" 4 |
| 810 |
.el .IP \fBKeyWinRestore\fR=\f(CWAlt+F5\fR 4 |
| 811 |
.IX Item "KeyWinRestore=Alt+F5" |
| 812 |
Restores the active window to its visible state. |
| 813 |
.ie n .IP "\fBKeyWinNext\fR=""Alt+F6""" 4 |
| 814 |
.el .IP \fBKeyWinNext\fR=\f(CWAlt+F6\fR 4 |
| 815 |
.IX Item "KeyWinNext=Alt+F6" |
| 816 |
Switches focus to the next window. |
| 817 |
.ie n .IP "\fBKeyWinPrev\fR=""Alt+Shift+F6""" 4 |
| 818 |
.el .IP \fBKeyWinPrev\fR=\f(CWAlt+Shift+F6\fR 4 |
| 819 |
.IX Item "KeyWinPrev=Alt+Shift+F6" |
| 820 |
Switches focus to the previous window. |
| 821 |
.ie n .IP "\fBKeyWinMove\fR=""Alt+F7""" 4 |
| 822 |
.el .IP \fBKeyWinMove\fR=\f(CWAlt+F7\fR 4 |
| 823 |
.IX Item "KeyWinMove=Alt+F7" |
| 824 |
Starts movement of the active window. |
| 825 |
.ie n .IP "\fBKeyWinSize\fR=""Alt+F8""" 4 |
| 826 |
.el .IP \fBKeyWinSize\fR=\f(CWAlt+F8\fR 4 |
| 827 |
.IX Item "KeyWinSize=Alt+F8" |
| 828 |
Starts resizing of the active window. |
| 829 |
.ie n .IP "\fBKeyWinMinimize\fR=""Alt+F9""" 4 |
| 830 |
.el .IP \fBKeyWinMinimize\fR=\f(CWAlt+F9\fR 4 |
| 831 |
.IX Item "KeyWinMinimize=Alt+F9" |
| 832 |
Iconifies the active window. |
| 833 |
.ie n .IP "\fBKeyWinMaximize\fR=""Alt+F10""" 4 |
| 834 |
.el .IP \fBKeyWinMaximize\fR=\f(CWAlt+F10\fR 4 |
| 835 |
.IX Item "KeyWinMaximize=Alt+F10" |
| 836 |
Maximizes the active window with borders. |
| 837 |
.ie n .IP "\fBKeyWinMaximizeVert\fR=""Alt+Shift+F10""" 4 |
| 838 |
.el .IP \fBKeyWinMaximizeVert\fR=\f(CWAlt+Shift+F10\fR 4 |
| 839 |
.IX Item "KeyWinMaximizeVert=Alt+Shift+F10" |
| 840 |
Maximizes the active window vertically. |
| 841 |
.ie n .IP "\fBKeyWinMaximizeHoriz\fR=""undefined""" 4 |
| 842 |
.el .IP \fBKeyWinMaximizeHoriz\fR=\f(CWundefined\fR 4 |
| 843 |
.IX Item "KeyWinMaximizeHoriz=undefined" |
| 844 |
Maximizes the active window horizontally. |
| 845 |
.ie n .IP "\fBKeyWinFullscreen\fR=""Alt+F11""" 4 |
| 846 |
.el .IP \fBKeyWinFullscreen\fR=\f(CWAlt+F11\fR 4 |
| 847 |
.IX Item "KeyWinFullscreen=Alt+F11" |
| 848 |
Maximizes the active window without borders. |
| 849 |
.ie n .IP "\fBKeyWinRollup\fR=""Alt+F12""" 4 |
| 850 |
.el .IP \fBKeyWinRollup\fR=\f(CWAlt+F12\fR 4 |
| 851 |
.IX Item "KeyWinRollup=Alt+F12" |
| 852 |
Rolls up the active window. |
| 853 |
.ie n .IP "\fBKeyWinHide\fR=""Alt+Shift+F12""" 4 |
| 854 |
.el .IP \fBKeyWinHide\fR=\f(CWAlt+Shift+F12\fR 4 |
| 855 |
.IX Item "KeyWinHide=Alt+Shift+F12" |
| 856 |
Hides the active window. |
| 857 |
.ie n .IP "\fBKeyWinMenu\fR=""Alt+space""" 4 |
| 858 |
.el .IP \fBKeyWinMenu\fR=\f(CWAlt+space\fR 4 |
| 859 |
.IX Item "KeyWinMenu=Alt+space" |
| 860 |
Posts the window menu. |
| 861 |
.ie n .IP "\fBKeyWinArrangeNW\fR=""Ctrl+Alt+KP_7""" 4 |
| 862 |
.el .IP \fBKeyWinArrangeNW\fR=\f(CWCtrl+Alt+KP_7\fR 4 |
| 863 |
.IX Item "KeyWinArrangeNW=Ctrl+Alt+KP_7" |
| 864 |
Moves the active window to the top left corner of the screen. |
| 865 |
.ie n .IP "\fBKeyWinArrangeN\fR=""Ctrl+Alt+KP_8""" 4 |
| 866 |
.el .IP \fBKeyWinArrangeN\fR=\f(CWCtrl+Alt+KP_8\fR 4 |
| 867 |
.IX Item "KeyWinArrangeN=Ctrl+Alt+KP_8" |
| 868 |
Moves the active window to the top middle of the screen. |
| 869 |
.ie n .IP "\fBKeyWinArrangeNE\fR=""Ctrl+Alt+KP_9""" 4 |
| 870 |
.el .IP \fBKeyWinArrangeNE\fR=\f(CWCtrl+Alt+KP_9\fR 4 |
| 871 |
.IX Item "KeyWinArrangeNE=Ctrl+Alt+KP_9" |
| 872 |
Moves the active window to the top right of the screen. |
| 873 |
.ie n .IP "\fBKeyWinArrangeE\fR=""Ctrl+Alt+KP_6""" 4 |
| 874 |
.el .IP \fBKeyWinArrangeE\fR=\f(CWCtrl+Alt+KP_6\fR 4 |
| 875 |
.IX Item "KeyWinArrangeE=Ctrl+Alt+KP_6" |
| 876 |
Moves the active window to the middle right of the screen. |
| 877 |
.ie n .IP "\fBKeyWinArrangeSE\fR=""Ctrl+Alt+KP_3""" 4 |
| 878 |
.el .IP \fBKeyWinArrangeSE\fR=\f(CWCtrl+Alt+KP_3\fR 4 |
| 879 |
.IX Item "KeyWinArrangeSE=Ctrl+Alt+KP_3" |
| 880 |
Moves the active window to the bottom right of the screen. |
| 881 |
.ie n .IP "\fBKeyWinArrangeS\fR=""Ctrl+Alt+KP_2""" 4 |
| 882 |
.el .IP \fBKeyWinArrangeS\fR=\f(CWCtrl+Alt+KP_2\fR 4 |
| 883 |
.IX Item "KeyWinArrangeS=Ctrl+Alt+KP_2" |
| 884 |
Moves the active window to the bottom middle of the screen. |
| 885 |
.ie n .IP "\fBKeyWinArrangeSW\fR=""Ctrl+Alt+KP_1""" 4 |
| 886 |
.el .IP \fBKeyWinArrangeSW\fR=\f(CWCtrl+Alt+KP_1\fR 4 |
| 887 |
.IX Item "KeyWinArrangeSW=Ctrl+Alt+KP_1" |
| 888 |
Moves the active window to the bottom left of the screen. |
| 889 |
.ie n .IP "\fBKeyWinArrangeW\fR=""Ctrl+Alt+KP_4""" 4 |
| 890 |
.el .IP \fBKeyWinArrangeW\fR=\f(CWCtrl+Alt+KP_4\fR 4 |
| 891 |
.IX Item "KeyWinArrangeW=Ctrl+Alt+KP_4" |
| 892 |
Moves the active window to the middle left of the screen. |
| 893 |
.ie n .IP "\fBKeyWinArrangeC\fR=""Ctrl+Alt+KP_5""" 4 |
| 894 |
.el .IP \fBKeyWinArrangeC\fR=\f(CWCtrl+Alt+KP_5\fR 4 |
| 895 |
.IX Item "KeyWinArrangeC=Ctrl+Alt+KP_5" |
| 896 |
Moves the active window to the center of the screen. |
| 897 |
.IP "\fBKeyWinTileLeft\fR=""""" 4 |
| 898 |
.IX Item "KeyWinTileLeft=""""" |
| 899 |
Let the active window occupy the left half of the screen. |
| 900 |
.IP "\fBKeyWinTileRight\fR=""""" 4 |
| 901 |
.IX Item "KeyWinTileRight=""""" |
| 902 |
Let the active window occupy the right half of the screen. |
| 903 |
.IP "\fBKeyWinTileTop\fR=""""" 4 |
| 904 |
.IX Item "KeyWinTileTop=""""" |
| 905 |
Let the active window occupy the top half of the screen. |
| 906 |
.IP "\fBKeyWinTileBottom\fR=""""" 4 |
| 907 |
.IX Item "KeyWinTileBottom=""""" |
| 908 |
Let the active window occupy the bottom half of the screen. |
| 909 |
.IP "\fBKeyWinTileTopLeft\fR=""""" 4 |
| 910 |
.IX Item "KeyWinTileTopLeft=""""" |
| 911 |
Let the active window occupy the top left quarter of the screen. |
| 912 |
.IP "\fBKeyWinTileTopRight\fR=""""" 4 |
| 913 |
.IX Item "KeyWinTileTopRight=""""" |
| 914 |
Let the active window occupy the top right quarter of the screen. |
| 915 |
.IP "\fBKeyWinTileBottomLeft\fR=""""" 4 |
| 916 |
.IX Item "KeyWinTileBottomLeft=""""" |
| 917 |
Let the active window occupy the bottom left quarter of the screen. |
| 918 |
.IP "\fBKeyWinTileBottomRight\fR=""""" 4 |
| 919 |
.IX Item "KeyWinTileBottomRight=""""" |
| 920 |
Let the active window occupy the bottom right quarter of the screen. |
| 921 |
.IP "\fBKeyWinTileCenter\fR=""""" 4 |
| 922 |
.IX Item "KeyWinTileCenter=""""" |
| 923 |
Let the active window occupy the center quarter of the screen. |
| 924 |
.ie n .IP "\fBKeyWinSmartPlace\fR=""Ctrl+Alt+Shift+KP_5""" 4 |
| 925 |
.el .IP \fBKeyWinSmartPlace\fR=\f(CWCtrl+Alt+Shift+KP_5\fR 4 |
| 926 |
.IX Item "KeyWinSmartPlace=Ctrl+Alt+Shift+KP_5" |
| 927 |
Smart place the active window. |
| 928 |
.ie n .IP "\fBKeySysWinMenu\fR=""Shift+Esc""" 4 |
| 929 |
.el .IP \fBKeySysWinMenu\fR=\f(CWShift+Esc\fR 4 |
| 930 |
.IX Item "KeySysWinMenu=Shift+Esc" |
| 931 |
Posts the system window menu. |
| 932 |
.ie n .IP "\fBKeySysWinNext\fR=""Alt+Esc""" 4 |
| 933 |
.el .IP \fBKeySysWinNext\fR=\f(CWAlt+Esc\fR 4 |
| 934 |
.IX Item "KeySysWinNext=Alt+Esc" |
| 935 |
Give focus to the next window and raise it. |
| 936 |
.ie n .IP "\fBKeySysWinPrev\fR=""Alt+Shift+Esc""" 4 |
| 937 |
.el .IP \fBKeySysWinPrev\fR=\f(CWAlt+Shift+Esc\fR 4 |
| 938 |
.IX Item "KeySysWinPrev=Alt+Shift+Esc" |
| 939 |
Give focus to the previous window and raise it. |
| 940 |
.ie n .IP "\fBKeySysDialog\fR=""Ctrl+Alt+Del""" 4 |
| 941 |
.el .IP \fBKeySysDialog\fR=\f(CWCtrl+Alt+Del\fR 4 |
| 942 |
.IX Item "KeySysDialog=Ctrl+Alt+Del" |
| 943 |
Opens the IceWM system dialog in the center of the screen. |
| 944 |
.ie n .IP "\fBKeySysMenu\fR=""Ctrl+Esc""" 4 |
| 945 |
.el .IP \fBKeySysMenu\fR=\f(CWCtrl+Esc\fR 4 |
| 946 |
.IX Item "KeySysMenu=Ctrl+Esc" |
| 947 |
Activates the IceWM root menu in the lower left corner. |
| 948 |
.ie n .IP "\fBKeySysWindowList\fR=""Alt+Ctrl+Esc""" 4 |
| 949 |
.el .IP \fBKeySysWindowList\fR=\f(CWAlt+Ctrl+Esc\fR 4 |
| 950 |
.IX Item "KeySysWindowList=Alt+Ctrl+Esc" |
| 951 |
Opens the IceWM system window list in the center of the screen. |
| 952 |
.ie n .IP "\fBKeySysAddressBar\fR=""Alt+Ctrl+space""" 4 |
| 953 |
.el .IP \fBKeySysAddressBar\fR=\f(CWAlt+Ctrl+space\fR 4 |
| 954 |
.IX Item "KeySysAddressBar=Alt+Ctrl+space" |
| 955 |
Opens the address bar in the task bar where a command can be typed. |
| 956 |
.ie n .IP "\fBKeySysWorkspacePrev\fR=""Alt+Ctrl+Left""" 4 |
| 957 |
.el .IP \fBKeySysWorkspacePrev\fR=\f(CWAlt+Ctrl+Left\fR 4 |
| 958 |
.IX Item "KeySysWorkspacePrev=Alt+Ctrl+Left" |
| 959 |
Goes one workspace to the left. |
| 960 |
.ie n .IP "\fBKeySysWorkspaceNext\fR=""Alt+Ctrl+Right""" 4 |
| 961 |
.el .IP \fBKeySysWorkspaceNext\fR=\f(CWAlt+Ctrl+Right\fR 4 |
| 962 |
.IX Item "KeySysWorkspaceNext=Alt+Ctrl+Right" |
| 963 |
Goes one workspace to the right. |
| 964 |
.ie n .IP "\fBKeySysWorkspaceLast\fR=""Alt+Ctrl+Down""" 4 |
| 965 |
.el .IP \fBKeySysWorkspaceLast\fR=\f(CWAlt+Ctrl+Down\fR 4 |
| 966 |
.IX Item "KeySysWorkspaceLast=Alt+Ctrl+Down" |
| 967 |
Goes to the previous workspace. |
| 968 |
.ie n .IP "\fBKeySysWorkspacePrevTakeWin\fR=""Alt+Ctrl+Shift+Left""" 4 |
| 969 |
.el .IP \fBKeySysWorkspacePrevTakeWin\fR=\f(CWAlt+Ctrl+Shift+Left\fR 4 |
| 970 |
.IX Item "KeySysWorkspacePrevTakeWin=Alt+Ctrl+Shift+Left" |
| 971 |
Takes the active window one workspace to the left. |
| 972 |
.ie n .IP "\fBKeySysWorkspaceNextTakeWin\fR=""Alt+Ctrl+Shift+Right""" 4 |
| 973 |
.el .IP \fBKeySysWorkspaceNextTakeWin\fR=\f(CWAlt+Ctrl+Shift+Right\fR 4 |
| 974 |
.IX Item "KeySysWorkspaceNextTakeWin=Alt+Ctrl+Shift+Right" |
| 975 |
Takes the active window one workspace to the right. |
| 976 |
.ie n .IP "\fBKeySysWorkspaceLastTakeWin\fR=""Alt+Ctrl+Shift+Down""" 4 |
| 977 |
.el .IP \fBKeySysWorkspaceLastTakeWin\fR=\f(CWAlt+Ctrl+Shift+Down\fR 4 |
| 978 |
.IX Item "KeySysWorkspaceLastTakeWin=Alt+Ctrl+Shift+Down" |
| 979 |
Takes the active window to the previous workspace. |
| 980 |
.ie n .IP "\fBKeySysWorkspace1\fR=""Alt+Ctrl+1""" 4 |
| 981 |
.el .IP \fBKeySysWorkspace1\fR=\f(CWAlt+Ctrl+1\fR 4 |
| 982 |
.IX Item "KeySysWorkspace1=Alt+Ctrl+1" |
| 983 |
Goes to workspace 1. |
| 984 |
.ie n .IP "\fBKeySysWorkspace2\fR=""Alt+Ctrl+2""" 4 |
| 985 |
.el .IP \fBKeySysWorkspace2\fR=\f(CWAlt+Ctrl+2\fR 4 |
| 986 |
.IX Item "KeySysWorkspace2=Alt+Ctrl+2" |
| 987 |
Goes to workspace 2. |
| 988 |
.ie n .IP "\fBKeySysWorkspace3\fR=""Alt+Ctrl+3""" 4 |
| 989 |
.el .IP \fBKeySysWorkspace3\fR=\f(CWAlt+Ctrl+3\fR 4 |
| 990 |
.IX Item "KeySysWorkspace3=Alt+Ctrl+3" |
| 991 |
Goes to workspace 3. |
| 992 |
.ie n .IP "\fBKeySysWorkspace4\fR=""Alt+Ctrl+4""" 4 |
| 993 |
.el .IP \fBKeySysWorkspace4\fR=\f(CWAlt+Ctrl+4\fR 4 |
| 994 |
.IX Item "KeySysWorkspace4=Alt+Ctrl+4" |
| 995 |
Goes to workspace 4. |
| 996 |
.ie n .IP "\fBKeySysWorkspace5\fR=""Alt+Ctrl+5""" 4 |
| 997 |
.el .IP \fBKeySysWorkspace5\fR=\f(CWAlt+Ctrl+5\fR 4 |
| 998 |
.IX Item "KeySysWorkspace5=Alt+Ctrl+5" |
| 999 |
Goes to workspace 5. |
| 1000 |
.ie n .IP "\fBKeySysWorkspace6\fR=""Alt+Ctrl+6""" 4 |
| 1001 |
.el .IP \fBKeySysWorkspace6\fR=\f(CWAlt+Ctrl+6\fR 4 |
| 1002 |
.IX Item "KeySysWorkspace6=Alt+Ctrl+6" |
| 1003 |
Goes to workspace 6. |
| 1004 |
.ie n .IP "\fBKeySysWorkspace7\fR=""Alt+Ctrl+7""" 4 |
| 1005 |
.el .IP \fBKeySysWorkspace7\fR=\f(CWAlt+Ctrl+7\fR 4 |
| 1006 |
.IX Item "KeySysWorkspace7=Alt+Ctrl+7" |
| 1007 |
Goes to workspace 7. |
| 1008 |
.ie n .IP "\fBKeySysWorkspace8\fR=""Alt+Ctrl+8""" 4 |
| 1009 |
.el .IP \fBKeySysWorkspace8\fR=\f(CWAlt+Ctrl+8\fR 4 |
| 1010 |
.IX Item "KeySysWorkspace8=Alt+Ctrl+8" |
| 1011 |
Goes to workspace 8. |
| 1012 |
.ie n .IP "\fBKeySysWorkspace9\fR=""Alt+Ctrl+9""" 4 |
| 1013 |
.el .IP \fBKeySysWorkspace9\fR=\f(CWAlt+Ctrl+9\fR 4 |
| 1014 |
.IX Item "KeySysWorkspace9=Alt+Ctrl+9" |
| 1015 |
Goes to workspace 9. |
| 1016 |
.ie n .IP "\fBKeySysWorkspace10\fR=""Alt+Ctrl+0""" 4 |
| 1017 |
.el .IP \fBKeySysWorkspace10\fR=\f(CWAlt+Ctrl+0\fR 4 |
| 1018 |
.IX Item "KeySysWorkspace10=Alt+Ctrl+0" |
| 1019 |
Goes to workspace 10. |
| 1020 |
.ie n .IP "\fBKeySysWorkspace11\fR=""Alt+Ctrl+minus""" 4 |
| 1021 |
.el .IP \fBKeySysWorkspace11\fR=\f(CWAlt+Ctrl+minus\fR 4 |
| 1022 |
.IX Item "KeySysWorkspace11=Alt+Ctrl+minus" |
| 1023 |
Goes to workspace 11. |
| 1024 |
.ie n .IP "\fBKeySysWorkspace12\fR=""Alt+Ctrl+equal""" 4 |
| 1025 |
.el .IP \fBKeySysWorkspace12\fR=\f(CWAlt+Ctrl+equal\fR 4 |
| 1026 |
.IX Item "KeySysWorkspace12=Alt+Ctrl+equal" |
| 1027 |
Goes to workspace 12. |
| 1028 |
.ie n .IP "\fBKeySysWorkspace1TakeWin\fR=""Alt+Ctrl+Shift+1""" 4 |
| 1029 |
.el .IP \fBKeySysWorkspace1TakeWin\fR=\f(CWAlt+Ctrl+Shift+1\fR 4 |
| 1030 |
.IX Item "KeySysWorkspace1TakeWin=Alt+Ctrl+Shift+1" |
| 1031 |
Takes the active window to workspace 1. |
| 1032 |
.ie n .IP "\fBKeySysWorkspace2TakeWin\fR=""Alt+Ctrl+Shift+2""" 4 |
| 1033 |
.el .IP \fBKeySysWorkspace2TakeWin\fR=\f(CWAlt+Ctrl+Shift+2\fR 4 |
| 1034 |
.IX Item "KeySysWorkspace2TakeWin=Alt+Ctrl+Shift+2" |
| 1035 |
Takes the active window to workspace 2. |
| 1036 |
.ie n .IP "\fBKeySysWorkspace3TakeWin\fR=""Alt+Ctrl+Shift+3""" 4 |
| 1037 |
.el .IP \fBKeySysWorkspace3TakeWin\fR=\f(CWAlt+Ctrl+Shift+3\fR 4 |
| 1038 |
.IX Item "KeySysWorkspace3TakeWin=Alt+Ctrl+Shift+3" |
| 1039 |
Takes the active window to workspace 3. |
| 1040 |
.ie n .IP "\fBKeySysWorkspace4TakeWin\fR=""Alt+Ctrl+Shift+4""" 4 |
| 1041 |
.el .IP \fBKeySysWorkspace4TakeWin\fR=\f(CWAlt+Ctrl+Shift+4\fR 4 |
| 1042 |
.IX Item "KeySysWorkspace4TakeWin=Alt+Ctrl+Shift+4" |
| 1043 |
Takes the active window to workspace 4. |
| 1044 |
.ie n .IP "\fBKeySysWorkspace5TakeWin\fR=""Alt+Ctrl+Shift+5""" 4 |
| 1045 |
.el .IP \fBKeySysWorkspace5TakeWin\fR=\f(CWAlt+Ctrl+Shift+5\fR 4 |
| 1046 |
.IX Item "KeySysWorkspace5TakeWin=Alt+Ctrl+Shift+5" |
| 1047 |
Takes the active window to workspace 5. |
| 1048 |
.ie n .IP "\fBKeySysWorkspace6TakeWin\fR=""Alt+Ctrl+Shift+6""" 4 |
| 1049 |
.el .IP \fBKeySysWorkspace6TakeWin\fR=\f(CWAlt+Ctrl+Shift+6\fR 4 |
| 1050 |
.IX Item "KeySysWorkspace6TakeWin=Alt+Ctrl+Shift+6" |
| 1051 |
Takes the active window to workspace 6. |
| 1052 |
.ie n .IP "\fBKeySysWorkspace7TakeWin\fR=""Alt+Ctrl+Shift+7""" 4 |
| 1053 |
.el .IP \fBKeySysWorkspace7TakeWin\fR=\f(CWAlt+Ctrl+Shift+7\fR 4 |
| 1054 |
.IX Item "KeySysWorkspace7TakeWin=Alt+Ctrl+Shift+7" |
| 1055 |
Takes the active window to workspace 7. |
| 1056 |
.ie n .IP "\fBKeySysWorkspace8TakeWin\fR=""Alt+Ctrl+Shift+8""" 4 |
| 1057 |
.el .IP \fBKeySysWorkspace8TakeWin\fR=\f(CWAlt+Ctrl+Shift+8\fR 4 |
| 1058 |
.IX Item "KeySysWorkspace8TakeWin=Alt+Ctrl+Shift+8" |
| 1059 |
Takes the active window to workspace 8. |
| 1060 |
.ie n .IP "\fBKeySysWorkspace9TakeWin\fR=""Alt+Ctrl+Shift+9""" 4 |
| 1061 |
.el .IP \fBKeySysWorkspace9TakeWin\fR=\f(CWAlt+Ctrl+Shift+9\fR 4 |
| 1062 |
.IX Item "KeySysWorkspace9TakeWin=Alt+Ctrl+Shift+9" |
| 1063 |
Takes the active window to workspace 9. |
| 1064 |
.ie n .IP "\fBKeySysWorkspace10TakeWin\fR=""Alt+Ctrl+Shift+0""" 4 |
| 1065 |
.el .IP \fBKeySysWorkspace10TakeWin\fR=\f(CWAlt+Ctrl+Shift+0\fR 4 |
| 1066 |
.IX Item "KeySysWorkspace10TakeWin=Alt+Ctrl+Shift+0" |
| 1067 |
Takes the active window to workspace 10. |
| 1068 |
.ie n .IP "\fBKeySysWorkspace11TakeWin\fR=""Alt+Ctrl+Shift+minus""" 4 |
| 1069 |
.el .IP \fBKeySysWorkspace11TakeWin\fR=\f(CWAlt+Ctrl+Shift+minus\fR 4 |
| 1070 |
.IX Item "KeySysWorkspace11TakeWin=Alt+Ctrl+Shift+minus" |
| 1071 |
Takes the active window to workspace 11. |
| 1072 |
.ie n .IP "\fBKeySysWorkspace12TakeWin\fR=""Alt+Ctrl+Shift+equal""" 4 |
| 1073 |
.el .IP \fBKeySysWorkspace12TakeWin\fR=\f(CWAlt+Ctrl+Shift+equal\fR 4 |
| 1074 |
.IX Item "KeySysWorkspace12TakeWin=Alt+Ctrl+Shift+equal" |
| 1075 |
Takes the active window to workspace 12. |
| 1076 |
.ie n .IP "\fBKeySysTileVertical\fR=""Alt+Shift+F2""" 4 |
| 1077 |
.el .IP \fBKeySysTileVertical\fR=\f(CWAlt+Shift+F2\fR 4 |
| 1078 |
.IX Item "KeySysTileVertical=Alt+Shift+F2" |
| 1079 |
Tiles all windows from left to right maximized vertically. |
| 1080 |
.ie n .IP "\fBKeySysTileHorizontal\fR=""Alt+Shift+F3""" 4 |
| 1081 |
.el .IP \fBKeySysTileHorizontal\fR=\f(CWAlt+Shift+F3\fR 4 |
| 1082 |
.IX Item "KeySysTileHorizontal=Alt+Shift+F3" |
| 1083 |
Tiles all windows from top to bottom maximized horizontally. |
| 1084 |
.ie n .IP "\fBKeySysCascade\fR=""Alt+Shift+F4""" 4 |
| 1085 |
.el .IP \fBKeySysCascade\fR=\f(CWAlt+Shift+F4\fR 4 |
| 1086 |
.IX Item "KeySysCascade=Alt+Shift+F4" |
| 1087 |
Makes a horizontal cascade of all windows which are maximized vertically. |
| 1088 |
.ie n .IP "\fBKeySysArrange\fR=""Alt+Shift+F5""" 4 |
| 1089 |
.el .IP \fBKeySysArrange\fR=\f(CWAlt+Shift+F5\fR 4 |
| 1090 |
.IX Item "KeySysArrange=Alt+Shift+F5" |
| 1091 |
Rearranges the windows. |
| 1092 |
.ie n .IP "\fBKeySysUndoArrange\fR=""Alt+Shift+F7""" 4 |
| 1093 |
.el .IP \fBKeySysUndoArrange\fR=\f(CWAlt+Shift+F7\fR 4 |
| 1094 |
.IX Item "KeySysUndoArrange=Alt+Shift+F7" |
| 1095 |
Undoes arrangement. |
| 1096 |
.ie n .IP "\fBKeySysArrangeIcons\fR=""Alt+Shift+F8""" 4 |
| 1097 |
.el .IP \fBKeySysArrangeIcons\fR=\f(CWAlt+Shift+F8\fR 4 |
| 1098 |
.IX Item "KeySysArrangeIcons=Alt+Shift+F8" |
| 1099 |
Rearranges icons. |
| 1100 |
.ie n .IP "\fBKeySysMinimizeAll\fR=""Alt+Shift+F9""" 4 |
| 1101 |
.el .IP \fBKeySysMinimizeAll\fR=\f(CWAlt+Shift+F9\fR 4 |
| 1102 |
.IX Item "KeySysMinimizeAll=Alt+Shift+F9" |
| 1103 |
Minimizes all windows. |
| 1104 |
.ie n .IP "\fBKeySysHideAll\fR=""Alt+Shift+F11""" 4 |
| 1105 |
.el .IP \fBKeySysHideAll\fR=\f(CWAlt+Shift+F11\fR 4 |
| 1106 |
.IX Item "KeySysHideAll=Alt+Shift+F11" |
| 1107 |
Hides all windows. |
| 1108 |
.ie n .IP "\fBKeySysShowDesktop\fR=""Alt+Ctrl+d""" 4 |
| 1109 |
.el .IP \fBKeySysShowDesktop\fR=\f(CWAlt+Ctrl+d\fR 4 |
| 1110 |
.IX Item "KeySysShowDesktop=Alt+Ctrl+d" |
| 1111 |
Unmaps all windows to show the desktop. |
| 1112 |
.ie n .IP "\fBKeySysCollapseTaskBar\fR=""Alt+Ctrl+h""" 4 |
| 1113 |
.el .IP \fBKeySysCollapseTaskBar\fR=\f(CWAlt+Ctrl+h\fR 4 |
| 1114 |
.IX Item "KeySysCollapseTaskBar=Alt+Ctrl+h" |
| 1115 |
Hides the task bar. |
| 1116 |
.ie n .IP "\fBKeyTaskBarSwitchNext\fR=""undefined""" 4 |
| 1117 |
.el .IP \fBKeyTaskBarSwitchNext\fR=\f(CWundefined\fR 4 |
| 1118 |
.IX Item "KeyTaskBarSwitchNext=undefined" |
| 1119 |
Switches to the next window in the task bar. |
| 1120 |
.ie n .IP "\fBKeyTaskBarSwitchPrev\fR=""undefined""" 4 |
| 1121 |
.el .IP \fBKeyTaskBarSwitchPrev\fR=\f(CWundefined\fR 4 |
| 1122 |
.IX Item "KeyTaskBarSwitchPrev=undefined" |
| 1123 |
Switches to the previous window in the task bar. |
| 1124 |
.ie n .IP "\fBKeyTaskBarMoveNext\fR=""undefined""" 4 |
| 1125 |
.el .IP \fBKeyTaskBarMoveNext\fR=\f(CWundefined\fR 4 |
| 1126 |
.IX Item "KeyTaskBarMoveNext=undefined" |
| 1127 |
Moves the task bar button of the current window |
| 1128 |
right. |
| 1129 |
.ie n .IP "\fBKeyTaskBarMovePrev\fR=""undefined""" 4 |
| 1130 |
.el .IP \fBKeyTaskBarMovePrev\fR=\f(CWundefined\fR 4 |
| 1131 |
.IX Item "KeyTaskBarMovePrev=undefined" |
| 1132 |
Moves the task bar button of the current window |
| 1133 |
left. |
| 1134 |
.ie n .IP "\fBKeySysWinListMenu\fR=""undefined""" 4 |
| 1135 |
.el .IP \fBKeySysWinListMenu\fR=\f(CWundefined\fR 4 |
| 1136 |
.IX Item "KeySysWinListMenu=undefined" |
| 1137 |
Shows the window list menu. |
| 1138 |
.ie n .IP "\fBKeySysKeyboardNext\fR=""undefined""" 4 |
| 1139 |
.el .IP \fBKeySysKeyboardNext\fR=\f(CWundefined\fR 4 |
| 1140 |
.IX Item "KeySysKeyboardNext=undefined" |
| 1141 |
Switch to the next keyboard layout in the KeyboardLayouts list. |
| 1142 |
.ie n .IP "\fBKeySysSwitchNext\fR=""Alt+Tab""" 4 |
| 1143 |
.el .IP \fBKeySysSwitchNext\fR=\f(CWAlt+Tab\fR 4 |
| 1144 |
.IX Item "KeySysSwitchNext=Alt+Tab" |
| 1145 |
Opens the \f(CW\*(C`QuickSwitch\*(C'\fR popup (see "INPUT FOCUS") |
| 1146 |
and/or moves the selector in the \f(CW\*(C`QuickSwitch\*(C'\fR popup. |
| 1147 |
.ie n .IP "\fBKeySysSwitchLast\fR=""Alt+Shift+Tab""" 4 |
| 1148 |
.el .IP \fBKeySysSwitchLast\fR=\f(CWAlt+Shift+Tab\fR 4 |
| 1149 |
.IX Item "KeySysSwitchLast=Alt+Shift+Tab" |
| 1150 |
Works like \f(CW\*(C`KeySysSwitchNext\*(C'\fR but moving in the |
| 1151 |
opposite direction. |
| 1152 |
.ie n .IP "\fBKeySysSwitchClass\fR=""Alt+grave""" 4 |
| 1153 |
.el .IP \fBKeySysSwitchClass\fR=\f(CWAlt+grave\fR 4 |
| 1154 |
.IX Item "KeySysSwitchClass=Alt+grave" |
| 1155 |
Is like \f(CW\*(C`KeySysSwitchNext\*(C'\fR but only for windows |
| 1156 |
with the same WM_CLASS property as the currently focused window. |
| 1157 |
.SS "MOUSE BINDINGS" |
| 1158 |
.IX Subsection "MOUSE BINDINGS" |
| 1159 |
You can control windows by a modified mouse button press: |
| 1160 |
.ie n .IP "\fBMouseWinMove\fR=""Alt+Pointer_Button1""" 4 |
| 1161 |
.el .IP \fBMouseWinMove\fR=\f(CWAlt+Pointer_Button1\fR 4 |
| 1162 |
.IX Item "MouseWinMove=Alt+Pointer_Button1" |
| 1163 |
Moves the window under the mouse over the screen. |
| 1164 |
.ie n .IP "\fBMouseWinSize\fR=""Alt+Pointer_Button3""" 4 |
| 1165 |
.el .IP \fBMouseWinSize\fR=\f(CWAlt+Pointer_Button3\fR 4 |
| 1166 |
.IX Item "MouseWinSize=Alt+Pointer_Button3" |
| 1167 |
Resizes the window. Keep the key and button pressed. |
| 1168 |
To enlarge the window move the mouse button away from the center. To |
| 1169 |
shrink it move towards the centre. |
| 1170 |
.ie n .IP "\fBMouseWinRaise\fR=""Ctrl+Alt+Pointer_Button1""" 4 |
| 1171 |
.el .IP \fBMouseWinRaise\fR=\f(CWCtrl+Alt+Pointer_Button1\fR 4 |
| 1172 |
.IX Item "MouseWinRaise=Ctrl+Alt+Pointer_Button1" |
| 1173 |
Raises the window under the mouse. |
| 1174 |
.ie n .IP "\fBMouseWinLower\fR=""Ctrl+Alt+Pointer_Button1""" 4 |
| 1175 |
.el .IP \fBMouseWinLower\fR=\f(CWCtrl+Alt+Pointer_Button1\fR 4 |
| 1176 |
.IX Item "MouseWinLower=Ctrl+Alt+Pointer_Button1" |
| 1177 |
Lowers the window under the mouse. |
| 1178 |
If this is equal to \f(CW\*(C`MouseWinRaise\*(C'\fR and the window can be raised |
| 1179 |
then \f(CW\*(C`MouseWinRaise\*(C'\fR takes preference over \f(CW\*(C`MouseWinLower\*(C'\fR. |
| 1180 |
.IP "\fBMouseWinTabbing\fR=""Shift+Pointer_Button2""" 4 |
| 1181 |
.IX Item "MouseWinTabbing=""Shift+Pointer_Button2""" |
| 1182 |
Mouse binding to create tabs. |
| 1183 |
Drag the title bar with this button over another title bar. |
| 1184 |
When they start to flash, release the button to merge the frame tabs. |
| 1185 |
.PP |
| 1186 |
The title frame of a window also listens for mouse clicks. A left |
| 1187 |
double-click maximizes the window (\f(CW\*(C`TitleBarMaximizeButton=1\*(C'\fR). |
| 1188 |
When Shift is also pressed it only maximizes vertically. |
| 1189 |
Press Alt+Shift to maximize horizontally. |
| 1190 |
.PP |
| 1191 |
Middle double-clicking rolls up the window (\f(CW\*(C`TitleBarRollupButton=2\*(C'\fR). |
| 1192 |
Also press Shift to maximize horizontally. If \fBTitleBarRollupButton\fR |
| 1193 |
is either 4 or 5 then the scroll wheel controls rolling up or down. |
| 1194 |
.PP |
| 1195 |
Press a mouse button on the title bar and drag it to move the window. |
| 1196 |
To drag a maximized window, keep the Shift key down. |
| 1197 |
A \f(CW\*(C`Alt+Pointer_Button1\*(C'\fR click in the title bar lowers the window. |
| 1198 |
.PP |
| 1199 |
When the mouse is on the window frame then a left click raises the |
| 1200 |
window. Dragging with the left button down resizes the window. |
| 1201 |
Clicking the right button pops up the context menu. Dragging with the |
| 1202 |
right button moves the window. |
| 1203 |
.PP |
| 1204 |
Double-clicking on the frame border (or corner) maximizes just that side |
| 1205 |
of the window. Another double-click restores that side. Double-clicking |
| 1206 |
on the border can also undo a maximization in that dimension. |
| 1207 |
.PP |
| 1208 |
Clicking on the desktop activates a menu. The middle button shows the |
| 1209 |
window list (\f(CW\*(C`DesktopWinListButton=2\*(C'\fR). The right button shows the |
| 1210 |
root menu (\f(CW\*(C`DesktopMenuButton=3\*(C'\fR). If you press \f(CW\*(C`Ctrl+Alt\*(C'\fR then |
| 1211 |
the mouse wheel will focus all applications in turn. |
| 1212 |
.SS SIGNALS |
| 1213 |
.IX Subsection "SIGNALS" |
| 1214 |
\&\fBicewm\fR supports the following signals: |
| 1215 |
.IP \fBSIGHUP\fR 4 |
| 1216 |
.IX Item "SIGHUP" |
| 1217 |
\&\fBicewm\fR will restart itself. It is a way to reload the configuration. |
| 1218 |
.IP "\fBSIGINT\fR, \fBSIGTERM\fR" 4 |
| 1219 |
.IX Item "SIGINT, SIGTERM" |
| 1220 |
\&\fBicewm\fR will cease to manage application windows and terminate. |
| 1221 |
.IP \fBSIGQUIT\fR 4 |
| 1222 |
.IX Item "SIGQUIT" |
| 1223 |
\&\fBicewm\fR will initiate the logout procedure. If a \f(CW\*(C`LogoutCommand\*(C'\fR |
| 1224 |
preferences option was configured it will be executed. |
| 1225 |
.IP \fBSIGUSR2\fR 4 |
| 1226 |
.IX Item "SIGUSR2" |
| 1227 |
Toggle the logging of X11 events, if \f(CW\*(C`logevents\*(C'\fR was configured. |
| 1228 |
.SS "ENVIRONMENT VARIABLES" |
| 1229 |
.IX Subsection "ENVIRONMENT VARIABLES" |
| 1230 |
.IP \fBICEWM_PRIVCFG\fR 4 |
| 1231 |
.IX Item "ICEWM_PRIVCFG" |
| 1232 |
The directory for user private configuration files. When this |
| 1233 |
environment variable is not specified, the default directory is |
| 1234 |
\&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm\fR when that directory exists, otherwise the |
| 1235 |
default value is \fI\fR\f(CI$HOME\fR\fI/.icewm\fR. |
| 1236 |
.IP \fBDISPLAY\fR 4 |
| 1237 |
.IX Item "DISPLAY" |
| 1238 |
The name of the X11 server. See \fBXorg\fR\|(1) or \fBXserver\fR\|(1). This |
| 1239 |
value can be overridden by the \fB\-\-display\fR option. |
| 1240 |
.IP "\fBMAILPATH\fR, \fBMAIL\fR" 4 |
| 1241 |
.IX Item "MAILPATH, MAIL" |
| 1242 |
Gives the location of your mailbox. If the schema is omitted the local |
| 1243 |
"file" schema is assumed. This is used by the mailbox applet in the |
| 1244 |
task bar to show the status of your mailbox. If the \f(CW\*(C`MailBoxPath\*(C'\fR |
| 1245 |
option in the \fIpreferences\fR file is set, then that one takes |
| 1246 |
precedence. |
| 1247 |
.SS FILES |
| 1248 |
.IX Subsection "FILES" |
| 1249 |
.SS "CONFIGURATION DIRECTORIES" |
| 1250 |
.IX Subsection "CONFIGURATION DIRECTORIES" |
| 1251 |
\&\fBicewm\fR looks for configuration files in the following directories, in |
| 1252 |
the given order, until it finds one: |
| 1253 |
.ie n .IP \fR\fI$ICEWM_PRIVCFG\fR\fI/\fR 4 |
| 1254 |
.el .IP \fR\f(CI$ICEWM_PRIVCFG\fR\fI/\fR 4 |
| 1255 |
.IX Item "$ICEWM_PRIVCFG/" |
| 1256 |
Contains user-specific configurations. When \fBICEWM_PRIVCFG\fR is |
| 1257 |
specified, this directory takes precedence over |
| 1258 |
\&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm\fR and \fI\fR\f(CI$HOME\fR\fI/.icewm\fR. |
| 1259 |
.ie n .IP \fR\fI$XDG_CONFIG_HOME\fR\fI/icewm/\fR 4 |
| 1260 |
.el .IP \fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm/\fR 4 |
| 1261 |
.IX Item "$XDG_CONFIG_HOME/icewm/" |
| 1262 |
Contains user-specific configurations. When this directory exists it |
| 1263 |
take precedence over \fR\f(CI$HOME\fR\fI/.icewm\fR. |
| 1264 |
.ie n .IP \fR\fI$HOME\fR\fI/.icewm/\fR 4 |
| 1265 |
.el .IP \fR\f(CI$HOME\fR\fI/.icewm/\fR 4 |
| 1266 |
.IX Item "$HOME/.icewm/" |
| 1267 |
Contains user-specific configurations. This is the historical default |
| 1268 |
directory. |
| 1269 |
.IP \fI/etc/X11/icewm/\fR 4 |
| 1270 |
.IX Item "/etc/X11/icewm/" |
| 1271 |
Contains system-wide customized defaults. Please note that your local |
| 1272 |
installation may have been configured to use a different system |
| 1273 |
location. The output of \f(CW\*(C`icewm \-\-directories\*(C'\fR will show this location. |
| 1274 |
.IP \fI/usr/share/icewm/\fR 4 |
| 1275 |
.IX Item "/usr/share/icewm/" |
| 1276 |
Default local installation settings. |
| 1277 |
.SS "CONFIGURATION FILES" |
| 1278 |
.IX Subsection "CONFIGURATION FILES" |
| 1279 |
.IP \fIenv\fR 4 |
| 1280 |
.IX Item "env" |
| 1281 |
\&\fBicewm\-session\fR\|(1) loads additional environment variables from the file |
| 1282 |
\&\fIenv\fR. Each line is subjected to POSIX shell expansion by |
| 1283 |
\&\fBwordexp\fR\|(3). Comment lines starting by a hash-sign (\f(CW\*(C`#\*(C'\fR) are ignored. |
| 1284 |
\&\fBicewm\-session\fR\|(1) will load those expanded lines that contain a name, |
| 1285 |
followed by an equals sign, followed by the value (which may be empty). |
| 1286 |
.Sp |
| 1287 |
See \fBicewm\-env\fR\|(5). |
| 1288 |
.IP \fIfocus_mode\fR 4 |
| 1289 |
.IX Item "focus_mode" |
| 1290 |
Defines the initial value for \f(CW\*(C`FocusMode\*(C'\fR. Its default value is |
| 1291 |
\&\f(CW\*(C`FocusMode=1\*(C'\fR (Click-to-focus). This can be changed via the menu. |
| 1292 |
\&\fBicewm\fR will save the Focus menu choice in this file. |
| 1293 |
.Sp |
| 1294 |
See \fBicewm\-focus_mode\fR\|(5). |
| 1295 |
.IP \fIkeys\fR 4 |
| 1296 |
.IX Item "keys" |
| 1297 |
Global keybindings to launch applications, which need not be window |
| 1298 |
manager related. Each non-empty line starts with the word \f(CW\*(C`key\*(C'\fR. |
| 1299 |
After one or more spaces follows a double-quoted string of the bound X11 |
| 1300 |
key combination like \f(CW\*(C`Alt+Ctrl+Shift+X\*(C'\fR. Then after at least one space |
| 1301 |
follows a shell command-line that will be executed by \fBicewm\fR whenever |
| 1302 |
this key combination is pressed. For example, the following line |
| 1303 |
creates a hotkey to reload the \fBicewm\fR configuration: |
| 1304 |
.Sp |
| 1305 |
.Vb 1 |
| 1306 |
\& key "Ctrl+Shift+r" icesh restart |
| 1307 |
.Ve |
| 1308 |
.Sp |
| 1309 |
See \fBicewm\-keys\fR\|(5). |
| 1310 |
.IP \fImenu\fR 4 |
| 1311 |
.IX Item "menu" |
| 1312 |
A menu of applications; usually customized by the user. \fBicewm\fR |
| 1313 |
provides the \fBicewm\-menu\-fdo\fR\|(1) program to generate a default menu. |
| 1314 |
Similar programs are \fBxdg_menu\fR\|(1), \fBmmaker\fR\|(1) (MenuMaker), |
| 1315 |
\&\fBxde\-menu\fR\|(1), \fBxdgmenumaker\fR\|(1). |
| 1316 |
.Sp |
| 1317 |
See \fBicewm\-menu\fR\|(5). |
| 1318 |
.IP \fIpreferences\fR 4 |
| 1319 |
.IX Item "preferences" |
| 1320 |
Contains general settings like paths, colors and fonts, but also options |
| 1321 |
to control the \fBicewm\fR focus behaviour and the applets that are |
| 1322 |
started in the task bar. The \fBicewm\fR installation will provide a |
| 1323 |
default \fIpreferences\fR file, which can be copied to the \fBicewm\fR user |
| 1324 |
configuration directory and modified. |
| 1325 |
.Sp |
| 1326 |
See \fBicewm\-preferences\fR\|(5). |
| 1327 |
.IP \fIprefoverride\fR 4 |
| 1328 |
.IX Item "prefoverride" |
| 1329 |
Settings which override the settings from a theme. Some of the \fBicewm\fR |
| 1330 |
configuration options from the preferences file that control the |
| 1331 |
look-and-feel may be overridden by the theme, if the theme designer |
| 1332 |
thinks this is desirable. However, this \fIprefoverride\fR file will again |
| 1333 |
override this for a few specific options of your choosing. It is safe |
| 1334 |
to leave this file empty initially. |
| 1335 |
.Sp |
| 1336 |
See \fBicewm\-prefoverride\fR\|(5). |
| 1337 |
.IP \fIprograms\fR 4 |
| 1338 |
.IX Item "programs" |
| 1339 |
An automatically generated menu of applications. This could be used by |
| 1340 |
\&\fBwmconfig\fR\|(1), menu or similar programs to give easy access to all the |
| 1341 |
desktop applications that are installed on the system. |
| 1342 |
.Sp |
| 1343 |
See \fBicewm\-programs\fR\|(5). |
| 1344 |
.IP \fItheme\fR 4 |
| 1345 |
.IX Item "theme" |
| 1346 |
This file contains the name of the default theme. On startup \fBicewm\fR |
| 1347 |
reads this file to obtain the theme name, unless \fBicewm\fR was started |
| 1348 |
with the \fB\-\-theme\fR option. Whenever a different theme is selected from |
| 1349 |
the \fBicewm\fR Menu then the theme file is overwritten with the name of |
| 1350 |
the selected theme. This theme file contains the keyword \f(CW\*(C`Theme\*(C'\fR, |
| 1351 |
followed by an equals sign, followed by a double-quoted string with the |
| 1352 |
theme name. The theme name is the name of the theme directory, followed |
| 1353 |
by a slash, followed by the theme file. Usually the theme file is just |
| 1354 |
\&\fIdefault.theme\fR, but a theme may have alternatives. Alternatives are |
| 1355 |
small tweaks of a theme. These are specified in their own \fI.theme\fR |
| 1356 |
file, which replaces \fIdefault.theme\fR. If no theme file exists then |
| 1357 |
\&\fBicewm\fR will use as default \f(CW\*(C`Theme="icedesert/default.theme"\*(C'\fR. |
| 1358 |
.Sp |
| 1359 |
See \fBicewm\-theme\fR\|(5). |
| 1360 |
.IP \fItoolbar\fR 4 |
| 1361 |
.IX Item "toolbar" |
| 1362 |
Contains names of quick to launch applications with icons for the task |
| 1363 |
bar. Each non-empty non-comment line starts with the keyword \fBprog\fR. |
| 1364 |
After one or more spaces follows a name, which is displayed in a tool |
| 1365 |
tip whenever the mouse cursor hovers over the toolbar icon. This name |
| 1366 |
may be a double quoted string. Then follows the bare name of the icon |
| 1367 |
to use without extensions. This icon will be shown in the toolbar. The |
| 1368 |
last component is a shell command-line that will be executed whenever |
| 1369 |
the user presses the icon in the toolbar. For example, the following |
| 1370 |
line in toolbar will create a button with tool tip \f(CW\*(C`Mozilla Firefox\*(C'\fR |
| 1371 |
with the \fIfirefox\fR icon that launches \fBfirefox\fR\|(1) when clicked: |
| 1372 |
.Sp |
| 1373 |
.Vb 1 |
| 1374 |
\& prog "Mozilla Firefox" firefox /usr/bin/firefox \-\-private\-window |
| 1375 |
.Ve |
| 1376 |
.Sp |
| 1377 |
See \fBicewm\-toolbar\fR\|(5). |
| 1378 |
.IP \fIwinoptions\fR 4 |
| 1379 |
.IX Item "winoptions" |
| 1380 |
Contains settings to control window appearance and behaviour that are |
| 1381 |
specific to applications or groups of applications. Options can control |
| 1382 |
the border, whether it appears on the task bar, the window list, the |
| 1383 |
system tray and the workspaces. Also its layer, geometry, whether it |
| 1384 |
can be moved, resized and closed. |
| 1385 |
.Sp |
| 1386 |
See \fBicewm\-winoptions\fR\|(5). |
| 1387 |
.IP \fIstartup\fR 4 |
| 1388 |
.IX Item "startup" |
| 1389 |
Contains commands to be executed on \fBicewm\fR startup. This is an |
| 1390 |
executable script with commands to tweak X11 settings and launch some |
| 1391 |
applications that need to be active whenever \fBicewm\fR is started. |
| 1392 |
It is run by \fBicewm\-session\fR\|(1) when \fBicewm\fR starts. |
| 1393 |
.Sp |
| 1394 |
See \fBicewm\-startup\fR\|(5). |
| 1395 |
.IP \fIshutdown\fR 4 |
| 1396 |
.IX Item "shutdown" |
| 1397 |
Contains commands to be executed on \fBicewm\fR shutdown. This is an |
| 1398 |
executable script with commands to be executed in the last stage of |
| 1399 |
\&\fBicewm\fR termination. Typically they may undo some of the effects of |
| 1400 |
the \fIstartup\fR script. It is run by \fBicewm\-session\fR\|(1) when \fBicewm\fR |
| 1401 |
terminates. |
| 1402 |
.Sp |
| 1403 |
See \fBicewm\-shutdown\fR\|(5). |
| 1404 |
.SS "CONFIGURATION SUBDIRECTORIES" |
| 1405 |
.IX Subsection "CONFIGURATION SUBDIRECTORIES" |
| 1406 |
.IP \fIcursors\fR 4 |
| 1407 |
.IX Item "cursors" |
| 1408 |
May contain cursor icons in the XPM image format. These overrule cursors |
| 1409 |
provided by a theme. There are 3 direction cursors: \fIleft.xpm\fR, |
| 1410 |
\&\fIright.xpm\fR, \fImove.xpm\fR, 8 resize cursors: \fIsizeR.xpm\fR, \fIsizeTR.xpm\fR, |
| 1411 |
\&\fIsizeT.xpm\fR, \fIsizeTL.xpm\fR, \fIsizeL.xpm\fR, \fIsizeBL.xpm\fR, \fIsizeB.xpm\fR, |
| 1412 |
\&\fIsizeBR.xpm\fR, and 4 scroll cursors: \fIscrollL.xpm\fR, \fIscrollR.xpm\fR, |
| 1413 |
\&\fIscrollU.xpm\fR, and \fIscrollD.xpm\fR. |
| 1414 |
.Sp |
| 1415 |
By default an XPM header defines four dimensions: width, height, colors |
| 1416 |
and chars-per-pixel. For cursors this must be extended to six. The last |
| 1417 |
two are the \fIx\-hotspot\fR and the \fIy\-hotspot\fR. These define which point |
| 1418 |
in the XPM image is the sensitive point for the mouse pointer. |
| 1419 |
.Sp |
| 1420 |
Instead of XPM images, a theme may use Xcursor files instead. |
| 1421 |
These then don't have a filename extension. |
| 1422 |
.Sp |
| 1423 |
When a theme doesn't define a cursor, icewm falls back to the system |
| 1424 |
cursor themes for Xcursor, if they are installed. This is configurable |
| 1425 |
by the following environment variables: |
| 1426 |
.RS 4 |
| 1427 |
.IP XCURSOR_PATH 4 |
| 1428 |
.IX Item "XCURSOR_PATH" |
| 1429 |
Where to look for themed cursors. |
| 1430 |
.IP XCURSOR_SIZE 4 |
| 1431 |
.IX Item "XCURSOR_SIZE" |
| 1432 |
The cursor size in pixels. |
| 1433 |
.IP XCURSOR_THEME 4 |
| 1434 |
.IX Item "XCURSOR_THEME" |
| 1435 |
The name of the cursor theme. |
| 1436 |
.RE |
| 1437 |
.RS 4 |
| 1438 |
.Sp |
| 1439 |
The last two can also be set as an X\-resource: |
| 1440 |
.Sp |
| 1441 |
.Vb 2 |
| 1442 |
\& Xcursor.size: 24 |
| 1443 |
\& Xcursor.theme: whiteglass |
| 1444 |
.Ve |
| 1445 |
.Sp |
| 1446 |
Otherwise core X11 cursors are used. |
| 1447 |
.RE |
| 1448 |
.IP \fIicons\fR 4 |
| 1449 |
.IX Item "icons" |
| 1450 |
Contains icons for applications and keyboard layouts. These can be in |
| 1451 |
XPM, PNG or SVG format. The filename of an \fIapplication icon\fR may |
| 1452 |
follow a specific naming pattern, like \fIapp_32x32.xpm\fR. They start |
| 1453 |
with a base name, which usually is just a single word. Then follows |
| 1454 |
an underscore, followed by a size specification, as in \f(CW\*(C`SIZExSIZE\*(C'\fR. |
| 1455 |
This is followed by a dot and the file extension, where the extension |
| 1456 |
denotes the icon image format. Common sizes are 16, 32 and 48. |
| 1457 |
This depends on the respective \f(CW\*(C`IconSize\*(C'\fR preferences options. |
| 1458 |
.IP \fIledclock\fR 4 |
| 1459 |
.IX Item "ledclock" |
| 1460 |
Pictures of digits for the LED clock which is displayed in the |
| 1461 |
bottom-right corner of the task bar. These can be seen when the |
| 1462 |
\&\f(CW\*(C`TaskBarShowClock\*(C'\fR and \f(CW\*(C`TaskBarClockLeds\*(C'\fR options are both set to 1. |
| 1463 |
.IP \fImailbox\fR 4 |
| 1464 |
.IX Item "mailbox" |
| 1465 |
Icons that are used to display different states of the mailbox applet |
| 1466 |
in the task bar. There are five states and each has its own icon: |
| 1467 |
\&\fImail.xpm\fR, \fInewmail.xpm\fR, \fIunreadmail.xpm\fR, \fInomail.xpm\fR, |
| 1468 |
\&\fIerrmail.xpm\fR. |
| 1469 |
.IP \fIsounds\fR 4 |
| 1470 |
.IX Item "sounds" |
| 1471 |
Audio files that are played by \fBicesound\fR\|(1) on GUI events. These |
| 1472 |
are: \fIstartup.wav\fR, \fIshutdown.wav\fR, \fIrestart.wav\fR, \fIlaunchApp.wav\fR, |
| 1473 |
\&\fIworkspaceChange.wav\fR, \fIwindowOpen.wav\fR, \fIwindowClose.wav\fR, |
| 1474 |
\&\fIdialogOpen.wav\fR, \fIdialogClose.wav\fR, \fIwindowMax.wav\fR, |
| 1475 |
\&\fIwindowRestore.wav\fR, \fIwindowMin.wav\fR, \fIwindowHide.wav\fR, |
| 1476 |
\&\fIwindowRollup.wav\fR, \fIwindowMoved.wav\fR, \fIwindowSized.wav\fR, |
| 1477 |
\&\fIwindowLower.wav\fR. |
| 1478 |
.IP \fItaskbar\fR 4 |
| 1479 |
.IX Item "taskbar" |
| 1480 |
Pictures to customize the look of the task bar. These include: |
| 1481 |
\&\fItaskbarbg.xpm\fR, \fItaskbuttonactive.xpm\fR, \fItaskbuttonbg.xpm\fR, |
| 1482 |
\&\fItaskbuttonminimized.xpm\fR, \fItoolbuttonbg.xpm\fR, |
| 1483 |
\&\fIworkspacebuttonactive.xpm\fR, \fIworkspacebuttonbg.xpm\fR. |
| 1484 |
.IP \fIthemes\fR 4 |
| 1485 |
.IX Item "themes" |
| 1486 |
A directory to store themes. Each theme is stored in its own |
| 1487 |
sub-directory in the \fIthemes\fR directory. A theme contains at least a |
| 1488 |
\&\fIdefault.theme\fR file, and optionally theme alternatives which are |
| 1489 |
additional files that have a \fI.theme\fR file name extension and that |
| 1490 |
contain tweaks of the \fIdefault.theme\fR file. |
| 1491 |
How to create a theme is explained in the |
| 1492 |
IceWM Theme Creation Howto. |
| 1493 |
.IP \fIworkspace\fR 4 |
| 1494 |
.IX Item "workspace" |
| 1495 |
If \f(CW\*(C`PagerShowPreview\*(C'\fR is disabled, icewm looks in the \f(CW\*(C`workspace\*(C'\fR |
| 1496 |
directory for images to draw on a workspace button. The image filename |
| 1497 |
should have the name of the workspace. The image extension is optional. |
| 1498 |
.SS OPACITY |
| 1499 |
.IX Subsection "OPACITY" |
| 1500 |
IceWM supports window opacity and transparency in connection with an |
| 1501 |
external compositor like \fBcompton\fR\|(1) or \fBpicom\fR\|(1). |
| 1502 |
If a client window sets the \f(CW\*(C`_NET_WM_WINDOW_OPACITY\*(C'\fR property on |
| 1503 |
its window, then \fBicewm\fR will copy this to the outer frame window, |
| 1504 |
where the compositor will read it and adjust the opacity accordingly. |
| 1505 |
.PP |
| 1506 |
The opacity can also be set in the \fBicewm\-winoptions\fR\|(5) file. |
| 1507 |
\&\fBicesh\fR\|(1) can control the opacity level of running applications. |
| 1508 |
.PP |
| 1509 |
The _NET_WM_WINDOW_TYPE properties that \fBicewm\fR sets on its windows |
| 1510 |
are \fIDIALOG\fR, \fINOTIFICATION\fR, \fIPOPUP_MENU\fR and \fITOOLTIP\fR. The output |
| 1511 |
of \f(CW\*(C`icesh windows\*(C'\fR shows their WM_CLASS values. These can be helpful |
| 1512 |
to configure compton. |
| 1513 |
.SS EXAMPLES |
| 1514 |
.IX Subsection "EXAMPLES" |
| 1515 |
Examples of the above configuration files can be found in the default |
| 1516 |
installation path or in the system-wide defaults. See the output of |
| 1517 |
\&\f(CW\*(C`icewm \-\-directories\*(C'\fR for their locations. |
| 1518 |
.SS "CONFORMING TO" |
| 1519 |
.IX Subsection "CONFORMING TO" |
| 1520 |
ICCCM 2.0: partial. NetWM/EWMH: extensive. |
| 1521 |
See the file \fICOMPLIANCE\fR in the distribution for full details. |
| 1522 |
.SS "SEE ALSO" |
| 1523 |
.IX Subsection "SEE ALSO" |
| 1524 |
\&\fBicehelp\fR\|(1), |
| 1525 |
\&\fBicesh\fR\|(1), |
| 1526 |
\&\fBicesound\fR\|(1), |
| 1527 |
\&\fBicewm\-env\fR\|(5), |
| 1528 |
\&\fBicewm\-focus_mode\fR\|(5), |
| 1529 |
\&\fBicewm\-keys\fR\|(5), |
| 1530 |
\&\fBicewm\-menu\fR\|(5), |
| 1531 |
\&\fBicewm\-menu\-fdo\fR\|(1), |
| 1532 |
\&\fBicewm\-menu\-xrandr\fR\|(1), |
| 1533 |
\&\fBicewm\-preferences\fR\|(5), |
| 1534 |
\&\fBicewm\-prefoverride\fR\|(5), |
| 1535 |
\&\fBicewm\-programs\fR\|(5), |
| 1536 |
\&\fBicewm\-session\fR\|(1), |
| 1537 |
\&\fBicewm\-set\-gnomewm\fR\|(1), |
| 1538 |
\&\fBicewm\-shutdown\fR\|(5), |
| 1539 |
\&\fBicewm\-startup\fR\|(5), |
| 1540 |
\&\fBicewm\-theme\fR\|(5), |
| 1541 |
\&\fBicewm\-toolbar\fR\|(5), |
| 1542 |
\&\fBicewm\-winoptions\fR\|(5), |
| 1543 |
\&\fBicewmbg\fR\|(1), |
| 1544 |
\&\fBicewmhint\fR\|(1), |
| 1545 |
\&\fBsetxkbmap\fR\|(1), |
| 1546 |
\&\fBXorg\fR\|(1), |
| 1547 |
\&\fBXserver\fR\|(1), |
| 1548 |
\&\fBxinit\fR\|(1), |
| 1549 |
\&\fBxprop\fR\|(1), |
| 1550 |
\&\fBxwininfo\fR\|(1), |
| 1551 |
\&\fBwmctrl\fR\|(1). |
| 1552 |
.SS BUGS |
| 1553 |
.IX Subsection "BUGS" |
| 1554 |
Please report bugs at <https://github.com/ice\-wm/icewm/issues>. |
| 1555 |
.SS AUTHOR |
| 1556 |
.IX Subsection "AUTHOR" |
| 1557 |
Brian Bidulock <mailto:[email protected]>. |
| 1558 |
.PP |
| 1559 |
See \fB\-\-copying\fR for full copyright notice and copying permissions. |
| 1560 |
.SS LICENSE |
| 1561 |
.IX Subsection "LICENSE" |
| 1562 |
\&\fBIceWM\fR is licensed under the GNU Library General Public License. |
| 1563 |
See the \fICOPYING\fR file in the distribution or use the \fB\-\-copying\fR flag |
| 1564 |
to display copying permissions. |