Ubuntu Manpage: icewm - lightweight X11 window manager

name
description
options
environment variables
files
examples
see also
authors
bug reports
copying

Provided by: icewm-common_1.3.8+githubmod+20150914+fa3fdef-2_amd64

NAME

       icewm - lightweight X11 window manager

DESCRIPTION

IceWM is lightweight X11 window manager. The goal of IceWM is to provide a small, fast and familiar
window manager for the X11 window system. Compatibility with the window manager is desired and will be
implemented where appropriate.

It was originally designed to emulate the look of Motif, OS/2 Warp 4, OS/2 Warp 3 and Windows 95. Since
it has a theming engine (hint: http://www.icewm.org/) others styles are possible. It also tries to
combine the feel of the above systems whenever it is compatible.

Generally, it tries to make all functions available both by keyboard and by mouse (this is not currently
possible when using mouse focus). Extreme configurability similar to fvwm and many other window managers
is NOT the goal. However IceWM configurability is very good through its various preferences files.

IceWM consists of several parts:

icewm - the actual window manager binary. This is the one you need to get window decorations.

icewmbg - the background setting applications. It can assign plain background color or images in
different formats to the X background, shared or separated for different workspaces. This program should
be started before IceWM startup.

icewmtray - catches the Docklet objects installed by various applications like PSI.

icewm-session - runs all of the above when needed. Implements basic session management.

icesh - could be used to manage IceWM internals from command line.

icewmhint - used internally.

icesound - plays audio files on GUI events raised by IceWM.

OPTIONS

       For most of the parts use option

       -h, --help
              to see all of the options.

ENVIRONMENT VARIABLES

       ICEWM_PRIVCFG=PATH
              Directory to use for user private configuration files, "$HOME/.icewm/" by default.

       DISPLAY=NAME
              Name of the X server to use, depends on Xlib by default. See X(1).

       MAIL=URL
              Location of your mailbox. If the schema is omitted the local "file" schema is assumed.

FILES

       IceWM looks for its configuration files in the following directories, in the following order:

       $(HOME)/.icewm/
              User-specific configurations

       /etc/X11/icewm/
              System-wide customized defaults

       /usr/local/share/icewm/
              Default installation settings

       Configuration files

       keys
              global keybindings to launch applications (not window manager related)

       menu
              menu of startable applications; usually customized by the user

       preferences
              general settings - paths, colors, fonts...

       prefoverride
              settings that should override the themes

       programs
              automatically  generated menu of startable applications (this should be used for wmconfig, menu or
              similar packages, perhaps as a part of the login or X startup sequence)

       theme
              currently selected theme

       toolbar
              quick launch application icons on the taskbar

       winoptions
              application window options

       startup
              commands to execute on IceWM startup

       shutdown
              commands to execute on IceWM shutdown

       Configuration directories

       icons
              icons used for applications (usually XPM files *_16x16.xpm and *_32x32.xpm)

       ledclock
              pictures of digits for clocks displayed in taskbar

       mailbox
              icons used for different states of mailbox

       taskbar
              pictures to customize look of the taskbar

       themes
              directory to store themes

EXAMPLES

       Examples of above configuration files you can  find  in  default  installation  path  or  in  system-wide
       customizable defaults.

AUTHORS

       The  original  version  of IceWM was designed and implemented in 1997 by Marko Macek, in year 2001 it was
       maintained by Mathias Hasselmann then again Marko Macek took over.

       IceWM man page written by Adam Pribyl, covex@ahoj.fsik.cvut.cz, 2005

BUG REPORTS

       If you find a bug in IceWM please use bug reporting system on  http://sourceforge.net/projects/icewm/  to
       report it.

COPYING

       IceWM is released under GNU Library General Public License.

       This  library  is  free  software;  you  can  redistribute it and/or modify it under the terms of the GNU
       Library General Public License as published by the Free Software Foundation;  either  version  2  of  the
       License, or (at your option) any later version.

       This  library  is  distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
       the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General
       Public License for more details.

       You  should  have  received  a copy of the GNU Library General Public License along with this library; if
       not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite  330,  Boston,  MA   02111-1307
       USA.