man

IceWM man pages

View on GitHub

NAME

icewm-preferences - icewm preferences configuration file

SYNOPSIS

$ICEWM_PRIVCFG/preferences
$XDG_CONFIG_HOME/icewm/preferences
$HOME/.icewm/preferences
/etc/icewm/preferences
/usr/share/icewm/preferences

DESCRIPTION

Contains general settings like paths, colors and fonts, but also options to control the icewm focus behaviour and the applets that are started in the task bar. The icewm installation will provide a default preferences file, that can be copied to the icewm user configuration directory and modified.

FORMAT

FOCUS AND BEHAVIOR

The following preferences affect focus and general behavior of icewm(1):

QUICK SWITCH

EDGE SWITCHING

TASK BAR

The following preferences affect the icewm(1) task bar:

TIMINGS

BUTTONS AND KEYS

WORKSPACES

PATHS

PROGRAMS

WINDOW MENUS

THEME SETTINGS

The following sections show settings that can be set in theme files. They can also be set in the preferences file, but themes will override the values set there. To override the theme values, the settings should be set in prefoverrides file: see icewm-prefoverrides(5). Default values are shown following the equal sign.

THEME DESCRIPTION

THEME BORDERS, ICONS, MARGINS AND BUTTONS

THEME FONTS

THEME COLORS

DESKTOP BACKGROUND

The following themeable preferences are read by icewmbg(1):

EXAMPLES

Alpha=1
Splash="IceWM.jpg"
LimitSize=0
LimitPosition=0
LimitByDockLayer=1
QuickSwitchToAllWorkspaces=1
QuickSwitchHugeIcon=1
QuickSwitchFillSelection=1
TaskBarMailboxStatusBeepOnNewMail=1
TaskBarMailboxStatusCountMessages=1
TaskBarShowMEMStatus=0
TaskBarShowCollapseButton=1
TaskBarWorkspacesLimit="8"
ShowProgramsMenu=1
ShowAddressBar=0
ToolTipDelay=200
ToolTipTime=5000
AutoHideDelay=900
AutoShowDelay=100
EdgeResistance=3
KeySysWinMenu=""
KeySysWinListMenu="Shift+Ctrl+Esc"

The above example shows how to tell icewm to not bind a specific key: KeySysWinMenu in this case.

FILES

Locations for the preferences file are as follows:

$ICEWM_PRIVCFG/preferences
$XDG_CONFIG_HOME/icewm/preferences
$HOME/.icewm/preferences
/etc/icewm/preferences
/usr/share/icewm/preferences

The locations are searched in the order listed; the first file found is read and the remainder ignored.

SEE ALSO

icewm(1), icewm-prefoverride(5).

AUTHOR

Brian Bidulock.

LICENSE

IceWM is licensed under the GNU Library General Public License. See the COPYING file in the distribution.

Index IceWM