Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ICEWM-WINOPTIONS(5)   Standards, Environments and Macros   ICEWM-WINOPTIONS(5)

	icewm-winoptions - IceWM window	options	configuration file


       Contains	settings to control window appearance and behaviour. These are
       specific	to applications, or to groups of applications.	Options	can
       control the window border, whether the application appears on the task
       bar, the	window list, the system	tray and the work spaces.  Also	its
       layer, geometry,	whether	it can be moved, resized and closed.

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

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


       Where the fields	are defined as follows:

	   The resource	class portion of the ICCCM WM_CLASS property for the

	   The resource	instance portion of the	ICCCM WM_CLASS property	for
	   the window.

	   The ICCCM WM_WINDOW_ROLE property for the window.

	   One of the options and values described below under "OPTIONS".

       Note that it is possible	that the WM_WINDOW_ROLE	may contain a period
       (".").  When it does, the period	should be escaped by a single
       backslash when specifying the ROLE in the file.

       The options and values described	in the format, above, consist of an
       option name, OPTION followed by a semicolon (":") a space (" ") and an
       allowable value for the option, VALUE.  The available options are as

       The following option control general characteristics of windows:

       icon: NAME (default: none)
	   Specifies the icon name for the window.  NAME is the	name of	the
	   icon, like utilities-terminal. It can also be a file, like
	   xterm.png, a	full path, or a	prefix of a path without sizes or

       workspace: WORKSPACE (default: current)
	   Specifies the default workspace for the window.  WORKSPACE is the
	   workspace number counting from zero (0).

       layer: {Desktop|Below|Normal|OnTop|Dock|AboveDock|Menu|NUMBER}
       (default: 4)
	   Specifies the default layer for the window.	Layer can be one of
	   the following strings or a number from zero (0) to fifteen (15):

	     Desktop	 (0)  Desktop window.
	     Below	 (2)  Below the	default	layer.
	     Normal	 (4)  Default layer for	windows.
	     OnTop	 (6)  Above the	default	layer.
	     Dock	 (8)  Docked windows at	edge of	screen.
	     AboveDock	(10)  Windows above the	dock.
	     Menu	(12)  Windows above the	dock.

       geometry	geometry (default: WM_SIZE_HINTS)
	   The default geometry	for the	window.	 This geometry should be
	   specified in	a format that can be parsed by XParseGeometry(3):


       tray: {Ignore|Minimized|Exclusive|NUMBER} (default: 0)
	   The default tray option for the window.  This affects both the tray
	   and the task	pane.  Tray can	be one of the following	strings	or a
	   number from zero (0)	to two (2):

	     Ignore	(0)  No	icon added to tray.
	     Minimized	(1)  Add to tray, no task when minimized.
	     Exclusive	(2)  Add to tray, no task button.

       order: NUMBER (default: 0)
	   The sorting order of	task buttons and tray icons. The default value
	   is zero. Increasing positive	values go farther right, while
	   decreasing negative values go farther left. The order option
	   applies to the task pane, the tray pane and the system tray.

       opacity:	NUMBER (default: 0)
	   Set the _NET_WM_WINDOW_OPACITY property if NUMBER is	a value
	   between 1 and 100. NUMBER is	interpreted as percentage of maximum

       keyboard: layout	(default: none)
	   Specifies the keyboard layout to use	for this window.  The layout
	   is the name of a keyboard layout.  It can be	a space-separated list
	   of arguments	to the setxkbmap program. Please note that setxkbmap
	   must	be installed for this to work. Also define a default keyboard
	   layout in preferences.

       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.  The following options are defined:

	 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.  The following options are defined:

	 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.	 The following options are defined:

	 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.
	 forcedClose:		   {1|0}  no close dialog.
	 fullKeys:		   {1|0}  provided more	keys.
	 ignoreNoFocusHint:	   {1|0}  focus	even no-input.
	 ignorePagerPreview:	   {1|0}  do not show in pager preview.
	 ignorePositionHint:	   {1|0}  place	automatically.
	 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.
	 noFocusOnAppRaise:	   {1|0}  no focus on raise.
	 noFocusOnMap:		   {1|0}  do not focus when mapped.
	 noIgnoreTaskBar:	   {1|0}  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 doesn't support dockapps, but this	can be emulated.  A dockapp
       should appear on	all workspaces,	have no	decorations, and be always
       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 is the	example	window options file that ships with icewm(1)
       and typically installs to /usr/local/share/icewm/winoptions.

	 # This	is an example for IceWM's window options file.
	 # Place your variants in /usr/local/etc/icewm or in $HOME/.icewm
	 # since modifications to this file will be discarded when you
	 # (re)install icewm.

	 xterm.icon: xterm
	 rxvt.icon: xterm
	 nxterm.icon: xterm
	 fte.icon: fte
	 emacs.Emacs.icon: emacs
	 AWTapp.icon: java
	 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
	 xeyes.ignoreNoFocusHint: 1

	 XClock.ignoreNoFocusHint: 1
	 Vim.icon: vim

	 applix.ignoreNoFocusHint: 1
	 XDdts.noFocusOnAppRaise: 1
	 Wingz.noFocusOnAppRaise: 1
	 WingzPro.noFocusOnAppRaise: 1

	 gkrellm.Gkrellm.allWorkspaces:	1
	 gkrellm.Gkrellm.ignoreTaskBar:	1
	 gkrellm.Gkrellm.layer:	Below
	 #gkrellm.Gkrellm.doNotCover: 1

	 MainWindow.licq.allWorkspaces:	1
	 MainWindow.licq.ignoreQuickSwitch: 1
	 MainWindow.licq.ignoreWinList:	1
	 MainWindow.licq.layer:	Below
	 #MainWindow.licq.doNotCover: 1

       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.

icewm 2.5.0			  2021-06-26		   ICEWM-WINOPTIONS(5)


Want to link to this manual page? Use this URL:

home | help