IceWM searches for it's configuration files in the following directories:
$HOME/.icewm
/etc/X11/icewm
/usr/X11R6/lib/X11/icewm
or /usr/local/lib/X11/icewm
(compilation dependant)IceWM uses the following configuration files:
preferences
- General settings - paths, colors, fonts...
menu
- Menu of startable applications
winoptions
- Application window optionsDefault values are shown following the equal sign.
The following settings can be set to value 1 (enabled) or value 0 (disabled).
Show X (close) button on the title bar.
Enables click to focus mode.
Window is raised when focused.
Window is focused when client area is clicked.
Window is raised when client area is clicked.
Window is raised when titlebar is clicked.
Window is raised when title bar button is clicked.
Window is raised when frame is clicked.
Window is focused after being mapped.
Colormap focus follows pointer.
Window can be resized when maximized.
Move/resize status window is visible when moving/resizing the window.
Pointer is moved in pointer focus move when focus is moved using the keyboard.
Window is immediately moved when dragged, no outline is shown.
Window is immediatelly resized when dragged, no outline is shown.
Task bar is located at top of screen.
Task bar is visible.
Task bar clock is visible.
The following settings can be set to a numeric value.
Left/right border width.
Top/bottom border height.
Left/right border width of non-resizable windows.
Top/bottom border height of non-resizable windows.
Width of the window corner.
Height of the window corner.
Resistance to move window with mouse outside screen limits.
The following settings can be set to a string value.
Name of the title bar font.
Name of the menu font.
Name of the status display font.
Name of the normal task bar item font.
Name of the active task bar item font.
Name of the window list font.
Color of the active window border.
...
Path to the icewm/lib directory.
Path to the icon directory. Multiple paths can be entered using the colon (:) as the separator.
winoptions file is used to configure settings for individual application windows.
Each line in the file must be in one of the possible formats:
window_class.window_name.option: argument window_name.option: argument window_class.option: argument
Each window on the desktop has (should) class and name resources associated with it.
They can be determined using the xprop
utility.
xprop should display a line like this when used on a toplevel window:
WM_CLASS = "name", "class"
Options that can be set per window are as follows:
The name of the icon.
If set to 1, window will stay above normal windows.
If set to 1, window will be visible on all workspaces.
If set to 1, window will not appear in the window list.
If set to 1, window will not appear on the task bar.
If set to 1, the window manager leave more keys (Alt+F?) to the application.
If set to 0, window will not be moveable.
If set to 0, window will not be resizeable.
If set to 0, window will not be closeable.
If set to 0, window will not be minimizeable.
If set to 0, window will not be maximizeable.
If set to 0, window will not be hideable.
If set to 0, window will not be shadeable.
If set to 0, window will not have the title bar.
If set to 0, window will not have the system menu.
If set to 0, window will not have the border.
If set to 0, window will not have the resize border.
If set to 0, window will not have the close button.
If set to 0, window will not have the minimize button.
If set to 0, window will not have the maximize button.