.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "ICEWM 1" .TH ICEWM 1 "2021-02-09" "icewm\ 2.1.2" "User\ Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" .Vb 1 \& icewm \- lightweight X11 window manager .Ve .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBicewm\fR [\fI\s-1OPTIONS\s0\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBicewm\fR is a window manager for the X11 window system. It aims to be small, fast and familiar to new users. .PP \&\fBicewm\fR is called a re-parenting window manager, because it draws small frames around application windows. By dragging this frame with the mouse, windows are resized or moved. .PP Because windows may overlap, \fBicewm\fR is also a stacking window manager. Many windows may exist, some hidden behind others. .PP \&\fBicewm\fR supports a configurable number of virtual desktops. These are called workspaces. Related windows are grouped on a dedicated workspace. By switching between workspaces, the user can attend to different tasks, while keeping oversight. This is supported by a task bar and a pager. .PP The installation comes with several themes. Choose a theme via a menu. .PP \&\fBicewm\fR is compliant with the \s-1ICCCM\s0 and \s-1EWMH\s0 window manager specifications. .SS "\s-1PROGRAMS\s0" .IX Subsection "PROGRAMS" The \fBicewm\fR package includes several programs: .IP "\fBicewm\fR\|(1)" 4 .IX Item "icewm" The actual window manager. It positions application windows on screen and decorates them with borders. It gives input focus to the current active application. \fBicewm\fR supports different focus modes, which are explained below. It draws a small task bar at the bottom of the screen, which gives easy access to programs, to virtual desktops, to active applications, and to a small set of monitoring applets. .IP "\fBicewmbg\fR\|(1)" 4 .IX Item "icewmbg" The background setting application. It can assign plain background color or images in different formats to the X background. Each work space can have its own background. It supports semi-transparency. Semitransparent background image and colour can be configured. When the background image has changed then \fBicewmbg\fR\|(1) can be notified to update the background. Multi-head monitor setups are fully supported. This program should be started before \fBicewm\fR. See the \fBicewmbg\fR\|(1) man page for details. .IP "\fBicewm\-session\fR\|(1)" 4 .IX Item "icewm-session" \&\fBicewm\-session\fR\|(1) is the preferred program to start the IceWM system. It first loads additional environment variables from the optional \&\fIenv\fR file. Then it starts \fBicewmbg\fR\|(1) and \fBicewm\fR. It also runs the \fIstartup\fR script and implements basic session management. On termination the \fIshutdown\fR script will be run first, then \&\fBicewm\-session\fR\|(1) will terminate \fBicewm\fR and \fBicewmbg\fR\|(1). \&\fBicewm\-session\fR\|(1) will also start the optional \fBicesound\fR\|(1) if you give it the \fB\-\-sound\fR option. See \fBicewm\-session\fR\|(1). .IP "\fBicesh\fR\|(1)" 4 .IX Item "icesh" A powerful tool to control window properties and to interact with the window manager. It is typically used in shell scripts. See \fBicesh\fR\|(1). .IP "\fBicehelp\fR\|(1)" 4 .IX Item "icehelp" A small document browser, which is used by \fBicewm\fR to display the \&'IceWM manual' and some man pages. .IP "\fBicewmhint\fR\|(1)" 4 .IX Item "icewmhint" A utility for passing IceWM-specific window options to \fBicewm\fR. The options are used to configure the first application which is started subsequently. See \fBicewmhint\fR\|(1). .IP "\fBicesound\fR\|(1)" 4 .IX Item "icesound" Plays audio files on \s-1GUI\s0 events which are raised by \fBicewm\fR. It supports \s-1ALSA, AO\s0 and \s-1OSS.\s0 See the \fBicesound\fR\|(1) man page. .IP "\fBicewm\-menu\-fdo\fR\|(1)" 4 .IX Item "icewm-menu-fdo" Generate an \fBicewm\fR menu with executable desktop applications according to \s-1XDG\s0 specifications. See the \fBicewm\-menu\-fdo\fR\|(1) man page. .IP "\fBicewm\-set\-gnomewm\fR\|(1)" 4 .IX Item "icewm-set-gnomewm" Configures \s-1GNOME\s0 to start IceWM instead of its own \s-1WM.\s0 .SH "OPTIONS" .IX Header "OPTIONS" .SS "\s-1COMMON OPTIONS\s0" .IX Subsection "COMMON OPTIONS" Each of the IceWM executables supports the following options: .IP "\fB\-c\fR, \fB\-\-config\fR=\fI\s-1FILE\s0\fR" 4 .IX Item "-c, --config=FILE" Use \fI\s-1FILE\s0\fR as the source of configuration options. By default \fBicewm\fR looks for a file named \fIpreferences\fR. Typically this file is stored as one of \fI\f(CI$ICEWM_PRIVCFG\fI/preferences\fR, \&\fI\f(CI$XDG_CONFIG_HOME\fI/icewm/preferences\fR, or \fI\f(CI$HOME\fI/.icewm/preferences\fR, or in one of the configuration directories explained below. It contains a long list of options which allow the user to tweak the behaviour of \&\fBicewm\fR to ones taste. A default \fIpreferences\fR file contains comments about the purpose of each option, the range of useful values and the current or default value. A \fIpreferences\fR file is a readable text file which can be modified with the help of a text editor. If this option is given to \fBicewm\-session\fR\|(1) then it is passed on to \fBicewm\fR. If \&\fBicewm\fR is started independently then this option can be given to \&\fBicewm\fR directly. However, usually one will want to use a \&\fIpreferences\fR file from a default location. .IP "\fB\-t\fR, \fB\-\-theme\fR=\fI\s-1NAME\s0\fR" 4 .IX Item "-t, --theme=NAME" Use \fI\s-1NAME\s0\fR as the name of the \fBicewm\fR theme to use. A theme defines the look and feel of \fBicewm\fR, like colours, fonts, buttons and button behaviour. Originally a theme defined options to emulate the appearance of other desktop environments, like Motif, \s-1OS/2\s0 Warp, or Windows. Over the years many new original themes have been designed with beautiful icons and backgrounds, which advance the state of the art in desktop look and feel. Many of them can be downloaded from the website and stored in one of the directories \&\fI\f(CI$ICEWM_PRIVCFG\fI/icewm/themes/\fR, \fI\f(CI$XDG_CONFIG_HOME\fI/icewm/themes/\fR or in \&\fI\f(CI$HOME\fI/.icewm/themes/\fR. You can then activate such a theme via the menu in the lower left corner of the display. A default theme is specified in one of \fI\f(CI$ICEWM_PRIVCFG\fI/icewm/theme\fR, \&\fI\f(CI$XDG_CONFIG_HOME\fI/icewm/theme\fR, or in \fI\f(CI$HOME\fI/.icewm/theme\fR. When a new theme is selected then this value is overwritten, so that the next time \fBicewm\fR is started this choice is reused. .IP "\fB\-\-display\fR=\fI\s-1DISPLAY\s0\fR" 4 .IX Item "--display=DISPLAY" \&\fI\s-1DISPLAY\s0\fR specifies the connection to the X11 server. If this option is missing, as is usually the case, then \fI\s-1DISPLAY\s0\fR is read from the environment variable \f(CW\*(C`DISPLAY\*(C'\fR. .IP "\fB\-\-sync\fR" 4 .IX Item "--sync" This option is sometimes used in software development of \fBicewm\fR. It specifies to use a slower synchronous communication mode with the X11 server. This is irrelevant for normal use of \fBicewm\fR. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Gives a complete list of all the available command-line options with some very brief explanation. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Shows the software release version for this program. .SS "\s-1ICEWM OPTIONS\s0" .IX Subsection "ICEWM OPTIONS" The \fBicewm\fR program supports some additional options: .IP "\fB\-a\fR, \fB\-\-alpha\fR" 4 .IX Item "-a, --alpha" Use a 32\-bit visual for translucency. This can also be set in the preferences file as \f(CW\*(C`Alpha=1\*(C'\fR. .IP "\fB\-\-replace\fR" 4 .IX Item "--replace" Instructs \fBicewm\fR to replace an existing window manager. Provided that the window manager being replaced is \s-1ICCCM 2.0\s0 compliant, once it notices that it is to be replaced it will cease operations and typically stop execution. This allows \fBicewm\fR to establish itself as the only active window manager. .IP "\fB\-r\fR, \fB\-\-restart\fR" 4 .IX Item "-r, --restart" Tell \fBicewm\fR to restart itself. This reloads the configuration from file. .IP "\fB\-s\fR, \fB\-\-splash\fR=\fI\s-1IMAGE\s0\fR" 4 .IX Item "-s, --splash=IMAGE" Briefly show \fI\s-1IMAGE\s0\fR on startup in the center of the screen. This can also be set in the preferences file as Splash=\f(CW\*(C`image.jpg\*(C'\fR. .IP "\fB\-\-configured\fR" 4 .IX Item "--configured" Shows a list of configuration options which were enabled when \fBicewm\fR was compiled from source code. This can be helpful if one suspects some functionality may be missing. .IP "\fB\-\-directories\fR" 4 .IX Item "--directories" Gives a list of directories where \fBicewm\fR will look for configuration data. This list is printed in the actual order in which \fBicewm\fR uses it to search for configuration files. .IP "\fB\-l\fR, \fB\-\-list\-themes\fR" 4 .IX Item "-l, --list-themes" \&\fBicewm\fR will search all the configuration directories for theme files and print a list of all found themes. .IP "\fB\-p\fR, \fB\-\-postpreferences\fR" 4 .IX Item "-p, --postpreferences" This gives a long list of all the internal \fBicewm\fR options with their actual values after \fBicewm\fR has processed all of the configuration and theme files. In some advanced scenarios this can be helpful to inspect which configuration was chosen or whether option formatting was correct. .IP "\fB\-\-extensions\fR" 4 .IX Item "--extensions" Give a list of the current X extensions, their versions and status. .IP "\fB\-\-trace\fR=\fIconf\fR,\fIicon\fR,\fIprog\fR,\fIsystray\fR" 4 .IX Item "--trace=conf,icon,prog,systray" Enable tracing of the paths which are used to load configuration, and/or icons, and/or executed programs, and/or system tray applets. .SH "USAGE" .IX Header "USAGE" .SS "\s-1TASKBAR\s0" .IX Subsection "TASKBAR" On startup \fBicewm\fR launches the task bar at the bottom of the screen. The task bar consists from left to right of the following components: .PP The \fIMenu\fR button in the lower left corner gives access to the \fBicewm\fR root menu. This menu has sub-menus to start applications, to control \&\fBicewm\fR settings, and the \fBicewm\fR \fILogout\fR menu. .PP The \fIShow Desktop\fR button unmaps all application windows to fully uncover the desktop. .PP The \fIWindow List Menu\fR button gives access to a menu with a list of active windows for the current work space and a list of work spaces with sub-menus for their active application windows. .PP The \fIToolbar\fR is a list of icons for applications which are defined in the toolbar configuration file. .PP The \fIWorkspace List\fR shows one button for each work space. The current work space is indicated by a pressed button. Pressing another work space button switches to that work space. The work spaces are defined in the \&\fIpreferences\fR file. When \f(CW\*(C`PagerShowPreview\*(C'\fR is turned on a small graphical summary for each workspace is shown. .PP The \fITask Pane\fR consists of a list of wide buttons for each application which is running on the current work space, or all workspaces if \&\f(CW\*(C`TaskBarShowAllWindows=1\*(C'\fR. Each task button shows the application icon and the application title. The active application is indicated by a pressed button. This is the application which has input focus. Pressing another button activates that application: it is brought to the foreground and receives input focus. Other mouse controlled activities on the window buttons are: dragging window buttons with the left mouse button to rearrange the order, closing the application window with \f(CW\*(C`Alt\*(C'\fR + middle button, lowering the application window with \&\f(CW\*(C`Ctrl\*(C'\fR + middle button, or bringing the application window to the current workspace with \f(CW\*(C`Shift\*(C'\fR + middle button if \f(CW\*(C`TaskBarShowAllWindows=1\*(C'\fR. .PP If there are not many application buttons then a stretch of plain task bar is visible. Clicking on it with the right mouse button gives the task bar menu. Even with a full task pane, this menu can be usually accessed by right-clicking the bottom right corner of the taskbar. .PP The \fITray Applet\fR shows system tray objects. .PP The \fI\s-1APM\s0 Applet\fR shows battery power status. .PP The \fINet Applet\fR shows network activity. Network devices to monitor are given by the \f(CW\*(C`NetworkStatusDevice\*(C'\fR option. .PP The \fIMemory Applet\fR monitors memory usage. .PP The \fI\s-1CPU\s0 Applet\fR monitors processor utilization. .PP The \fIMailbox Applet\fR monitors mailbox status changes. See the section \s-1MAILBOX MONITORING\s0 below. .PP The \fIClock Applet\fR shows the current time and date. It is configured by the \f(CW\*(C`TimeFormat\*(C'\fR option. .PP The \fITask Bar Collapse\fR button collapses the task bar and hides it. .PP Not all \fBicewm\fR applets may show up on the task bar. They must have been enabled during configuration of the \fBicewm\fR software. Their appearance is also controlled by options in the \fIpreferences\fR file. .SS "\s-1INPUT FOCUS\s0" .IX Subsection "INPUT FOCUS" Of all visible windows only one can be the active window. This is the window which has input focus. It is the primary receiver of keyboard and mouse events and hence one can interact with the application which created that window. A primary task of a window manager is to allow the user to switch input focus between different windows. The primary means to do this is the mouse pointer. By moving the mouse pointer over the screen to another window, and perhaps also by clicking on a window, input focus can be directed. .PP The \f(CW\*(C`FocusMode\*(C'\fR option controls the way \fBicewm\fR gives input focus to applications. It is initialized by the \fIfocus_mode\fR configuration file. The focus mode is set via the \fIFocus\fR menu. \fBicewm\fR supports six focus models: .IP "\fB1. Click-to-focus\fR" 4 .IX Item "1. Click-to-focus" The default focus mode. In this mode changing input focus requires to click a window with the left mouse button. The window is raised if needed. When an application requests focus its task pane button flashes. This gives the option to honor this request or to ignore it. When a new application window appears it automatically receives focus. Also when a hidden application raises to the front it receives focus. .IP "\fB2. Sloppy-mouse-focus\fR" 4 .IX Item "2. Sloppy-mouse-focus" Sets input focus merely by moving the mouse pointer over a window. It is called sloppy, because if the mouse then leaves the window and moves to the desktop background the input focus remains with the last active window. When a window receives focus it is raised. When an application requests focus its task pane button flashes. A new application or an application which raises to the front automatically receives focus. .IP "\fB3. Explicit-focus\fR" 4 .IX Item "3. Explicit-focus" Focus is even more user-controlled than \fBClick-to-focus\fR. When a window receives focus it is not raised by default, unless the frame border is clicked. No flashing occurs when an application requests focus. When a new application window appears it does not receive focus. Only by explicit clicking on a window is focus directed. .IP "\fB4. Strict-mouse-focus\fR" 4 .IX Item "4. Strict-mouse-focus" Like \fBSloppy\fR but focus remains with the last window. New applications don't receive focus and are mapped behind other windows. When an application raises to the front it still does not get focus. .IP "\fB5. Quiet-sloppy-focus\fR" 4 .IX Item "5. Quiet-sloppy-focus" Like \fBSloppy\fR but no disturbing flashing occurs on the task bar when an application requests focus. .IP "\fB6. Custom-mode\fR" 4 .IX Item "6. Custom-mode" A focus mode which is defined in detail by ten options in the \&\fIpreferences\fR file. These are: \&\f(CW\*(C`ClickToFocus\*(C'\fR, \&\f(CW\*(C`FocusOnAppRaise\*(C'\fR, \&\f(CW\*(C`RequestFocusOnAppRaise\*(C'\fR, \&\f(CW\*(C`RaiseOnFocus\*(C'\fR, \&\f(CW\*(C`RaiseOnClickClient\*(C'\fR, \&\f(CW\*(C`FocusChangesWorkspace\*(C'\fR, \&\f(CW\*(C`FocusOnMap\*(C'\fR, \&\f(CW\*(C`FocusOnMapTransient\*(C'\fR, \&\f(CW\*(C`FocusOnMapTransientActive\*(C'\fR, \&\f(CW\*(C`MapInactiveOnTop\*(C'\fR. .Sp All non-Custom focus modes override these ten options. .PP Apart from the mouse, \fBicewm\fR supports changing input focus in two other ways. Both involve the keyboard. The first uses the \&\f(CW\*(C`QuickSwitch\*(C'\fR window. It is activated by pressing \f(CW\*(C`Alt+Tab\*(C'\fR or \&\f(CW\*(C`Alt+Shift+Tab\*(C'\fR. A window pops up in the centre of the screen with a narrow band over the next or previous window which will receive input focus when the \f(CW\*(C`Alt\*(C'\fR key is released. By repeatedly pressing \&\f(CW\*(C`Alt+Tab\*(C'\fR or \f(CW\*(C`Alt+Shift+Tab\*(C'\fR one can cycle through all windows. .PP The second keyboard method involves pressing \f(CW\*(C`Alt+Esc\*(C'\fR or \&\f(CW\*(C`Alt+Shift+Esc\*(C'\fR. Input focus is immediately changed to the next or previous window, which will be raised to make it fully visible. .PP And finally, there is another way which is a hybrid of keyboard and mouse control. It involves the \f(CW\*(C`QuickSwitch\*(C'\fR popup explained before, after pressing \f(CW\*(C`Alt+Tab\*(C'\fR and while still holding \f(CW\*(C`Alt\*(C'\fR a left click on one of the list items causes the activation of the related window. .SS "\s-1WINDOW PLACEMENT\s0" .IX Subsection "WINDOW PLACEMENT" A second important task of a window manager is to place new windows on the screen. By default \fBicewm\fR chooses a placement with minimal overlap, but this is determined by the \f(CW\*(C`SmartPlacement\*(C'\fR option in the \&\fIpreferences\fR file. If \f(CW\*(C`SmartPlacement\*(C'\fR is turned off then windows are placed in sequence from left to right and top to bottom. One can also turn on \f(CW\*(C`ManualPlacement\*(C'\fR. Then new windows appear initially in the top left corner and the mouse cursor changes into a fist. By moving the fist cursor to a suitable location and clicking the new window will appear at the mouse click location. .SS "\s-1WINDOW LAYERS\s0" .IX Subsection "WINDOW LAYERS" Windows can overlap. Which window appears on top is determined by three features. Newer windows appear over older windows. By clicking on a window it is raised to the top. But both are overruled by the window layer. Windows can be placed in different layers via the \fILayers\fR menu. Click with the right mouse button on the window frame and select \&\fILayer\fR. From there choose one of seven window layers. These are ordered from higher to lower. Windows in higher layers appear over windows in lower layers. .SS "\s-1WORKSPACES\s0" .IX Subsection "WORKSPACES" \&\fBicewm\fR supports multiple virtual desktops called work spaces. A work space is like a screen where a subset of all application windows are mapped. Thanks to multiple work spaces we can more easily manage a large number of applications. The number of work spaces and their names are configurable in the \fIpreferences\fR file through the \&\f(CW\*(C`WorkspaceNames\*(C'\fR option. By default four workspaces are created with the names 1, 2, 3 and 4 thus: .PP .Vb 1 \& WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 " .Ve .PP This syntax is typical for \fBicewm\fR options which receive multiple values. It is a list of comma-separated values each of which can be quoted. .PP The work spaces are visible on the toolbar. One can switch to a different work space by pressing the work space button in the toolbar, but after becoming familiar with the 'keyboard shortcuts' below one will want to use a hotkey to choose a work space. If the \f(CW\*(C`EdgeSwitch\*(C'\fR options is enabled in the \fIpreferences\fR file (with sub-options \&\f(CW\*(C`HorizontalEdgeSwitch\*(C'\fR and \f(CW\*(C`VerticalEdgeSwitch\*(C'\fR) then one can move to the next or previous workspace by moving the mouse to the edge of the screen. The \f(CW\*(C`ContinuousEdgeSwitch\*(C'\fR option enables continuous movement to subsequent workspaces. The \f(CW\*(C`EdgeSwitchDelay\*(C'\fR option says how long to wait before a change of workspace occurs. .PP To move an application window to a different work space one can use a keyboard shortcut. Another option is to select the \fIMove To\fR submenu in the window menu of the window frame. .SS "\s-1ADDRESS BAR\s0" .IX Subsection "ADDRESS BAR" If \fBEnableAddressBar\fR=1 then \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+Space\*(C'\fR activates the address bar in the task bar. If \fBShowAddressBar\fR=1 it is always shown. This is a command-line in the task bar where a shell command can be typed. Pressing \f(CW\*(C`Enter\*(C'\fR will execute the command. \&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR will be used to execute the command. On \f(CW\*(C`Control+Enter\*(C'\fR the command is executed in a terminal as given by \fBTerminalCommand\fR. The address bar maintains a history which is navigable by the \fIUp\fR and \fIDown\fR keys. It supports command completion using \f(CW\*(C`Tab\*(C'\fR or \f(CW\*(C`Ctrl+I\*(C'\fR. A rich set of editing operations is supported, including cut\-/copy\-/paste\-operations. .SS "\s-1WINDOW LIST\s0" .IX Subsection "WINDOW LIST" The window list window shows a list of all workspaces. For each workspace it shows the window titles of the windows which are mapped on it. The bottom entry reads \f(CW\*(C`All Workspaces\*(C'\fR. It holds the sticky windows. These windows are mapped in all workspaces. .PP The window list window is normally hidden. Choose one of the following four methods to make it visible: .IP "\(bu" 4 Select the bottom window list menu entry. .IP "\(bu" 4 Press the \f(CW\*(C`KeySysWindowList=Ctrl+Alt+Esc\*(C'\fR key. .IP "\(bu" 4 Press the right Windows key if \f(CW\*(C`Win95Keys=1\*(C'\fR .IP "\(bu" 4 Press the \f(CW\*(C`DesktopWinListButton=2\*(C'\fR mouse button in the root window. .IP "\(bu" 4 Press the middle mouse button in a workspace button on the task bar. .PP A single-click on a window entry selects it. A group of windows can be selected by \f(CW\*(C`Shift+Pointer_Button1\*(C'\fR or by dragging with the left mouse button. Use \f(CW\*(C`Ctrl+Pointer_Button1\*(C'\fR to individually select windows in a multi-selection. A right mouse click over a selection will popup the system menu for this selection. To close the selected windows, press \f(CW\*(C`Delete\*(C'\fR. Press \f(CW\*(C`Shift+Delete\*(C'\fR to forcefully kill them. Right mouse click below the sticky windows for a menu with window arranging actions. .PP Double-click on a workspace to switch to it. Double-click on a window to activate it. Or navigate by arrow keys and press Enter. The space bar toggles a selection of a window. \f(CW\*(C`Ctrl+a\*(C'\fR and \f(CW\*(C`Ctrl+/\*(C'\fR will select the entire list of windows. \f(CW\*(C`Ctrl+\e\e\*(C'\fR deselects everything. Press the first letter of a window title to navigate to it and select it. If titles of multiple windows start with the same letter then repeatedly pressing the first letter cycles over those windows. \&\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 \&\f(CW\*(C`PageDown\*(C'\fR move up or down by ten entries. Combine this with the \&\f(CW\*(C`Shift\*(C'\fR key to extend a selection over the range of motion. .SS "\s-1MAILBOX MONITORING\s0" .IX Subsection "MAILBOX MONITORING" The task bar can show one or more icons to reflect the status of a mailbox. The mailbox can be a local file or a remote \s-1POP\s0 or \s-1IMAP\s0 account. For this a couple of options must be set. First, \&\fITaskBarShowMailboxStatus\fR must be enabled, which it is by default. Then the location of the mailbox must be set. Icewm first looks for \&\fIMailBoxPath\fR in preferences. If this is unset, it looks at the environment variables \f(CW\*(C`MAILPATH\*(C'\fR and \f(CW\*(C`MAIL\*(C'\fR. \fIMailBoxPath\fR may contain a space-separated list of mailboxes, while \f(CW\*(C`MAILPATH\*(C'\fR may contain a colon-separated list of mailboxes. If a mailbox starts with a slash \f(CW\*(C`/\*(C'\fR, then it is a local file, otherwise a \s-1URL.\s0 These are six examples of possible mailboxes: .PP .Vb 6 \& file:///var/spool/mail/captnmark \& file:///home/captnmark/Maildir/ \& pop3://markus:%2f%40%3a@maol.ch/ \& pop3s://markus:password@pop.gmail.com/ \& imap://mathias@localhost/INBOX.Maillisten.icewm\-user \& imaps://mathias:password@imap.gmail.com/INBOX .Ve .PP The \s-1POP3S\s0 and \s-1IMAPS\s0 schemes use \f(CW\*(C`openssl\*(C'\fR for \s-1TLS/SSL\s0 encryption. Note that for IceWM to access Gmail you must first configure your Gmail account to enable \s-1POP3\s0 or \s-1IMAP\s0 access. Make sure you have secure file permissions on your IceWM preferences file and the directory which contains it. .PP Reserved characters in the password, like \fIslash\fR, \fIat\fR and \fIcolon\fR can be specified using escape sequences with a hexadecimal encoding like \f(CW%2f\fR for the slash or \f(CW%40\fR for the at sign. For example, to hex-encode \f(CW\*(C`!p@a%s&s~\*(C'\fR use this Perl snippet: .PP .Vb 2 \& perl \-e \*(Aqforeach(split("", $ARGV[0])) { printf "%%%02x", ord($_); }; \& print "\en";\*(Aq \*(Aq!p@a%s&s~\*(Aq .Ve .PP Which will print: .PP .Vb 1 \& %21%40%23%24%25%5e%26%2a%7e .Ve .PP This is the hex-encoded password. However, it is unwise to store a password in your preferences. Consider a wallet extension for IceWM. .PP IceWM will check a mailbox periodically. The period in seconds can be set by the \fIMailCheckDelay\fR option, which is 30 seconds by default. .PP Whenever new mail arrives, the mailbox icon will be highlighted. The color will indicate if the mail has been read or not. Hovering the mouse over the mailbox icon will show a tooltip with more details. A command can be also be run on new mail. Set the \fINewMailCommand\fR option. Its environment will have these variables set by IceWM: .IP "\s-1ICEWM_MAILBOX\s0" 4 .IX Item "ICEWM_MAILBOX" The mailbox index number of \fIMailBoxPath\fR starting from 1. .IP "\s-1ICEWM_COUNT\s0" 4 .IX Item "ICEWM_COUNT" The total number of messages in this mailbox. .IP "\s-1ICEWM_UNREAD\s0" 4 .IX Item "ICEWM_UNREAD" The number of unread messages in this mailbox. .SS "\s-1KEYBOARD LAYOUT SWITCHING\s0" .IX Subsection "KEYBOARD LAYOUT SWITCHING" To control keyboard layouts on the task bar, define in \fIpreferences\fR the option \fBKeyboardLayouts\fR to a comma-separated list of your preferred keyboard layouts. For example: .PP .Vb 1 \& KeyboardLayouts="de","fr","jp" .Ve .PP A keyboard layout can simply be a name. Usually this is a two-letter country code. See the directory \fI/usr/share/X11/xkb/symbols\fR for a list of available keyboard layouts for your system. If it is enclosed in double quotes, it can also be a space-separated list of command-line arguments to an invocation of the \f(CW\*(C`setxkbmap\*(C'\fR program. .PP The first layout is the default. It will be installed when icewm starts. The task bar will show the current keyboard layout. If an icon can be found for the first two letters of the layout, then that icon will be shown. Otherwise the first two letters of the name of the layout will be shown. .PP Click on the current keyboard layout to cycle through all the available keyboard layouts. Click with the right mouse button to open a menu of all available keyboard layouts. .PP It is also possible to configure a default keyboard layout for each program individually in the \fBicewm\-winoptions\fR\|(5) file. Whenever such a program receives input focus, icewm will install this configured keyboard layout automatically. The keyboard status on the task bar will be updated to reflect this. .PP Please note that for keyboard layout switching to work, the \&\f(CW\*(C`setxkbmap\*(C'\fR program must be installed. To see your current keyboard layout settings, do \f(CW\*(C`setxkbmap \-query\*(C'\fR. .SS "\s-1KEYBOARD SHORTCUTS\s0" .IX Subsection "KEYBOARD SHORTCUTS" \&\fBicewm\fR supports a large number of hotkeys to activate some behaviour with a single key combination. These are all configurable in the \&\fIpreferences\fR file. Here we give their preferences name, followed by their default value in double quotes, and a short descriptions of their effect: .ie n .IP "\fBKeyWinRaise\fR=""Alt+F1""" 4 .el .IP "\fBKeyWinRaise\fR=\f(CWAlt+F1\fR" 4 .IX Item "KeyWinRaise=Alt+F1" Raises the window which currently has input focus. .ie n .IP "\fBKeyWinOccupyAll\fR=""Alt+F2""" 4 .el .IP "\fBKeyWinOccupyAll\fR=\f(CWAlt+F2\fR" 4 .IX Item "KeyWinOccupyAll=Alt+F2" Makes the active window occupy all work spaces. .ie n .IP "\fBKeyWinLower\fR=""Alt+F3""" 4 .el .IP "\fBKeyWinLower\fR=\f(CWAlt+F3\fR" 4 .IX Item "KeyWinLower=Alt+F3" Lowers the window which currently has input focus. .ie n .IP "\fBKeyWinClose\fR=""Alt+F4""" 4 .el .IP "\fBKeyWinClose\fR=\f(CWAlt+F4\fR" 4 .IX Item "KeyWinClose=Alt+F4" Closes the active window. .ie n .IP "\fBKeyWinRestore\fR=""Alt+F5""" 4 .el .IP "\fBKeyWinRestore\fR=\f(CWAlt+F5\fR" 4 .IX Item "KeyWinRestore=Alt+F5" Restores the active window to its visible state. .ie n .IP "\fBKeyWinNext\fR=""Alt+F6""" 4 .el .IP "\fBKeyWinNext\fR=\f(CWAlt+F6\fR" 4 .IX Item "KeyWinNext=Alt+F6" Switches focus to the next window. .ie n .IP "\fBKeyWinPrev\fR=""Alt+Shift+F6""" 4 .el .IP "\fBKeyWinPrev\fR=\f(CWAlt+Shift+F6\fR" 4 .IX Item "KeyWinPrev=Alt+Shift+F6" Switches focus to the previous window. .ie n .IP "\fBKeyWinMove\fR=""Alt+F7""" 4 .el .IP "\fBKeyWinMove\fR=\f(CWAlt+F7\fR" 4 .IX Item "KeyWinMove=Alt+F7" Starts movement of the active window. .ie n .IP "\fBKeyWinSize\fR=""Alt+F8""" 4 .el .IP "\fBKeyWinSize\fR=\f(CWAlt+F8\fR" 4 .IX Item "KeyWinSize=Alt+F8" Starts resizing of the active window. .ie n .IP "\fBKeyWinMinimize\fR=""Alt+F9""" 4 .el .IP "\fBKeyWinMinimize\fR=\f(CWAlt+F9\fR" 4 .IX Item "KeyWinMinimize=Alt+F9" Iconifies the active window. .ie n .IP "\fBKeyWinMaximize\fR=""Alt+F10""" 4 .el .IP "\fBKeyWinMaximize\fR=\f(CWAlt+F10\fR" 4 .IX Item "KeyWinMaximize=Alt+F10" Maximizes the active window with borders. .ie n .IP "\fBKeyWinMaximizeVert\fR=""Alt+Shift+F10""" 4 .el .IP "\fBKeyWinMaximizeVert\fR=\f(CWAlt+Shift+F10\fR" 4 .IX Item "KeyWinMaximizeVert=Alt+Shift+F10" Maximizes the active window vertically. .ie n .IP "\fBKeyWinMaximizeHoriz\fR=""undefined""" 4 .el .IP "\fBKeyWinMaximizeHoriz\fR=\f(CWundefined\fR" 4 .IX Item "KeyWinMaximizeHoriz=undefined" Maximizes the active window horizontally. .ie n .IP "\fBKeyWinFullscreen\fR=""Alt+F11""" 4 .el .IP "\fBKeyWinFullscreen\fR=\f(CWAlt+F11\fR" 4 .IX Item "KeyWinFullscreen=Alt+F11" Maximizes the active window without borders. .ie n .IP "\fBKeyWinRollup\fR=""Alt+F12""" 4 .el .IP "\fBKeyWinRollup\fR=\f(CWAlt+F12\fR" 4 .IX Item "KeyWinRollup=Alt+F12" Rolls up the active window. .ie n .IP "\fBKeyWinHide\fR=""Alt+Shift+F12""" 4 .el .IP "\fBKeyWinHide\fR=\f(CWAlt+Shift+F12\fR" 4 .IX Item "KeyWinHide=Alt+Shift+F12" Hides the active window. .ie n .IP "\fBKeyWinMenu\fR=""Alt+Space""" 4 .el .IP "\fBKeyWinMenu\fR=\f(CWAlt+Space\fR" 4 .IX Item "KeyWinMenu=Alt+Space" Posts the window menu. .ie n .IP "\fBKeyWinArrangeNW\fR=""Ctrl+Alt+KP_7""" 4 .el .IP "\fBKeyWinArrangeNW\fR=\f(CWCtrl+Alt+KP_7\fR" 4 .IX Item "KeyWinArrangeNW=Ctrl+Alt+KP_7" Moves the active window to the top left corner of the screen. .ie n .IP "\fBKeyWinArrangeN\fR=""Ctrl+Alt+KP_8""" 4 .el .IP "\fBKeyWinArrangeN\fR=\f(CWCtrl+Alt+KP_8\fR" 4 .IX Item "KeyWinArrangeN=Ctrl+Alt+KP_8" Moves the active window to the top middle of the screen. .ie n .IP "\fBKeyWinArrangeNE\fR=""Ctrl+Alt+KP_9""" 4 .el .IP "\fBKeyWinArrangeNE\fR=\f(CWCtrl+Alt+KP_9\fR" 4 .IX Item "KeyWinArrangeNE=Ctrl+Alt+KP_9" Moves the active window to the top right of the screen. .ie n .IP "\fBKeyWinArrangeE\fR=""Ctrl+Alt+KP_6""" 4 .el .IP "\fBKeyWinArrangeE\fR=\f(CWCtrl+Alt+KP_6\fR" 4 .IX Item "KeyWinArrangeE=Ctrl+Alt+KP_6" Moves the active window to the middle right of the screen. .ie n .IP "\fBKeyWinArrangeSE\fR=""Ctrl+Alt+KP_3""" 4 .el .IP "\fBKeyWinArrangeSE\fR=\f(CWCtrl+Alt+KP_3\fR" 4 .IX Item "KeyWinArrangeSE=Ctrl+Alt+KP_3" Moves the active window to the bottom right of the screen. .ie n .IP "\fBKeyWinArrangeS\fR=""Ctrl+Alt+KP_2""" 4 .el .IP "\fBKeyWinArrangeS\fR=\f(CWCtrl+Alt+KP_2\fR" 4 .IX Item "KeyWinArrangeS=Ctrl+Alt+KP_2" Moves the active window to the bottom middle of the screen. .ie n .IP "\fBKeyWinArrangeSW\fR=""Ctrl+Alt+KP_1""" 4 .el .IP "\fBKeyWinArrangeSW\fR=\f(CWCtrl+Alt+KP_1\fR" 4 .IX Item "KeyWinArrangeSW=Ctrl+Alt+KP_1" Moves the active window to the bottom left of the screen. .ie n .IP "\fBKeyWinArrangeW\fR=""Ctrl+Alt+KP_4""" 4 .el .IP "\fBKeyWinArrangeW\fR=\f(CWCtrl+Alt+KP_4\fR" 4 .IX Item "KeyWinArrangeW=Ctrl+Alt+KP_4" Moves the active window to the middle left of the screen. .ie n .IP "\fBKeyWinArrangeC\fR=""Ctrl+Alt+KP_5""" 4 .el .IP "\fBKeyWinArrangeC\fR=\f(CWCtrl+Alt+KP_5\fR" 4 .IX Item "KeyWinArrangeC=Ctrl+Alt+KP_5" Moves the active window to the center of the screen. .ie n .IP "\fBKeyWinSmartPlace\fR=""Ctrl+Alt+Shift+KP_5""" 4 .el .IP "\fBKeyWinSmartPlace\fR=\f(CWCtrl+Alt+Shift+KP_5\fR" 4 .IX Item "KeyWinSmartPlace=Ctrl+Alt+Shift+KP_5" Smart place the active window. .ie n .IP "\fBKeySysWinMenu\fR=""Shift+Esc""" 4 .el .IP "\fBKeySysWinMenu\fR=\f(CWShift+Esc\fR" 4 .IX Item "KeySysWinMenu=Shift+Esc" Posts the system window menu. .ie n .IP "\fBKeySysWinNext\fR=""Alt+Esc""" 4 .el .IP "\fBKeySysWinNext\fR=\f(CWAlt+Esc\fR" 4 .IX Item "KeySysWinNext=Alt+Esc" Give focus to the next window and raise it. .ie n .IP "\fBKeySysWinPrev\fR=""Alt+Shift+Esc""" 4 .el .IP "\fBKeySysWinPrev\fR=\f(CWAlt+Shift+Esc\fR" 4 .IX Item "KeySysWinPrev=Alt+Shift+Esc" Give focus to the previous window and raise it. .ie n .IP "\fBKeySysDialog\fR=""Alt+Ctrl+Del""" 4 .el .IP "\fBKeySysDialog\fR=\f(CWAlt+Ctrl+Del\fR" 4 .IX Item "KeySysDialog=Alt+Ctrl+Del" Opens the IceWM system dialog in the center of the screen. .ie n .IP "\fBKeySysMenu\fR=""Ctrl+Esc""" 4 .el .IP "\fBKeySysMenu\fR=\f(CWCtrl+Esc\fR" 4 .IX Item "KeySysMenu=Ctrl+Esc" Activates the IceWM root menu in the lower left corner. .ie n .IP "\fBKeySysWindowList\fR=""Alt+Ctrl+Esc""" 4 .el .IP "\fBKeySysWindowList\fR=\f(CWAlt+Ctrl+Esc\fR" 4 .IX Item "KeySysWindowList=Alt+Ctrl+Esc" Opens the IceWM system window list in the center of the screen. .ie n .IP "\fBKeySysAddressBar\fR=""Alt+Ctrl+Space""" 4 .el .IP "\fBKeySysAddressBar\fR=\f(CWAlt+Ctrl+Space\fR" 4 .IX Item "KeySysAddressBar=Alt+Ctrl+Space" Opens the address bar in the task bar where a command can be typed. .ie n .IP "\fBKeySysWorkspacePrev\fR=""Alt+Ctrl+Left""" 4 .el .IP "\fBKeySysWorkspacePrev\fR=\f(CWAlt+Ctrl+Left\fR" 4 .IX Item "KeySysWorkspacePrev=Alt+Ctrl+Left" Goes one workspace to the left. .ie n .IP "\fBKeySysWorkspaceNext\fR=""Alt+Ctrl+Right""" 4 .el .IP "\fBKeySysWorkspaceNext\fR=\f(CWAlt+Ctrl+Right\fR" 4 .IX Item "KeySysWorkspaceNext=Alt+Ctrl+Right" Goes one workspace to the right. .ie n .IP "\fBKeySysWorkspaceLast\fR=""Alt+Ctrl+Down""" 4 .el .IP "\fBKeySysWorkspaceLast\fR=\f(CWAlt+Ctrl+Down\fR" 4 .IX Item "KeySysWorkspaceLast=Alt+Ctrl+Down" Goes to the previous workspace. .ie n .IP "\fBKeySysWorkspacePrevTakeWin\fR=""Alt+Ctrl+Shift+Left""" 4 .el .IP "\fBKeySysWorkspacePrevTakeWin\fR=\f(CWAlt+Ctrl+Shift+Left\fR" 4 .IX Item "KeySysWorkspacePrevTakeWin=Alt+Ctrl+Shift+Left" Takes the active window one workspace to the left. .ie n .IP "\fBKeySysWorkspaceNextTakeWin\fR=""Alt+Ctrl+Shift+Right""" 4 .el .IP "\fBKeySysWorkspaceNextTakeWin\fR=\f(CWAlt+Ctrl+Shift+Right\fR" 4 .IX Item "KeySysWorkspaceNextTakeWin=Alt+Ctrl+Shift+Right" Takes the active window one workspace to the right. .ie n .IP "\fBKeySysWorkspaceLastTakeWin\fR=""Alt+Ctrl+Shift+Down""" 4 .el .IP "\fBKeySysWorkspaceLastTakeWin\fR=\f(CWAlt+Ctrl+Shift+Down\fR" 4 .IX Item "KeySysWorkspaceLastTakeWin=Alt+Ctrl+Shift+Down" Takes the active window to the previous workspace. .ie n .IP "\fBKeySysWorkspace1\fR=""Alt+Ctrl+1""" 4 .el .IP "\fBKeySysWorkspace1\fR=\f(CWAlt+Ctrl+1\fR" 4 .IX Item "KeySysWorkspace1=Alt+Ctrl+1" Goes to workspace 1. .ie n .IP "\fBKeySysWorkspace2\fR=""Alt+Ctrl+2""" 4 .el .IP "\fBKeySysWorkspace2\fR=\f(CWAlt+Ctrl+2\fR" 4 .IX Item "KeySysWorkspace2=Alt+Ctrl+2" Goes to workspace 2. .ie n .IP "\fBKeySysWorkspace3\fR=""Alt+Ctrl+3""" 4 .el .IP "\fBKeySysWorkspace3\fR=\f(CWAlt+Ctrl+3\fR" 4 .IX Item "KeySysWorkspace3=Alt+Ctrl+3" Goes to workspace 3. .ie n .IP "\fBKeySysWorkspace4\fR=""Alt+Ctrl+4""" 4 .el .IP "\fBKeySysWorkspace4\fR=\f(CWAlt+Ctrl+4\fR" 4 .IX Item "KeySysWorkspace4=Alt+Ctrl+4" Goes to workspace 4. .ie n .IP "\fBKeySysWorkspace5\fR=""Alt+Ctrl+5""" 4 .el .IP "\fBKeySysWorkspace5\fR=\f(CWAlt+Ctrl+5\fR" 4 .IX Item "KeySysWorkspace5=Alt+Ctrl+5" Goes to workspace 5. .ie n .IP "\fBKeySysWorkspace6\fR=""Alt+Ctrl+6""" 4 .el .IP "\fBKeySysWorkspace6\fR=\f(CWAlt+Ctrl+6\fR" 4 .IX Item "KeySysWorkspace6=Alt+Ctrl+6" Goes to workspace 6. .ie n .IP "\fBKeySysWorkspace7\fR=""Alt+Ctrl+7""" 4 .el .IP "\fBKeySysWorkspace7\fR=\f(CWAlt+Ctrl+7\fR" 4 .IX Item "KeySysWorkspace7=Alt+Ctrl+7" Goes to workspace 7. .ie n .IP "\fBKeySysWorkspace8\fR=""Alt+Ctrl+8""" 4 .el .IP "\fBKeySysWorkspace8\fR=\f(CWAlt+Ctrl+8\fR" 4 .IX Item "KeySysWorkspace8=Alt+Ctrl+8" Goes to workspace 8. .ie n .IP "\fBKeySysWorkspace9\fR=""Alt+Ctrl+9""" 4 .el .IP "\fBKeySysWorkspace9\fR=\f(CWAlt+Ctrl+9\fR" 4 .IX Item "KeySysWorkspace9=Alt+Ctrl+9" Goes to workspace 9. .ie n .IP "\fBKeySysWorkspace10\fR=""Alt+Ctrl+0""" 4 .el .IP "\fBKeySysWorkspace10\fR=\f(CWAlt+Ctrl+0\fR" 4 .IX Item "KeySysWorkspace10=Alt+Ctrl+0" Goes to workspace 10. .ie n .IP "\fBKeySysWorkspace11\fR=""Alt+Ctrl+bracketleft""" 4 .el .IP "\fBKeySysWorkspace11\fR=\f(CWAlt+Ctrl+bracketleft\fR" 4 .IX Item "KeySysWorkspace11=Alt+Ctrl+bracketleft" Goes to workspace 11. .ie n .IP "\fBKeySysWorkspace12\fR=""Alt+Ctrl+bracketright""" 4 .el .IP "\fBKeySysWorkspace12\fR=\f(CWAlt+Ctrl+bracketright\fR" 4 .IX Item "KeySysWorkspace12=Alt+Ctrl+bracketright" Goes to workspace 12. .ie n .IP "\fBKeySysWorkspace1TakeWin\fR=""Alt+Ctrl+Shift+1""" 4 .el .IP "\fBKeySysWorkspace1TakeWin\fR=\f(CWAlt+Ctrl+Shift+1\fR" 4 .IX Item "KeySysWorkspace1TakeWin=Alt+Ctrl+Shift+1" Takes the active window to workspace 1. .ie n .IP "\fBKeySysWorkspace2TakeWin\fR=""Alt+Ctrl+Shift+2""" 4 .el .IP "\fBKeySysWorkspace2TakeWin\fR=\f(CWAlt+Ctrl+Shift+2\fR" 4 .IX Item "KeySysWorkspace2TakeWin=Alt+Ctrl+Shift+2" Takes the active window to workspace 2. .ie n .IP "\fBKeySysWorkspace3TakeWin\fR=""Alt+Ctrl+Shift+3""" 4 .el .IP "\fBKeySysWorkspace3TakeWin\fR=\f(CWAlt+Ctrl+Shift+3\fR" 4 .IX Item "KeySysWorkspace3TakeWin=Alt+Ctrl+Shift+3" Takes the active window to workspace 3. .ie n .IP "\fBKeySysWorkspace4TakeWin\fR=""Alt+Ctrl+Shift+4""" 4 .el .IP "\fBKeySysWorkspace4TakeWin\fR=\f(CWAlt+Ctrl+Shift+4\fR" 4 .IX Item "KeySysWorkspace4TakeWin=Alt+Ctrl+Shift+4" Takes the active window to workspace 4. .ie n .IP "\fBKeySysWorkspace5TakeWin\fR=""Alt+Ctrl+Shift+5""" 4 .el .IP "\fBKeySysWorkspace5TakeWin\fR=\f(CWAlt+Ctrl+Shift+5\fR" 4 .IX Item "KeySysWorkspace5TakeWin=Alt+Ctrl+Shift+5" Takes the active window to workspace 5. .ie n .IP "\fBKeySysWorkspace6TakeWin\fR=""Alt+Ctrl+Shift+6""" 4 .el .IP "\fBKeySysWorkspace6TakeWin\fR=\f(CWAlt+Ctrl+Shift+6\fR" 4 .IX Item "KeySysWorkspace6TakeWin=Alt+Ctrl+Shift+6" Takes the active window to workspace 6. .ie n .IP "\fBKeySysWorkspace7TakeWin\fR=""Alt+Ctrl+Shift+7""" 4 .el .IP "\fBKeySysWorkspace7TakeWin\fR=\f(CWAlt+Ctrl+Shift+7\fR" 4 .IX Item "KeySysWorkspace7TakeWin=Alt+Ctrl+Shift+7" Takes the active window to workspace 7. .ie n .IP "\fBKeySysWorkspace8TakeWin\fR=""Alt+Ctrl+Shift+8""" 4 .el .IP "\fBKeySysWorkspace8TakeWin\fR=\f(CWAlt+Ctrl+Shift+8\fR" 4 .IX Item "KeySysWorkspace8TakeWin=Alt+Ctrl+Shift+8" Takes the active window to workspace 8. .ie n .IP "\fBKeySysWorkspace9TakeWin\fR=""Alt+Ctrl+Shift+9""" 4 .el .IP "\fBKeySysWorkspace9TakeWin\fR=\f(CWAlt+Ctrl+Shift+9\fR" 4 .IX Item "KeySysWorkspace9TakeWin=Alt+Ctrl+Shift+9" Takes the active window to workspace 9. .ie n .IP "\fBKeySysWorkspace10TakeWin\fR=""Alt+Ctrl+Shift+0""" 4 .el .IP "\fBKeySysWorkspace10TakeWin\fR=\f(CWAlt+Ctrl+Shift+0\fR" 4 .IX Item "KeySysWorkspace10TakeWin=Alt+Ctrl+Shift+0" Takes the active window to workspace 10. .ie n .IP "\fBKeySysWorkspace11TakeWin\fR=""Alt+Ctrl+Shift+bracketleft""" 4 .el .IP "\fBKeySysWorkspace11TakeWin\fR=\f(CWAlt+Ctrl+Shift+bracketleft\fR" 4 .IX Item "KeySysWorkspace11TakeWin=Alt+Ctrl+Shift+bracketleft" Takes the active window to workspace 11. .ie n .IP "\fBKeySysWorkspace12TakeWin\fR=""Alt+Ctrl+Shift+bracketright""" 4 .el .IP "\fBKeySysWorkspace12TakeWin\fR=\f(CWAlt+Ctrl+Shift+bracketright\fR" 4 .IX Item "KeySysWorkspace12TakeWin=Alt+Ctrl+Shift+bracketright" Takes the active window to workspace 12. .ie n .IP "\fBKeySysTileVertical\fR=""Alt+Shift+F2""" 4 .el .IP "\fBKeySysTileVertical\fR=\f(CWAlt+Shift+F2\fR" 4 .IX Item "KeySysTileVertical=Alt+Shift+F2" Tiles all windows from left to right maximized vertically. .ie n .IP "\fBKeySysTileHorizontal\fR=""Alt+Shift+F3""" 4 .el .IP "\fBKeySysTileHorizontal\fR=\f(CWAlt+Shift+F3\fR" 4 .IX Item "KeySysTileHorizontal=Alt+Shift+F3" Tiles all windows from top to bottom maximized horizontally. .ie n .IP "\fBKeySysCascade\fR=""Alt+Shift+F4""" 4 .el .IP "\fBKeySysCascade\fR=\f(CWAlt+Shift+F4\fR" 4 .IX Item "KeySysCascade=Alt+Shift+F4" Makes a horizontal cascade of all windows which are maximized vertically. .ie n .IP "\fBKeySysArrange\fR=""Alt+Shift+F5""" 4 .el .IP "\fBKeySysArrange\fR=\f(CWAlt+Shift+F5\fR" 4 .IX Item "KeySysArrange=Alt+Shift+F5" Rearranges the windows. .ie n .IP "\fBKeySysUndoArrange\fR=""Alt+Shift+F7""" 4 .el .IP "\fBKeySysUndoArrange\fR=\f(CWAlt+Shift+F7\fR" 4 .IX Item "KeySysUndoArrange=Alt+Shift+F7" Undoes arrangement. .ie n .IP "\fBKeySysArrangeIcons\fR=""Alt+Shift+F8""" 4 .el .IP "\fBKeySysArrangeIcons\fR=\f(CWAlt+Shift+F8\fR" 4 .IX Item "KeySysArrangeIcons=Alt+Shift+F8" Rearranges icons. .ie n .IP "\fBKeySysMinimizeAll\fR=""Alt+Shift+F9""" 4 .el .IP "\fBKeySysMinimizeAll\fR=\f(CWAlt+Shift+F9\fR" 4 .IX Item "KeySysMinimizeAll=Alt+Shift+F9" Minimizes all windows. .ie n .IP "\fBKeySysHideAll\fR=""Alt+Shift+F11""" 4 .el .IP "\fBKeySysHideAll\fR=\f(CWAlt+Shift+F11\fR" 4 .IX Item "KeySysHideAll=Alt+Shift+F11" Hides all windows. .ie n .IP "\fBKeySysShowDesktop\fR=""Alt+Ctrl+d""" 4 .el .IP "\fBKeySysShowDesktop\fR=\f(CWAlt+Ctrl+d\fR" 4 .IX Item "KeySysShowDesktop=Alt+Ctrl+d" Unmaps all windows to show the desktop. .ie n .IP "\fBKeySysCollapseTaskBar\fR=""Alt+Ctrl+h""" 4 .el .IP "\fBKeySysCollapseTaskBar\fR=\f(CWAlt+Ctrl+h\fR" 4 .IX Item "KeySysCollapseTaskBar=Alt+Ctrl+h" Hides the task bar. .ie n .IP "\fBKeyTaskBarSwitchNext\fR=""undefined""" 4 .el .IP "\fBKeyTaskBarSwitchNext\fR=\f(CWundefined\fR" 4 .IX Item "KeyTaskBarSwitchNext=undefined" Switches to the next window in the task bar. .ie n .IP "\fBKeyTaskBarSwitchPrev\fR=""undefined""" 4 .el .IP "\fBKeyTaskBarSwitchPrev\fR=\f(CWundefined\fR" 4 .IX Item "KeyTaskBarSwitchPrev=undefined" Switches to the previous window in the task bar. .ie n .IP "\fBKeyTaskBarMoveNext\fR=""undefined""" 4 .el .IP "\fBKeyTaskBarMoveNext\fR=\f(CWundefined\fR" 4 .IX Item "KeyTaskBarMoveNext=undefined" Moves the task bar button of the current window right. .ie n .IP "\fBKeyTaskBarMovePrev\fR=""undefined""" 4 .el .IP "\fBKeyTaskBarMovePrev\fR=\f(CWundefined\fR" 4 .IX Item "KeyTaskBarMovePrev=undefined" Moves the task bar button of the current window left. .ie n .IP "\fBKeySysWinListMenu\fR=""undefined""" 4 .el .IP "\fBKeySysWinListMenu\fR=\f(CWundefined\fR" 4 .IX Item "KeySysWinListMenu=undefined" Shows the window list menu. .ie n .IP "\fBKeySysSwitchNext\fR=""Alt+Tab""" 4 .el .IP "\fBKeySysSwitchNext\fR=\f(CWAlt+Tab\fR" 4 .IX Item "KeySysSwitchNext=Alt+Tab" Opens the \f(CW\*(C`QuickSwitch\*(C'\fR popup (see \*(L"\s-1INPUT FOCUS\*(R"\s0) and/or moves the selector in the \f(CW\*(C`QuickSwitch\*(C'\fR popup. .ie n .IP "\fBKeySysSwitchLast\fR=""Alt+Shift+Tab""" 4 .el .IP "\fBKeySysSwitchLast\fR=\f(CWAlt+Shift+Tab\fR" 4 .IX Item "KeySysSwitchLast=Alt+Shift+Tab" Works like \f(CW\*(C`KeySysSwitchNext\*(C'\fR but moving in the opposite direction. .ie n .IP "\fBKeySysSwitchClass\fR=""Alt+grave""" 4 .el .IP "\fBKeySysSwitchClass\fR=\f(CWAlt+grave\fR" 4 .IX Item "KeySysSwitchClass=Alt+grave" Is like \f(CW\*(C`KeySysSwitchNext\*(C'\fR but only for windows with the same \s-1WM_CLASS\s0 property as the currently focused window. .SS "\s-1MOUSE BINDINGS\s0" .IX Subsection "MOUSE BINDINGS" You can control windows by a modified mouse button press: .ie n .IP "\fBMouseWinMove\fR=""Alt+Pointer_Button1""" 4 .el .IP "\fBMouseWinMove\fR=\f(CWAlt+Pointer_Button1\fR" 4 .IX Item "MouseWinMove=Alt+Pointer_Button1" Moves the window under the mouse over the screen. .ie n .IP "\fBMouseWinSize\fR=""Alt+Pointer_Button3""" 4 .el .IP "\fBMouseWinSize\fR=\f(CWAlt+Pointer_Button3\fR" 4 .IX Item "MouseWinSize=Alt+Pointer_Button3" Resizes the window. Keep the key and button pressed. To enlarge the window move the mouse button away from the center. To shrink it move towards the centre. .ie n .IP "\fBMouseWinRaise\fR=""Ctrl+Alt+Pointer_Button1""" 4 .el .IP "\fBMouseWinRaise\fR=\f(CWCtrl+Alt+Pointer_Button1\fR" 4 .IX Item "MouseWinRaise=Ctrl+Alt+Pointer_Button1" Raises the window under the mouse. .ie n .IP "\fBMouseWinLower\fR=""Ctrl+Alt+Pointer_Button1""" 4 .el .IP "\fBMouseWinLower\fR=\f(CWCtrl+Alt+Pointer_Button1\fR" 4 .IX Item "MouseWinLower=Ctrl+Alt+Pointer_Button1" Lowers the window under the mouse. If this is equal to \f(CW\*(C`MouseWinRaise\*(C'\fR and the window can be raised then \f(CW\*(C`MouseWinRaise\*(C'\fR takes preference over \f(CW\*(C`MouseWinLower\*(C'\fR. .PP The title frame of a window also listens for mouse clicks. Left double clicking maximizes the window (\f(CW\*(C`TitleBarMaximizeButton=1\*(C'\fR). Middle double clicking rolls up the window (\f(CW\*(C`TitleBarRollupButton=2\*(C'\fR). Pressing a mouse button and moving it will move the window. \&\f(CW\*(C`Alt+Pointer_Button1\*(C'\fR lowers the window. .PP When the mouse is on the window frame then a left click raises the window. Dragging with the left button down resizes the window. Clicking the right button pops up the context menu. Dragging with the right button moves the window. .PP Clicking on the desktop activates a menu. The middle button shows the window list (\f(CW\*(C`DesktopWinListButton=2\*(C'\fR). The right button shows the root menu (\f(CW\*(C`DesktopMenuButton=3\*(C'\fR). If you press \f(CW\*(C`Ctrl+Alt\*(C'\fR then the mouse wheel will focus all applications in turn. .SH "SIGNALS" .IX Header "SIGNALS" \&\fBicewm\fR supports the following signals: .IP "\fB\s-1SIGHUP\s0\fR" 4 .IX Item "SIGHUP" \&\fBicewm\fR will restart itself. It is a way to reload the configuration. .IP "\fB\s-1SIGINT\s0\fR, \fB\s-1SIGTERM\s0\fR" 4 .IX Item "SIGINT, SIGTERM" \&\fBicewm\fR will cease to manage application windows and terminate. .IP "\fB\s-1SIGQUIT\s0\fR" 4 .IX Item "SIGQUIT" \&\fBicewm\fR will initiate the logout procedure. If a \f(CW\*(C`LogoutCommand\*(C'\fR preferences option was configured it will be executed. .IP "\fB\s-1SIGUSR2\s0\fR" 4 .IX Item "SIGUSR2" Toggle the logging of X11 events, if \f(CW\*(C`logevents\*(C'\fR was configured. .SH "ENVIRONMENT VARIABLES" .IX Header "ENVIRONMENT VARIABLES" .IP "\fB\s-1ICEWM_PRIVCFG\s0\fR" 4 .IX Item "ICEWM_PRIVCFG" The directory for user private configuration files. When this environment variable is not specified, the default directory is \&\fI\f(CI$XDG_CONFIG_HOME\fI/icewm\fR when that directory exists, otherwise the default value is \fI\f(CI$HOME\fI/.icewm\fR. .IP "\fB\s-1DISPLAY\s0\fR" 4 .IX Item "DISPLAY" The name of the X11 server. See \fBXorg\fR\|(1) or \fBXserver\fR\|(1). This value can be overridden by the \fB\-\-display\fR option. .IP "\fB\s-1MAILPATH\s0\fR, \fB\s-1MAIL\s0\fR" 4 .IX Item "MAILPATH, MAIL" Gives the location of your mailbox. If the schema is omitted the local \&\*(L"file\*(R" schema is assumed. This is used by the mailbox applet in the task bar to show the status of your mailbox. If the \f(CW\*(C`MailBoxPath\*(C'\fR option in the \fIpreferences\fR file is set, then that one takes precedence. .SH "FILES" .IX Header "FILES" \&\fBicewm\fR looks for configuration files in the following directories, in the given order, until it finds one: .IP "\fI\f(CI$ICEWM_PRIVCFG\fI/\fR" 4 .IX Item "$ICEWM_PRIVCFG/" Contains user-specific configurations. When \fB\s-1ICEWM_PRIVCFG\s0\fR is specified, this directory takes precedence over \&\fI\f(CI$XDG_CONFIG_HOME\fI/icewm\fR and \fI\f(CI$HOME\fI/.icewm\fR. .IP "\fI\f(CI$XDG_CONFIG_HOME\fI/icewm/\fR" 4 .IX Item "$XDG_CONFIG_HOME/icewm/" Contains user-specific configurations. When this directory exists it take precedence over \fI\f(CI$HOME\fI/.icewm\fR. .IP "\fI\f(CI$HOME\fI/.icewm/\fR" 4 .IX Item "$HOME/.icewm/" Contains user-specific configurations. This is the historical default directory. .IP "\fI/etc/icewm/\fR" 4 .IX Item "/etc/icewm/" Contains system-wide customized defaults. Please note that your local installation may have been configured to use a different system location. The output of \f(CW\*(C`icewm \-\-directories\*(C'\fR will show this location. .IP "\fI/usr/share/icewm/\fR" 4 .IX Item "/usr/share/icewm/" Default local installation settings. .SS "\s-1CONFIGURATION FILES\s0" .IX Subsection "CONFIGURATION FILES" .IP "\fIenv\fR" 4 .IX Item "env" \&\fBicewm\-session\fR\|(1) loads additional environment variables from the file \&\fIenv\fR. Each line is subjected to \s-1POSIX\s0 shell expansion by \&\fBwordexp\fR\|(3). Comment lines starting by a hash-sign (\f(CW\*(C`#\*(C'\fR) are ignored. \&\fBicewm\-session\fR\|(1) will load those expanded lines which contain a name, followed by an equals sign, followed by the value (which may be empty). .Sp See \fBicewm\-env\fR\|(5). .IP "\fIfocus_mode\fR" 4 .IX Item "focus_mode" Defines the initial value for \f(CW\*(C`FocusMode\*(C'\fR. Its default value is \&\f(CW\*(C`FocusMode=1\*(C'\fR (Click-to-focus). This can be changed via the menu. \&\fBicewm\fR will save the Focus menu choice in this file. .Sp See \fBicewm\-focus_mode\fR\|(5). .IP "\fIkeys\fR" 4 .IX Item "keys" Global keybindings to launch applications, which need not be window manager related. Each non-empty line starts with the word \f(CW\*(C`key\*(C'\fR. After one or more spaces follows a double-quoted string of the bound X11 key combination like \f(CW\*(C`Alt+Ctrl+Shift+X\*(C'\fR. Then after at least one space follows a shell command-line which will be executed by \fBicewm\fR whenever this key combination is pressed. For example, the following line creates a hotkey to reload the \fBicewm\fR configuration: .Sp .Vb 1 \& key "Ctrl+Shift+r" icesh restart .Ve .Sp See \fBicewm\-keys\fR\|(5). .IP "\fImenu\fR" 4 .IX Item "menu" A menu of applications; usually customized by the user. \fBicewm\fR provides the \fBicewm\-menu\-fdo\fR\|(1) program to generate a default menu. Similar programs are \fBxdg_menu\fR\|(1), \fBmmaker\fR\|(1) (MenuMaker), \&\fBxde\-menu\fR\|(1), \fBxdgmenumaker\fR\|(1). .Sp See \fBicewm\-menu\fR\|(5). .IP "\fIpreferences\fR" 4 .IX Item "preferences" Contains general settings like paths, colors and fonts, but also options to control the \fBicewm\fR focus behaviour and the applets which are started in the task bar. The \fBicewm\fR installation will provide a default \fIpreferences\fR file, which can be copied to the \fBicewm\fR user configuration directory and modified. .Sp See \fBicewm\-preferences\fR\|(5). .IP "\fIprefoverride\fR" 4 .IX Item "prefoverride" Settings which override the settings from a theme. Some of the \fBicewm\fR configuration options from the preferences file which control the look-and-feel may be overridden by the theme, if the theme designer thinks this is desirable. However, this \fIprefoverride\fR file will again override this for a few specific options of your choosing. It is safe to leave this file empty initially. .Sp See \fBicewm\-prefoverride\fR\|(5). .IP "\fIprograms\fR" 4 .IX Item "programs" An automatically generated menu of applications. This could be used by \&\fBwmconfig\fR\|(1), menu or similar programs to give easy access to all the desktop applications which are installed on the system. .Sp See \fBicewm\-programs\fR\|(5). .IP "\fItheme\fR" 4 .IX Item "theme" This file contains the name of the default theme. On startup \fBicewm\fR reads this file to obtain the theme name, unless \fBicewm\fR was started with the \fB\-\-theme\fR option. Whenever a different theme is selected from the \fBicewm\fR Menu then the theme file is overwritten with the name of the selected theme. This theme file contains the keyword \f(CW\*(C`Theme\*(C'\fR, followed by an equals sign, followed by a double-quoted string with the theme name. The theme name is the name of the theme directory, followed by a slash, followed by the theme file. Usually the theme file is just \&\fIdefault.theme\fR, but a theme may have alternatives. Alternatives are small tweaks of a theme. These are specified in their own \fI.theme\fR file, which replaces \fIdefault.theme\fR. If no theme file exists then \&\fBicewm\fR will use the default setting of \&\f(CW\*(C`Theme="default/default.theme"\*(C'\fR. .Sp See \fBicewm\-theme\fR\|(5). .IP "\fItoolbar\fR" 4 .IX Item "toolbar" Contains names of quick to launch applications with icons for the task bar. Each non-empty non-comment line starts with the keyword \fBprog\fR. After one or more spaces follows a name, which is displayed in a tool tip whenever the mouse cursor hovers over the toolbar icon. This name may be a double quoted string. Then follows the bare name of the icon to use without extensions. This icon will be shown in the toolbar. The last component is a shell command-line which will be executed whenever the user presses the icon in the toolbar. For example, the following line in toolbar will create a button with tool tip \f(CW\*(C`Mozilla Firefox\*(C'\fR with the \fIfirefox\fR icon which launches \fBfirefox\fR\|(1) when clicked: .Sp .Vb 1 \& prog "Mozilla Firefox" firefox /usr/bin/firefox \-\-private\-window .Ve .Sp See \fBicewm\-toolbar\fR\|(5). .IP "\fIwinoptions\fR" 4 .IX Item "winoptions" Contains settings to control window appearance and behaviour which are specific to applications or groups of applications. Options can control the border, whether it appears on the task bar, the window list, the system tray and the work spaces. Also its layer, geometry, whether it can be moved, resized and closed. .Sp See \fBicewm\-winoptions\fR\|(5). .IP "\fIstartup\fR" 4 .IX Item "startup" Contains commands to be executed on \fBicewm\fR startup. This is an executable script with commands to tweak X11 settings and launch some applications which need to be active whenever \fBicewm\fR is started. It is run by \fBicewm\-session\fR\|(1) when \fBicewm\fR starts. .Sp See \fBicewm\-startup\fR\|(5). .IP "\fIshutdown\fR" 4 .IX Item "shutdown" Contains commands to be executed on \fBicewm\fR shutdown. This is an executable script with commands to be executed in the last stage of \&\fBicewm\fR termination. Typically they may undo some of the effects of the \fIstartup\fR script. It is run by \fBicewm\-session\fR\|(1) when \fBicewm\fR terminates. .Sp See \fBicewm\-shutdown\fR\|(5). .SS "\s-1CONFIGURATION SUBDIRECTORIES\s0" .IX Subsection "CONFIGURATION SUBDIRECTORIES" .IP "\fIicons\fR" 4 .IX Item "icons" Contains icons which are used to identify applications. Usually these files are in the \s-1XPM\s0 format, but the \s-1PNG\s0 and \s-1SVG\s0 image formats are also supported. The names of icon files may follow a specific naming pattern, like \fIapp_32x32.xpm\fR. They start with a base name, usually this is just a single word. Then follows an underscore, followed by a size specification in the format \f(CW\*(C`SIZExSIZE\*(C'\fR. This is followed by a dot and the file extension, where the extension denotes the icon image format. Common sizes are 16, 32 and 48 for small, large and huge icons. This depends on the respective \f(CW\*(C`IconSize\*(C'\fR preferences options. .IP "\fIledclock\fR" 4 .IX Item "ledclock" Pictures of digits for the \s-1LED\s0 clock which is displayed in the bottom-right corner of the task bar. These can be seen when the \&\f(CW\*(C`TaskBarShowClock\*(C'\fR and \f(CW\*(C`TaskBarClockLeds\*(C'\fR options are both set to 1. .IP "\fImailbox\fR" 4 .IX Item "mailbox" Icons which are used to display different states of the mailbox applet in the task bar. There are five states and each has its own icon: \&\fImail.xpm\fR, \fInewmail.xpm\fR, \fIunreadmail.xpm\fR, \fInomail.xpm\fR, \&\fIerrmail.xpm\fR. .IP "\fIsounds\fR" 4 .IX Item "sounds" Audio files which are played by \fBicesound\fR\|(1) on \s-1GUI\s0 events. These are: \fIstartup.wav\fR, \fIshutdown.wav\fR, \fIrestart.wav\fR, \fIlaunchApp.wav\fR, \&\fIworkspaceChange.wav\fR, \fIwindowOpen.wav\fR, \fIwindowClose.wav\fR, \&\fIdialogOpen.wav\fR, \fIdialogClose.wav\fR, \fIwindowMax.wav\fR, \&\fIwindowRestore.wav\fR, \fIwindowMin.wav\fR, \fIwindowHide.wav\fR, \&\fIwindowRollup.wav\fR, \fIwindowMoved.wav\fR, \fIwindowSized.wav\fR, \&\fIwindowLower.wav\fR. .IP "\fItaskbar\fR" 4 .IX Item "taskbar" Pictures to customize the look of the task bar. These include: \&\fItaskbarbg.xpm\fR, \fItaskbuttonactive.xpm\fR, \fItaskbuttonbg.xpm\fR, \&\fItaskbuttonminimized.xpm\fR, \fItoolbuttonbg.xpm\fR, \&\fIworkspacebuttonactive.xpm\fR, \fIworkspacebuttonbg.xpm\fR. .IP "\fIthemes\fR" 4 .IX Item "themes" A directory to store themes. Each theme is stored in its own sub-directory in the \fIthemes\fR directory. A theme contains at least a \&\fIdefault.theme\fR file, and optionally theme alternatives which are additional files which have a \fI.theme\fR file name extension and which contain tweaks of the \fIdefault.theme\fR file. How to create a theme is explained in the IceWM Theme Creation Howto. .SS "\s-1OPACITY\s0" .IX Subsection "OPACITY" IceWM supports window opacity and transparency in connection with an external compositor like \fBcompton\fR\|(1) or \fBpicom\fR\|(1). If a client window sets the \f(CW\*(C`_NET_WM_WINDOW_OPACITY\*(C'\fR property on its window, then \fBicewm\fR will copy this to the outer frame window, where the compositor will read it and adjust the opacity accordingly. .PP The opacity can also be set in the \fBicewm\-winoptions\fR\|(5) file. \&\fBicesh\fR\|(1) can control the opacity level of running applications. .PP The _NET_WM_WINDOW_TYPE properties which \fBicewm\fR sets on its windows are \fI\s-1DIALOG\s0\fR, \fI\s-1NOTIFICATION\s0\fR, \fI\s-1POPUP_MENU\s0\fR and \fI\s-1TOOLTIP\s0\fR. The output of \f(CW\*(C`icesh windows\*(C'\fR shows their \s-1WM_CLASS\s0 values. These can be helpful to configure compton. .SH "EXAMPLES" .IX Header "EXAMPLES" Examples of the above configuration files can be found in the default installation path or in the system-wide defaults. See the output of \&\f(CW\*(C`icewm \-\-directories\*(C'\fR for their locations. .SH "CONFORMING TO" .IX Header "CONFORMING TO" \&\s-1ICCCM 2.0:\s0 partial. NetWM/EWMH: extensive. See the file \fI\s-1COMPLIANCE\s0\fR in the distribution for full details. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBicehelp\fR\|(1), \&\fBicesh\fR\|(1), \&\fBicesound\fR\|(1), \&\fBicewm\-env\fR\|(5), \&\fBicewm\-focus_mode\fR\|(5), \&\fBicewm\-keys\fR\|(5), \&\fBicewm\-menu\fR\|(5), \&\fBicewm\-menu\-fdo\fR\|(1), \&\fBicewm\-menu\-xrandr\fR\|(1), \&\fBicewm\-preferences\fR\|(5), \&\fBicewm\-prefoverride\fR\|(5), \&\fBicewm\-programs\fR\|(5), \&\fBicewm\-session\fR\|(1), \&\fBicewm\-set\-gnomewm\fR\|(1), \&\fBicewm\-shutdown\fR\|(5), \&\fBicewm\-startup\fR\|(5), \&\fBicewm\-theme\fR\|(5), \&\fBicewm\-toolbar\fR\|(5), \&\fBicewm\-winoptions\fR\|(5), \&\fBicewmbg\fR\|(1), \&\fBicewmhint\fR\|(1), \&\fBsetxkbmap\fR\|(1), \&\fBXorg\fR\|(1), \&\fBXserver\fR\|(1), \&\fBxinit\fR\|(1), \&\fBxprop\fR\|(1), \&\fBxwininfo\fR\|(1), \&\fBwmctrl\fR\|(1). .SH "BUGS" .IX Header "BUGS" \&\fBicewm\fR had no known bugs at the time of release. Please report bugs for current versions to the source code repository at . .SH "AUTHOR" .IX Header "AUTHOR" Brian Bidulock . .PP See \fB\-\-copying\fR for full copyright notice and copying permissions. .SH "LICENSE" .IX Header "LICENSE" \&\fBIceWM\fR is licensed under the \s-1GNU\s0 Library General Public License. See the \fI\s-1COPYING\s0\fR file in the distribution or use the \fB\-\-copying\fR flag to display copying permissions.