diff options
Diffstat (limited to 'upstream/mageia-cauldron/man1/icewm.1')
| -rw-r--r-- | upstream/mageia-cauldron/man1/icewm.1 | 1418 |
1 files changed, 1418 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man1/icewm.1 b/upstream/mageia-cauldron/man1/icewm.1 new file mode 100644 index 00000000..5d04293e --- /dev/null +++ b/upstream/mageia-cauldron/man1/icewm.1 @@ -0,0 +1,1418 @@ +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) +.\" +.\" 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 +.. +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. +.ie n \{\ +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. 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 +.\" ======================================================================== +.\" +.IX Title "ICEWM 1" +.TH ICEWM 1 2023-12-28 "icewm 3.4.5" "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 +.SS NAME +.IX Subsection "NAME" +.Vb 1 +\& icewm \- lightweight X11 window manager +.Ve +.SS SYNOPSIS +.IX Subsection "SYNOPSIS" +\&\fBicewm\fR [\fIOPTIONS\fR] +.SS DESCRIPTION +.IX Subsection "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 ICCCM and EWMH window manager specifications. +.SS PROGRAMS +.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, +that 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 workspace can +have its own background. It supports semitransparency. 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. See the \fBicewmbg\fR\|(1). +.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 that 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 that is started +subsequently. See \fBicewmhint\fR\|(1). +.IP \fBicesound\fR\|(1) 4 +.IX Item "icesound" +Plays audio files on GUI events that are raised by \fBicewm\fR. +It supports ALSA, AO and OSS. 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 XDG specifications. See the \fBicewm\-menu\-fdo\fR\|(1) man page. +.IP \fBicewm\-set\-gnomewm\fR\|(1) 4 +.IX Item "icewm-set-gnomewm" +Configures GNOME to start IceWM instead of its own WM. +.SS OPTIONS +.IX Subsection "OPTIONS" +.SS "COMMON OPTIONS" +.IX Subsection "COMMON OPTIONS" +Each of the IceWM executables supports the following options: +.IP "\fB\-c\fR, \fB\-\-config\fR=\fIFILE\fR" 4 +.IX Item "-c, --config=FILE" +Use \fIFILE\fR as the source of configuration options. By default \fBicewm\fR +looks for a file named \fIpreferences\fR. This is a readable text file +that can be modified with the help of a text editor. +.IP "\fB\-t\fR, \fB\-\-theme\fR=\fINAME\fR" 4 +.IX Item "-t, --theme=NAME" +Use \fINAME\fR as the name of the \fBicewm\fR theme to use. A theme defines +the look and feel of \fBicewm\fR, like colors, fonts and buttons. +.IP "\fB\-d\fR, \fB\-\-display\fR=\fIDISPLAY\fR" 4 +.IX Item "-d, --display=DISPLAY" +Connect to the X11 server on \fIDISPLAY\fR. By default +the environment variable \f(CW\*(C`DISPLAY\*(C'\fR is used. +.IP "\fB\-o\fR, \fB\-\-output=FILE\fR" 4 +.IX Item "-o, --output=FILE" +Redirect all output to \fIFILE\fR. +A leading tilde or environment variable is expanded. +.IP \fB\-\-sync\fR 4 +.IX Item "--sync" +This option specifies to use a slower synchronous communication mode +with the X11 server. This is irrelevant for normal use. +.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 "ICEWM OPTIONS" +.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 ICCCM 2.0 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. If no window manager is active, then it starts one. +.IP "\fB\-s\fR, \fB\-\-splash\fR=\fIIMAGE\fR" 4 +.IX Item "-s, --splash=IMAGE" +Briefly show \fIIMAGE\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 that 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\-\-rewrite\-preferences\fR 4 +.IX Item "--rewrite-preferences" +Overwrite an existing preferences file with an icewm default preferences, +but preserve all modifications insofar they deviate from the defaults. +.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,\fIfont\fR,\fIicon\fR,\fIprog\fR,\fIsystray\fR 4 +.IX Item "--trace=conf,font,icon,prog,systray" +Enable tracing of the paths that are used to load configuration, +fonts, icons, executed programs, and/or system tray applets. +.SS USAGE +.IX Subsection "USAGE" +.SS TASKBAR +.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 workspace and a list of workspaces +with sub-menus for their active application windows. +.PP +The \fIToolbar\fR is a list of icons for applications that are defined in +the toolbar configuration file. +.PP +The \fIWorkspace Pane\fR shows one button for each workspace. The current +workspace is indicated by a pressed button. Clicking another workspace +switches to that workspace. Press left mouse, then the Shift key, then +release the left mouse, takes the current window to that workspace. +Press left, then Alt, then release left, moves only the focused window +to other workspace, without changing the current workspace. +.PP +The workspaces are defined in the \fIpreferences\fR file. To change a name +for only this session, double click, edit the name and hit Enter. +When \f(CW\*(C`PagerShowPreview\*(C'\fR is turned on, a small graphical window summary +for each workspace is shown. They support drag-and-drop: dragging a +Firefox tab to a workspace button changes the current workspace. +Then releasing it moves that tab to a new window in that workspace. +.PP +The \fITask Pane\fR consists of a list of wide buttons for each application +that is running on the current workspace, 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 that 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 \fIAPM 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 \fICPU Applet\fR monitors processor utilization. +.PP +The \fIMailbox Applet\fR monitors mailbox status changes. +See the section MAILBOX MONITORING 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 "INPUT FOCUS" +.IX Subsection "INPUT FOCUS" +Of all visible windows only one can be the active window. This is the +window that has input focus. It is the primary receiver of keyboard +and mouse events and hence one can interact with the application that +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 that 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 that is defined by the following ten options: +\&\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 +ways by keyboard. By 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. The other method +involves the quick switch. +.SS "QUICK SWITCH" +.IX Subsection "QUICK SWITCH" +The \fBQuickSwitch\fR is a means to quickly and interactively change +the input focus to another window. It is activated by pressing the +\&\f(CW\*(C`Alt+Tab\*(C'\fR or \f(CW\*(C`Alt+Shift+Tab\*(C'\fR key combination. A window pops up +in the centre of the screen with a list of windows to choose from. +A narrow band indicates a selection: the candidate window that will +be activated to receive input focus when the Alt key is released. +.PP +The selection can be changed by repeatedly pressing the Tab key, while +keeping the Alt key down. If a Shift key is also down, the direction of +traversal is reversed. Or use the scroll wheel of the mouse. Or use +one of the digit keys to select the corresponding window from the list. +Arrow keys are also supported, as well as the Home and End key. +.PP +To make a selected window the active window, just release the Alt key, +or hit the Return key, or click on it. To cancel the QuickSwitch, +press Escape or click outside of the QuickSwitch window. +.PP +A selected window can be closed by Delete, \f(CW\*(C`Alt+F4\*(C'\fR, or the middle +mouse button. While the QuickSwitch window is up, one can still change +workspace with the usual workspace hotkeys. +.PP +The QuickSwitch has two distinct modes: vertical and horizontal. +The window list can include all windows or be limited to the current +workspace. There is an option to raise the selected candidate. +See the many preferences available for the QuickSwitch. +.SS "WINDOW PLACEMENT" +.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 "WINDOW LAYERS" +.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 "TABBED WINDOWS" +.IX Subsection "TABBED WINDOWS" +A window frame may contain multiple client windows. Only one client can +be visible, while the others are hidden. This is called tabbing. This +can be helpful to reduce the number of visible windows. To create a tab, +drag the title bar with the middle mouse button, while holding down a +shift key, onto the title bar of another frame. The two title bars will +start to flash to indicate that they can merge. Release the mouse button +to merge the client of the upper window to the lower frame. Now the +lower frame will have multiple clients, called tabs. The title bar will +show a vertical bar with triple dots to indicate this. +To change the current tab either: +.IP \(bu 4 +Click on the triple dots next to the vertical bar. +.IP \(bu 4 +Use \f(CW\*(C`KeyWinNext=Alt+F6\*(C'\fR to select the next tab. +.IP \(bu 4 +Use \f(CW\*(C`KeyWinPrev=Alt+Shift+F6\*(C'\fR for the previous tab. +.IP \(bu 4 +Use the QuickSwitch. +.IP \(bu 4 +Use the window list window. +.IP \(bu 4 +Use a submenu in the window menu. +.PP +To change the mouse binding for creating tabs, modify +\&\fBMouseWinTabbing\fR=\f(CW\*(C`Shift+Pointer_Button2\*(C'\fR. Another +useful setting is \fBMouseWinTabbing\fR=\f(CW\*(C`Pointer_Button1\*(C'\fR. +.PP +\&\f(CW\*(C`Alt+F4\*(C'\fR closes all tabs. To close just the active tab add to \f(CW\*(C`keys\*(C'\fR: +.PP +.Vb 1 +\& key "Ctrl+Shift+F4" icesh \-f close +.Ve +.PP +To move the active tab to its own window frame by key, add to \f(CW\*(C`keys\*(C'\fR: +.PP +.Vb 1 +\& key "Alt+u" icesh \-f untab +.Ve +.PP +To open all chrome windows in the same frame add this to \f(CW\*(C`winoptions\*(C'\fR: +.PP +.Vb 1 +\& google\-chrome.frame: chrome +.Ve +.SS WORKSPACES +.IX Subsection "WORKSPACES" +\&\fBicewm\fR supports multiple virtual desktops called workspaces. A +workspace is like a screen where a subset of all application windows are +mapped. Thanks to multiple workspaces we can more easily manage a +large number of applications. The number of workspaces 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 that receive multiple +values. It is a list of comma-separated values each of which can be +quoted. +.PP +The workspaces are visible on the toolbar. One can switch to a +different workspace by pressing the workspace button in the toolbar, +but after becoming familiar with the 'keyboard shortcuts' below one will +want to use a hotkey to choose a workspace. 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 workspace 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 "DRAG AND DROP" +.IX Subsection "DRAG AND DROP" +The task bar supports drag and drop operations. When a drag +is in progress, the destination window can be activated by +hovering the drag icon over the task button for that window. +Alternatively, the current workspace can be changed by +hovering the drag icon over the desired workspace button. +When edge switching is enabled, the current workspace can +also be changed by bringing the drag icon to the screen edge. +.SS "ADDRESS BAR" +.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 that 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 "WINDOW LIST" +.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 that 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 "SYSTEM DIALOG" +.IX Subsection "SYSTEM DIALOG" +The system dialog offers quick access to a set of general controls. +It can lock the screen, suspend the system, logout or cancel a pending +logout, reboot the system, shutdown the system, show the window list, +restart icewm, show the about dialog, reload the winoptions file or +the keys file. It is activated by \fBKeySysDialog\fR=\f(CW\*(C`Ctrl+Alt+Del\*(C'\fR. +To cancel it, hit the Escape key. +.SS "MAILBOX MONITORING" +.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 POP or IMAP +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 URL. +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 POP3S and IMAPS schemes use \f(CW\*(C`openssl\*(C'\fR for TLS/SSL encryption. +Note that for IceWM to access Gmail you must first configure +your Gmail account to enable POP3 or IMAP access. +Make sure you have secure file permissions on your IceWM +preferences file and the directory that 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 ICEWM_MAILBOX 4 +.IX Item "ICEWM_MAILBOX" +The mailbox index number of \fIMailBoxPath\fR starting from 1. +.IP ICEWM_COUNT 4 +.IX Item "ICEWM_COUNT" +The total number of messages in this mailbox. +.IP ICEWM_UNREAD 4 +.IX Item "ICEWM_UNREAD" +The number of unread messages in this mailbox. +.SS "KEYBOARD LAYOUT SWITCHING" +.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, or use the \fBKeySysKeyboardNext\fR key. +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 "KEYBOARD SHORTCUTS" +.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. +.PP +Note that all use one or more key modifiers. Icewm supports the +following modifiers: Alt, AltGr, Ctrl, Hyper, Meta, Shift, Super. +Setting \fBModSuperIsCtrlAlt=1\fR makes the Super modifier an alias +for Ctrl+Alt. +.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 that 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 workspaces. +.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 that 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. +.IP "\fBKeyWinTileLeft\fR=""""" 4 +.IX Item "KeyWinTileLeft=""""" +Let the active window occupy the left half of the screen. +.IP "\fBKeyWinTileRight\fR=""""" 4 +.IX Item "KeyWinTileRight=""""" +Let the active window occupy the right half of the screen. +.IP "\fBKeyWinTileTop\fR=""""" 4 +.IX Item "KeyWinTileTop=""""" +Let the active window occupy the top half of the screen. +.IP "\fBKeyWinTileBottom\fR=""""" 4 +.IX Item "KeyWinTileBottom=""""" +Let the active window occupy the bottom half of the screen. +.IP "\fBKeyWinTileTopLeft\fR=""""" 4 +.IX Item "KeyWinTileTopLeft=""""" +Let the active window occupy the top left quarter of the screen. +.IP "\fBKeyWinTileTopRight\fR=""""" 4 +.IX Item "KeyWinTileTopRight=""""" +Let the active window occupy the top right quarter of the screen. +.IP "\fBKeyWinTileBottomLeft\fR=""""" 4 +.IX Item "KeyWinTileBottomLeft=""""" +Let the active window occupy the bottom left quarter of the screen. +.IP "\fBKeyWinTileBottomRight\fR=""""" 4 +.IX Item "KeyWinTileBottomRight=""""" +Let the active window occupy the bottom right quarter of the screen. +.IP "\fBKeyWinTileCenter\fR=""""" 4 +.IX Item "KeyWinTileCenter=""""" +Let the active window occupy the center quarter 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=""Ctrl+Alt+Del""" 4 +.el .IP \fBKeySysDialog\fR=\f(CWCtrl+Alt+Del\fR 4 +.IX Item "KeySysDialog=Ctrl+Alt+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+minus""" 4 +.el .IP \fBKeySysWorkspace11\fR=\f(CWAlt+Ctrl+minus\fR 4 +.IX Item "KeySysWorkspace11=Alt+Ctrl+minus" +Goes to workspace 11. +.ie n .IP "\fBKeySysWorkspace12\fR=""Alt+Ctrl+equal""" 4 +.el .IP \fBKeySysWorkspace12\fR=\f(CWAlt+Ctrl+equal\fR 4 +.IX Item "KeySysWorkspace12=Alt+Ctrl+equal" +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+minus""" 4 +.el .IP \fBKeySysWorkspace11TakeWin\fR=\f(CWAlt+Ctrl+Shift+minus\fR 4 +.IX Item "KeySysWorkspace11TakeWin=Alt+Ctrl+Shift+minus" +Takes the active window to workspace 11. +.ie n .IP "\fBKeySysWorkspace12TakeWin\fR=""Alt+Ctrl+Shift+equal""" 4 +.el .IP \fBKeySysWorkspace12TakeWin\fR=\f(CWAlt+Ctrl+Shift+equal\fR 4 +.IX Item "KeySysWorkspace12TakeWin=Alt+Ctrl+Shift+equal" +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 "\fBKeySysKeyboardNext\fR=""undefined""" 4 +.el .IP \fBKeySysKeyboardNext\fR=\f(CWundefined\fR 4 +.IX Item "KeySysKeyboardNext=undefined" +Switch to the next keyboard layout in the KeyboardLayouts list. +.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 "INPUT FOCUS") +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 WM_CLASS property as the currently focused window. +.SS "MOUSE BINDINGS" +.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. +.IP "\fBMouseWinTabbing\fR=""Shift+Pointer_Button2""" 4 +.IX Item "MouseWinTabbing=""Shift+Pointer_Button2""" +Mouse binding to create tabs. +Drag the title bar with this button over another title bar. +When they start to flash, release the button to merge the frame tabs. +.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). Press +Shift to only maximize vertically. Press Alt+Shift for horizontally. +Middle double clicking rolls up the window (\f(CW\*(C`TitleBarRollupButton=2\*(C'\fR). +Also press Shift to maximize horizontally. If \fBTitleBarRollupButton\fR +is either 4 or 5 then the scroll wheel controls rolling up or down. +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. +.SS SIGNALS +.IX Subsection "SIGNALS" +\&\fBicewm\fR supports the following signals: +.IP \fBSIGHUP\fR 4 +.IX Item "SIGHUP" +\&\fBicewm\fR will restart itself. It is a way to reload the configuration. +.IP "\fBSIGINT\fR, \fBSIGTERM\fR" 4 +.IX Item "SIGINT, SIGTERM" +\&\fBicewm\fR will cease to manage application windows and terminate. +.IP \fBSIGQUIT\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 \fBSIGUSR2\fR 4 +.IX Item "SIGUSR2" +Toggle the logging of X11 events, if \f(CW\*(C`logevents\*(C'\fR was configured. +.SS "ENVIRONMENT VARIABLES" +.IX Subsection "ENVIRONMENT VARIABLES" +.IP \fBICEWM_PRIVCFG\fR 4 +.IX Item "ICEWM_PRIVCFG" +The directory for user private configuration files. When this +environment variable is not specified, the default directory is +\&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm\fR when that directory exists, otherwise the +default value is \fI\fR\f(CI$HOME\fR\fI/.icewm\fR. +.IP \fBDISPLAY\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 "\fBMAILPATH\fR, \fBMAIL\fR" 4 +.IX Item "MAILPATH, MAIL" +Gives the location of your mailbox. If the schema is omitted the local +"file" 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. +.SS FILES +.IX Subsection "FILES" +.SS "CONFIGURATION DIRECTORIES" +.IX Subsection "CONFIGURATION DIRECTORIES" +\&\fBicewm\fR looks for configuration files in the following directories, in +the given order, until it finds one: +.ie n .IP \fR\fI$ICEWM_PRIVCFG\fR\fI/\fR 4 +.el .IP \fR\f(CI$ICEWM_PRIVCFG\fR\fI/\fR 4 +.IX Item "$ICEWM_PRIVCFG/" +Contains user-specific configurations. When \fBICEWM_PRIVCFG\fR is +specified, this directory takes precedence over +\&\fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm\fR and \fI\fR\f(CI$HOME\fR\fI/.icewm\fR. +.ie n .IP \fR\fI$XDG_CONFIG_HOME\fR\fI/icewm/\fR 4 +.el .IP \fR\f(CI$XDG_CONFIG_HOME\fR\fI/icewm/\fR 4 +.IX Item "$XDG_CONFIG_HOME/icewm/" +Contains user-specific configurations. When this directory exists it +take precedence over \fR\f(CI$HOME\fR\fI/.icewm\fR. +.ie n .IP \fR\fI$HOME\fR\fI/.icewm/\fR 4 +.el .IP \fR\f(CI$HOME\fR\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 "CONFIGURATION FILES" +.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 POSIX 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 that 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 that 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 that 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 that 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 that 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 that 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 that 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 that 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 workspaces. 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 that 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 "CONFIGURATION SUBDIRECTORIES" +.IX Subsection "CONFIGURATION SUBDIRECTORIES" +.IP \fIcursors\fR 4 +.IX Item "cursors" +May contain cursor icons in the XPM image format. These overrule cursors +provided by a theme. There are 3 direction cursors: \fIleft.xpm\fR, +\&\fIright.xpm\fR, \fImove.xpm\fR, 8 resize cursors: \fIsizeR.xpm\fR, \fIsizeTR.xpm\fR, +\&\fIsizeT.xpm\fR, \fIsizeTL.xpm\fR, \fIsizeL.xpm\fR, \fIsizeBL.xpm\fR, \fIsizeB.xpm\fR, +\&\fIsizeBR.xpm\fR, and 4 scroll cursors: \fIscrollL.xpm\fR, \fIscrollR.xpm\fR, +\&\fIscrollU.xpm\fR, and \fIscrollD.xpm\fR. +By default an XPM header defines four dimensions: width, height, colors +and chars-per-pixel. For cursors this must be extended to six. The last +two are the \fIx\-hotspot\fR and the \fIy\-hotspot\fR. These define which point +in the XPM image is the sensitive point for the mouse pointer. +.IP \fIicons\fR 4 +.IX Item "icons" +Contains icons that are used to identify applications. Usually these +files are in the XPM format, but the PNG and SVG 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 LED 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 that 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 that are played by \fBicesound\fR\|(1) on GUI 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 that have a \fI.theme\fR file name extension and that +contain tweaks of the \fIdefault.theme\fR file. +How to create a theme is explained in the +IceWM Theme Creation Howto. +.IP \fIworkspace\fR 4 +.IX Item "workspace" +If \f(CW\*(C`PagerShowPreview\*(C'\fR is disabled, icewm looks in the \f(CW\*(C`workspace\*(C'\fR +directory for images to draw on a workspace button. The image filename +should have the name of the workspace. The image extension is optional. +.SS OPACITY +.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 that \fBicewm\fR sets on its windows +are \fIDIALOG\fR, \fINOTIFICATION\fR, \fIPOPUP_MENU\fR and \fITOOLTIP\fR. The output +of \f(CW\*(C`icesh windows\*(C'\fR shows their WM_CLASS values. These can be helpful +to configure compton. +.SS EXAMPLES +.IX Subsection "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. +.SS "CONFORMING TO" +.IX Subsection "CONFORMING TO" +ICCCM 2.0: partial. NetWM/EWMH: extensive. +See the file \fICOMPLIANCE\fR in the distribution for full details. +.SS "SEE ALSO" +.IX Subsection "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). +.SS BUGS +.IX Subsection "BUGS" +Please report bugs at <https://github.com/bbidulock/icewm/issues>. +.SS AUTHOR +.IX Subsection "AUTHOR" +Brian Bidulock <mailto:bidulock@openss7.org>. +.PP +See \fB\-\-copying\fR for full copyright notice and copying permissions. +.SS LICENSE +.IX Subsection "LICENSE" +\&\fBIceWM\fR is licensed under the GNU Library General Public License. +See the \fICOPYING\fR file in the distribution or use the \fB\-\-copying\fR flag +to display copying permissions. |