icewm(1) - f14

1IceWM(1)                        Window Manager                        IceWM(1)
2
3
4

NAME

6       icewm - lightweight X11 window manager
7
8

DESCRIPTION

10       IceWM  is lightweight X11 window manager.  The goal of IceWM is to pro‐
11       vide a small, fast and familiar window manager for the X11 window  sys‐
12       tem.  Compatibility  with  the  window  manager  is desired and will be
13       implemented where appropriate.
14
15       It was originally designed to emulate the look of Motif, OS/2  Warp  4,
16       OS/2  Warp  3  and  Windows  95.  Since  it has a theming engine (hint:
17       http://www.icewm.org/) others styles are possible.  It  also  tries  to
18       combine the feel of the above systems whenever it is compatible.
19
20       Generally,  it  tries  to make all functions available both by keyboard
21       and by mouse (this is not currently possible when using  mouse  focus).
22       Extreme  configurability similar to fvwm and many other window managers
23       is NOT the goal. However IceWM configurability is  very  good  throught
24       its various preferences files.
25
26       IceWM consists of several parts:
27
28       icewm  -  the actual window manager binary. This is the one you need to
29       get window decorations.
30
31       icewmbg - the background setting  applications.  It  can  assign  plain
32       background  color  or  images in different formats to the X background,
33       shared or separated for different workspaces. This  program  should  be
34       started before IceWM startup.
35
36       icewmtray  -  catches the Docklet objects installed by various applica‐
37       tions like PSI.
38
39       icewm-session - runs all of the above  when  needed.  Implements  basic
40       session management.
41
42       icesh - could be used to manage IceWM internals from command line.
43
44       icewmhint - used internaly.
45
46       icesound - plays audio files on GUI events raised by IceWM.
47
48

OPTIONS

50       For most of the parts use option
51
52       -h, --help
53              to see all of the options.
54

ENVIRONMENT VARIABLES

56       ICEWM_PRIVCFG=PATH
57              Directory   to   use   for  user  private  configuration  files,
58              "$HOME/.icewm/" by default.
59
60       DISPLAY=NAME
61              Name of the X server to use, depends on  Xlib  by  default.  See
62              X(1).
63
64       MAIL=URL
65              Location  of  your  mailbox.  If the schema is omitted the local
66              "file" schema is assumed.
67
68

FILES

70       IceWM looks for its configuration files in the  following  directories,
71       in the following order:
72
73       $(HOME)/.icewm/
74              User-specific configurations
75
76       /etc/X11/icewm/
77              System-wide customized defaults
78
79       /usr/local/share/icewm/
80              Default installation settings
81
82       Configuration files
83
84       keys
85              global  keybindings  to  launch applications (not window manager
86              related)
87
88       menu
89              menu of startable applications; usually customized by the user
90
91       preferences
92              general settings - paths, colors, fonts...
93
94       prefoverride
95              settings that should override the themes
96
97       programs
98              automatically generated menu  of  startable  applications  (this
99              should  be  used for wmconfig, menu or similar packages, perhaps
100              as a part of the login or X startup sequence)
101
102       theme
103              currently selected theme
104
105       toolbar
106              quick launch application icons on the taskbar
107
108       winoptions
109              application window options
110
111       startup
112              commands to execute on IceWM startup
113
114       shutdown
115              commands to execute on IceWM shutdown
116
117       Configuration directories
118
119       icons
120              icons used for applications (usually XPM files  *_16x16.xpm  and
121              *_32x32.xpm)
122
123       ledclock
124              pictures of digits for clocks displayed in taskbar
125
126       mailbox
127              icons used for different states of mailbox
128
129       taskbar
130              pictures to customize look of the taskbar
131
132       themes
133              directory to store themes
134
135

EXAMPLES

137       Examples  of above configuration files you can find in default instala‐
138       tion path or in system-wide customizable defaults.
139

AUTHORS

150       The original version of IceWM was designed and implemented in  1997  by
151       Marko  Macek, in year 2001 it was maintained by Mathias Hasselmann then
152       again Marko Macek took over.
153
154       IceWM man page written by Adam Pribyl, covex@ahoj.fsik.cvut.cz, 2005
155

BUG REPORTS

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

COPYING

161       IceWM is released under GNU Library General Public License.
162
163       This library is free software; you can redistribute it and/or modify it
164       under the terms of the GNU Library General Public License as  published
165       by  the  Free  Software Foundation; either version 2 of the License, or
166       (at your option) any later version.
167
168       This library is distributed in the hope that it  will  be  useful,  but
169       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
170       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  Library
171       General Public License for more details.
172
173       You  should  have  received  a  copy  of the GNU Library General Public
174       License along with this library; if not, write  to  the  Free  Software
175       Foundation,  Inc.,  59 Temple Place - Suite 330, Boston, MA  02111-1307
176       USA.
177
178
179
180Adam Pribyl                      July 20 2005                         IceWM(1)