Previous Next Table of Contents

7. Configuration Files

IceWM searches for it's configuration files in the following directories:

  1. $HOME/.icewm
  2. /etc/X11/icewm
  3. /usr/X11R6/lib/X11/icewm or /usr/local/lib/X11/icewm (compilation dependant)

IceWM uses the following configuration files:

7.1 preferences

Default values are shown following the equal sign.

Focus and other settings

The following settings can be set to value 1 (enabled) or value 0 (disabled).

ShowXButton = 1

Show X (close) button on the title bar.

ClickToFocus = 1

Enables click to focus mode.

RaiseOnFocus = 1

Window is raised when focused.

FocusOnClickClient = 1

Window is focused when client area is clicked.

RaiseOnClickClient = 1

Window is raised when client area is clicked.

RaiseOnClickTitleBar = 1

Window is raised when titlebar is clicked.

RaiseOnClickButton = 1

Window is raised when title bar button is clicked.

RaiseOnClickFrame = 1

Window is raised when frame is clicked.

FocusOnMap = 1

Window is focused after being mapped.

PointerColormap = 0

Colormap focus follows pointer.

SizeMaximized = 0

Window can be resized when maximized.

ShowMoveSizeStatus = 1

Move/resize status window is visible when moving/resizing the window.

WarpPointer = 0

Pointer is moved in pointer focus move when focus is moved using the keyboard.

OpaqueMove = 1

Window is immediately moved when dragged, no outline is shown.

OpaqueResize = 0

Window is immediatelly resized when dragged, no outline is shown.

TaskBarAtTop = 0

Task bar is located at top of screen.

ShowTaskBar = 1

Task bar is visible.

ShowTaskBarClock = 1

Task bar clock is visible.

Border sizes

The following settings can be set to a numeric value.

BorderSizeX = 6

Left/right border width.

BorderSizeY = 6

Top/bottom border height.

DlgBorderSizeX = 2

Left/right border width of non-resizable windows.

DlgBorderSizeY = 2

Top/bottom border height of non-resizable windows.

CornerSizeX = 24

Width of the window corner.

CornerSizeY = 24

Height of the window corner.

EdgeResistance = 32

Resistance to move window with mouse outside screen limits.

Font settings

The following settings can be set to a string value.

TitleFontName = ""

Name of the title bar font.

MenuFontName = ""

Name of the menu font.

StatusFontName = ""

Name of the status display font.

NormalTaskBarFontName = ""

Name of the normal task bar item font.

ActiveTaskBarFontName = ""

Name of the active task bar item font.

WindowListFontNAme = ""

Name of the window list font.

Color settings

ColorActiveBorder

Color of the active window border.

...

...

Path settings

LibPath

Path to the icewm/lib directory.

IconPath

Path to the icon directory. Multiple paths can be entered using the colon (:) as the separator.

7.2 menu

7.3 winoptions

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:

icon

The name of the icon.

onTop=0

If set to 1, window will stay above normal windows.

allWorkspaces=0

If set to 1, window will be visible on all workspaces.

ignoreWinList=0

If set to 1, window will not appear in the window list.

ignoreTaskBar=0

If set to 1, window will not appear on the task bar.

fullKeys=0

If set to 1, the window manager leave more keys (Alt+F?) to the application.

fMove=1

If set to 0, window will not be moveable.

fResize=1

If set to 0, window will not be resizeable.

fClose=1

If set to 0, window will not be closeable.

fMinimize=1

If set to 0, window will not be minimizeable.

fMaximize=1

If set to 0, window will not be maximizeable.

fHide=1

If set to 0, window will not be hideable.

fShade=1

If set to 0, window will not be shadeable.

dTitleBar=1

If set to 0, window will not have the title bar.

dSysMenu=1

If set to 0, window will not have the system menu.

dBorder=1

If set to 0, window will not have the border.

dResize=1

If set to 0, window will not have the resize border.

dClose=1

If set to 0, window will not have the close button.

dMinimize=1

If set to 0, window will not have the minimize button.

dMaximize=1

If set to 0, window will not have the maximize button.


Previous Next Table of Contents