IceWM man pages

View on GitHub


icewm-winoptions - IceWM window options configuration file




The IceWM winoptions file contains settings to control application specific window appearance and behavior. For instance, they control the window border, placement and size, the window layer, its workspace, its visibility on the task bar and its focus behavior.

The winoptions are established when icewm(1) starts. However, they can be overridden later using icesh(1) or icewmhint(1). The command icesh winoptions instructs icewm to reload the winoptions file, while icewmhint tunes a specific application instance when it starts.


Each line in the file must be in one of the following formats:


Here NAME and CLASS are from the WM_CLASS property of the window. This can be found in the output of icesh -a getClass.

While ROLE refers to the WM_WINDOW_ROLE property of the window, which is the application instance specific name. Only a minority of windows have it. See the output of icesh -a list prop WM_WINDOW_ROLE.

In rare cases, a name, class or role may contain a period. If it does, the period should be escaped by a single backslash.

Lastly, the OPTION: VALUE pair refer to the options and values described below. A line with just a dot, followed by an option/value pair, applies to all windows.


There are four categories: general, function, decor and feature.


These control general characteristics of windows:


Function options enable/disable (1/0) the ability to take an action on the window. The normal default for all options is enabled (1) unless overridden by the application:

fClose:    {0|1}  can be closed.        (default: 1)
fHide:     {0|1}  can be hidden.        (default: 1)
fMaximize: {0|1}  can be maximized.     (default: 1)
fMinimize: {0|1}  can be minimized.     (default: 1)
fMove:     {0|1}  can be moved.         (default: 1)
fResize:   {0|1}  can be resized.       (default: 1)
fRollup:   {0|1}  can be shaded.        (default: 1)


Decor options enable/disable (1/0) decorations on the window. The normal default for all options is enabled (1) unless overridden by the application or the theme:

dBorder:   {0|1}  has border.           (default: 1)
dClose:    {0|1}  has close button.     (default: 1)
dDepth:    {0|1}  has depth button.     (default: 1)
dHide:     {0|1}  has hide button.      (default: 1)
dMaximize: {0|1}  has maximize button.  (default: 1)
dMinimize: {0|1}  has minimize button.  (default: 1)
dResize:   {0|1}  has resize grips.     (default: 1)
dRollup:   {0|1}  has shade button.     (default: 1)
dSysMenu:  {0|1}  has window menu.      (default: 1)
dTitleBar: {0|1}  has title bar.        (default: 1)


Feature options enable/disable (1/0) additional features of the window. The normal default for all options is disabled (0) unless overridden by the application:

allWorkspaces:            {1|0}  on all workspaces.
appTakesFocus:            {1|0}  let application take focus.
doNotCover:               {1|0}  limits workspace if sticky.
doNotFocus:               {1|0}  do not focus.
doNotManage:              {1|0}  do not manage.
forcedClose:              {1|0}  no close confirmation dialog.
fullKeys:                 {1|0}  don't install icewm key bindings.
ignoreNoFocusHint:        {1|0}  focus even when no-input is set.
ignorePagerPreview:       {1|0}  do not show in pager preview.
ignorePositionHint:       {1|0}  always let icewm place the window.
ignoreQuickSwitch:        {1|0}  not on quick switch.
ignoreTaskBar:            {1|0}  not on task bar.
ignoreUrgentHint:         {1|0}  ignore urgent hints.
ignoreWinList:            {1|0}  not on window list.
ignoreActivationMessages: {1|0}  only user can focus window.
ignoreOverrideRedirect:   {1|0}  ignore the override redirect flag.
noFocusOnAppRaise:        {1|0}  no automatic focus on raise.
noFocusOnMap:             {1|0}  do not focus when mapped.
noIgnoreTaskBar:          {1|0}  always show on task bar.
startClose:               {1|0}  close the window immediately.
startFullscreen:          {1|0}  start full screen.
startMaximized:           {1|0}  start maximized.
startMaximizedHorz:       {1|0}  start maximized horizontal.
startMaximizedVert:       {1|0}  start maximized vertical.
startMinimized:           {1|0}  start minimized.


This example uses the WM_WINDOW_ROLE property value pop-up to deny input focus to Chrome pop-ups and asks to close them immediately.

google-chrome.pop-up.doNotFocus: 1
google-chrome.pop-up.forcedClose: 1
google-chrome.pop-up.ignorePagerPreview: 1
google-chrome.pop-up.ignoreUrgentHint: 1
google-chrome.pop-up.layer: Below
google-chrome.pop-up.noFocusOnAppRaise: 1
google-chrome.pop-up.noFocusOnMap: 1
google-chrome.pop-up.startClose: 1
google-chrome.pop-up.startMinimized: 1

IceWM places dockapps in a container automatically, but for those that fail to comply with the protocol it can also be emulated. An emulated dockapp should appear on all workspaces, have no decorations, and always be visible in a fixed location.

wmtime.wmtime.allWorkspaces: 1
wmtime.wmtime.ignoreTaskBar: 1
wmtime.wmtime.ignoreQuickSwitch: 1
wmtime.wmtime.ignoreWinList: 1
wmtime.wmtime.layer: Below
wmtime.wmtime.dTitleBar: 0
wmtime.wmtime.dBorder: 1
wmtime.wmtime.geometry: 64x64-74-100

Following shows how a shaped output-only application is shown without titlebar and minimal functionality.

xeyes.tray: Exclusive
xeyes.ignoreWinList: 0
xeyes.ignoreTaskBar: 1
xeyes.allWorkspaces: 1
xeyes.dTitleBar: 0
xeyes.dBorder: 0
xeyes.dSysMenu: 0
xeyes.dResize: 0
xeyes.dClose: 0
xeyes.dMinimize: 0
xeyes.dMaximize: 0


Locations for the winoptions file are as follows:


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


icewm(1), icesh(1), icewmhint(1), setxkbmap(1), XParseGeometry(3).


Brian Bidulock.


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

Index IceWM