Next Previous Contents

8. Configuration Files

IceWM uses the following configuration files:

8.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 (0 = off, 1 = last, 2 = first)

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.

PassFirstClickToClient = 1

The click which raises the window is also passed to the client.

AutoRaise = 0

Windows will raise automatically after AutoRaiseDelay when focused.

FocusOnMap = 1

Window is focused after being mapped.

FocusOnMapTransient = 1

Transient window is focused after being mapped.

FocusOnAppRaise = 1

The window is focused when application raises it.

PointerColormap = 0

Colormap focus follows pointer.

SizeMaximized = 0

Window can be resized when maximized.

MinimizeToDesktop = 0

Window is minimized to desktop area (in addition to the taskbar).

QuickSwitch = 1

enable Alt+Tab window switcher.

QuickSwitchToMinimized = 1

Alt+Tab switches to minimized windows too.

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.

Win95Keys = 0

Makes 3 additional keys perform sensible functions. The keys must be mapped to MetaL,MetaR and Menu. The left one will activate the start menu and the right one will display the window list.

ManualPlacement = 0

Windows must be placed manually by the user.

IgnoreNoFocusHint = 0

Ignore no-accept-focus hint set by some windows.

MenuMouseTracking = 0

If enabled, menus will track the mouse even when no mouse button is pressed.

ShowTaskBar = 1

Task bar is visible.

TaskBarAtTop = 0

Task bar is located at top of screen.

TaskBarAutoHide = 0

Task bar will auto hide when mouse leaves it.

TaskBarShowStartMenu = 1

Show button for the start menu on the task bar.

TaskBarShowWindowListMenu

Show button for window list menu on taskbar.

TaskBarShowWorkspaces = 1

Show workspace switcing buttons on task bar.

TaskBarShowAllWindows = 0

Show windows from all workspaces on task bar.

TaskBarShowClock = 1

Task bar clock is visible.

TaskBatClockLeds = 1

Display clock using LCD style pixmaps.

TaskBarShowMailboxStatus = 1

Display status of mailbox (determined by $MAIL environment variable).

TaskBarMailboxStatusBeepOnNewMail = 1

Beep when new mail arrives.

TaskBarMailboxStatusCountMessages = 0

Display mail message count as tooltip.

TaskBarDoubleHeight = 0

Double height task bar

TaskBarShowCPUStatus = 1

Show CPU status on task bar.

TimeFormat

format for the taskbar clock (time) (see strftime(3) manpage)

DateFormat

format for the taskbar clock tooltip (date+time) (see strftime(3) manpage).

UseMouseWheel

mouse wheel support

DelayPointerFocus

similiar to delayed auto raise.

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.

TitleBarHeight = 20

Height of the title bar.

EdgeResistance = 32

Resistance to move window with mouse outside screen limits. Setting it to 10000 makes the resistance infinite.

Timings

ClickMotionDistance = 5

Movement before click is interpreted as drag.

MultiClickTime = 400

Time (ms) to recognize for double click.

AutoRaiseDelay = 400

Time to auto raise (must enable first with AutoRaise)

AutoHideDelay = 300

Time to auto hide taskbar (must enable first with TaskBarAutoHide).

ToolTipDelay = 1000

Time before showing the tooltip.

Font settings

The following settings can be set to a string value.

Theme = "nice/default.theme"

Name of the theme to use. Themes are *.theme files located in /themes/theme/*.theme files.

TitleFontName = ""

Name of the title bar font.

MenuFontName = ""

Name of the menu font.

StatusFontName = ""

Name of the status display font.

QuickSwitchFontName = ""

Name of the font for Alt+Tab switcher window.

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.

ToolTipFontName = ""

Name of the tool tip font.

ClockFontName =""

Name of the task bar clock font.

Color settings

ColorActiveBorder

Color of the active window border.

...

...

DesktopBackgroundColor

Color of the desktop background.

DesktopBackgroundImage

Image (.xpm) for desktop background. If you want icewm to ignore the desktop background image / color set both DesktopBackgroundColor ad DesktopBackgroundImage to an empty value ("").

Path settings

LibPath

Path to the icewm/lib directory.

IconPath

Path to the icon directory. Multiple paths can be entered using the colon (UNIX) or semicolon (OS/2) as the separator.

Program settings

ClockCommand

program to run when the clock is double clicked.

MailCommand

program to run when mailbox icon is double clicked.

LockCommand

program to run to lock the screen.

RunCommand

program to run when Run is selected from the start menu.

8.2 menu

User menu configuration file.

8.3 programs

Automatically generated menu configuration file of installed programs.

8.4 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.

workspace

Default workspace for window.

layer

Default layer for the window. Layer can be one of the following strings:

Desktop

Desktop window. There should be only one window in this layer.

Below

Below default layer.

Normal

Default layer for the windows.

OnTop

Above the default.

Dock

Layer for windows docked to the edge of the screen.

AboveDock

Layer for the windows above the dock.

Menu

Layer for the windows above the dock.

You can also use the numbers from WinMgr.h.

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.

ignoreQuickSwitch=0

If set to 1, window will not be accessible using QuickSwitch feature (Alt+Tab).

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.

fRollup=1

If set to 0, window will not be shadeable.

dTitleBar=1

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

dSysMenu=1

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

dBorder=1

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

dResize=1

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

dClose=1

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

dMinimize=1

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

dMaximize=1

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

noFocusOnAppRaise

if set to 1, window will not automatically get focus as application raises it.

ignoreNoFocusHint

if set to 1, icewm will focus even if the window does not handle input.


Next Previous Contents