1ICEWM-WINOPTIONS(5) Standards, Environments and Macros ICEWM-WINOPTIONS(5)
2
6 icewm-winoptions - IceWM window options configuration file
7
9 $ICEWM_PRIVCFG/winoptions
10 $XDG_CONFIG_HOME/icewm/winoptions
11 $HOME/.icewm/winoptions
12 /etc/icewm/winoptions
13 /usr/share/icewm/winoptions
14
16 Contains settings to control window appearance and behaviour. These are
17 specific to applications, or to groups of applications. Options can
18 control the window border, whether the application appears on the task
19 bar, the window list, the system tray and the work spaces. Also its
20 layer, geometry, whether it can be moved, resized and closed.
21 Options are established when icewm(1) starts. However, they can be
23 overridden later using icesh(1) or icewmhint(1). The command "icesh
24 winoptions" instructs icewm to reload the winoptions file.
25
27 Each line in the file must be in one of the following formats:
28 NAME.CLASS.OPTION: VALUE
30 CLASS.ROLE.OPTION: VALUE
31 NAME.ROLE.OPTION: VALUE
32 CLASS.OPTION: VALUE
33 NAME.OPTION: VALUE
34 ROLE.OPTION: VALUE
35 .OPTION: VALUE
36 Where the fields are defined as follows:
38 CLASS
40 The resource class portion of the ICCCM WM_CLASS property for the
41 window.
42 NAME
44 The resource instance portion of the ICCCM WM_CLASS property for
45 the window.
46 ROLE
48 The ICCCM WM_WINDOW_ROLE property for the window.
49 OPTION: VALUE
51 One of the options and values described below under "OPTIONS".
52 Note that it is possible that the WM_WINDOW_ROLE may contain a period
54 ("."). When it does, the period should be escaped by a single
55 backslash when specifying the ROLE in the file.
56
58 The options and values described in the format, above, consist of an
59 option name, OPTION followed by a semicolon (":") a space (" ") and an
60 allowable value for the option, VALUE. The available options are as
61 follows:
62 GENERAL OPTIONS
64 The following option control general characteristics of windows:
65 icon: NAME (default: none)
67 Specifies the icon name for the window. NAME is the name of the
68 icon, like utilities-terminal. It can also be a file, like
69 xterm.png, a full path, or a prefix of a path without sizes or
70 suffix.
71 workspace: WORKSPACE (default: current)
73 Specifies the default workspace for the window. WORKSPACE is the
74 workspace number counting from zero (0).
75 layer: {Desktop|Below|Normal|OnTop|Dock|AboveDock|Menu|NUMBER}
77 (default: 4)
78 Specifies the default layer for the window. Layer can be one of
79 the following strings or a number from zero (0) to fifteen (15):
80 Desktop (0) Desktop window.
82 Below (2) Below the default layer.
83 Normal (4) Default layer for windows.
84 OnTop (6) Above the default layer.
85 Dock (8) Docked windows at edge of screen.
86 AboveDock (10) Windows above the dock.
87 Menu (12) Windows above the dock.
88 geometry geometry (default: WM_SIZE_HINTS)
90 The default geometry for the window. This geometry should be
91 specified in a format that can be parsed by XParseGeometry(3):
92 [=][<width>{xX}<height>][{+-}<xoffset>{+-}<yoffset>]
94 tray: {Ignore|Minimized|Exclusive|NUMBER} (default: 0)
96 The default tray option for the window. This affects both the tray
97 and the task pane. Tray can be one of the following strings or a
98 number from zero (0) to two (2):
99 Ignore (0) No icon added to tray.
101 Minimized (1) Add to tray, no task when minimized.
102 Exclusive (2) Add to tray, no task button.
103 order: NUMBER (default: 0)
105 The sorting order of task buttons and tray icons. The default value
106 is zero. Increasing positive values go farther right, while
107 decreasing negative values go farther left. The order option
108 applies to the task pane, the tray pane and the system tray.
109 opacity: NUMBER (default: 0)
111 Set the _NET_WM_WINDOW_OPACITY property if NUMBER is a value
112 between 1 and 100. NUMBER is interpreted as percentage of maximum
113 opaqueness.
114 keyboard: layout (default: none)
116 Specifies the keyboard layout to use for this window. The layout
117 is the name of a keyboard layout. It can be a space-separated list
118 of arguments to the setxkbmap program. Please note that setxkbmap
119 must be installed for this to work. Also define a default keyboard
120 layout in preferences.
121 FUNCTION OPTIONS
123 Function options enable/disable (1/0) the ability to take an action on
124 the window. The normal default for all options is enabled (1) unless
125 overridden by the application. The following options are defined:
126 fClose: {0|1} can be closed. (default: 1)
128 fHide: {0|1} can be hidden. (default: 1)
129 fMaximize: {0|1} can be maximized. (default: 1)
130 fMinimize: {0|1} can be minimized. (default: 1)
131 fMove: {0|1} can be moved. (default: 1)
132 fResize: {0|1} can be resized. (default: 1)
133 fRollup: {0|1} can be shaded. (default: 1)
134 DECOR OPTIONS
136 Decor options enable/disable (1/0) decorations on the window. The
137 normal default for all options is enabled (1) unless overridden by the
138 application. The following options are defined:
139 dBorder: {0|1} has border. (default: 1)
141 dClose: {0|1} has close button. (default: 1)
142 dDepth: {0|1} has depth button. (default: 1)
143 dHide: {0|1} has hide button. (default: 1)
144 dMaximize: {0|1} has maximize button. (default: 1)
145 dMinimize: {0|1} has minimize button. (default: 1)
146 dResize: {0|1} has resize grips. (default: 1)
147 dRollup: {0|1} has shade button. (default: 1)
148 dSysMenu: {0|1} has window menu. (default: 1)
149 dTitleBar: {0|1} has title bar. (default: 1)
150 FEATURE OPTIONS
152 Feature options enable/disable (1/0) additional features of the window.
153 The normal default for all options is disabled (0) unless overridden by
154 the application. The following options are defined:
155 allWorkspaces: {1|0} on all workspaces.
157 appTakesFocus: {1|0} let application take focus.
158 doNotCover: {1|0} limits workspace if sticky.
159 doNotFocus: {1|0} do not focus.
160 forcedClose: {1|0} no close dialog.
161 fullKeys: {1|0} provided more keys.
162 ignoreNoFocusHint: {1|0} focus even no-input.
163 ignorePagerPreview: {1|0} do not show in pager preview.
164 ignorePositionHint: {1|0} place automatically.
165 ignoreQuickSwitch: {1|0} not on quick switch.
166 ignoreTaskBar: {1|0} not on task bar.
167 ignoreUrgentHint: {1|0} ignore urgent hints.
168 ignoreWinList: {1|0} not on window list.
169 ignoreActivationMessages: {1|0} only user can focus window.
170 noFocusOnAppRaise: {1|0} no focus on raise.
171 noFocusOnMap: {1|0} do not focus when mapped.
172 noIgnoreTaskBar: {1|0} on task bar.
173 startClose: {1|0} close the window immediately.
174 startFullscreen: {1|0} start full screen.
175 startMaximized: {1|0} start maximized.
176 startMaximizedHorz: {1|0} start maximized horizontal.
177 startMaximizedVert: {1|0} start maximized vertical.
178 startMinimized: {1|0} start minimized.
179
181 This example uses the WM_WINDOW_ROLE property value "pop-up" to deny
182 input focus to Chrome pop-ups and asks to close them immediately.
183 google-chrome.pop-up.doNotFocus: 1
185 google-chrome.pop-up.forcedClose: 1
186 google-chrome.pop-up.ignorePagerPreview: 1
187 google-chrome.pop-up.ignoreUrgentHint: 1
188 google-chrome.pop-up.layer: Below
189 google-chrome.pop-up.noFocusOnAppRaise: 1
190 google-chrome.pop-up.noFocusOnMap: 1
191 google-chrome.pop-up.startClose: 1
192 google-chrome.pop-up.startMinimized: 1
193 IceWM doesn't support dockapps, but this can be emulated. A dockapp
195 should appear on all workspaces, have no decorations, and be always
196 visible in a fixed location.
197 wmtime.wmtime.allWorkspaces: 1
199 wmtime.wmtime.ignoreTaskBar: 1
200 wmtime.wmtime.ignoreQuickSwitch: 1
201 wmtime.wmtime.ignoreWinList: 1
202 wmtime.wmtime.layer: Below
203 wmtime.wmtime.dTitleBar: 0
204 wmtime.wmtime.dBorder: 1
205 wmtime.wmtime.geometry: 64x64-74-100
206 Following is the example window options file that ships with icewm(1)
208 and typically installs to /usr/share/icewm/winoptions.
209 # This is an example for IceWM's window options file.
211 #
212 # Place your variants in @CFGDIR@ or in $HOME/.icewm
213 # since modifications to this file will be discarded when you
214 # (re)install icewm.
215 xterm.icon: xterm
217 rxvt.icon: xterm
218 nxterm.icon: xterm
219 fte.icon: fte
220 emacs.Emacs.icon: emacs
221 AWTapp.icon: java
222 xeyes.ignoreWinList: 0
223 xeyes.ignoreTaskBar: 1
224 xeyes.allWorkspaces: 1
225 xeyes.dTitleBar: 0
226 xeyes.dBorder: 0
227 xeyes.dSysMenu: 0
228 xeyes.dResize: 0
229 xeyes.dClose: 0
230 xeyes.dMinimize: 0
231 xeyes.dMaximize: 0
232 xeyes.ignoreNoFocusHint: 1
233 XClock.ignoreNoFocusHint: 1
235 Vim.icon: vim
236 applix.ignoreNoFocusHint: 1
238 XDdts.noFocusOnAppRaise: 1
239 Wingz.noFocusOnAppRaise: 1
240 WingzPro.noFocusOnAppRaise: 1
241 gkrellm.Gkrellm.allWorkspaces: 1
243 gkrellm.Gkrellm.ignoreTaskBar: 1
244 gkrellm.Gkrellm.layer: Below
245 #gkrellm.Gkrellm.doNotCover: 1
246 MainWindow.licq.allWorkspaces: 1
248 MainWindow.licq.ignoreQuickSwitch: 1
249 MainWindow.licq.ignoreWinList: 1
250 MainWindow.licq.layer: Below
251 #MainWindow.licq.doNotCover: 1
252
254 Locations for the winoptions file are as follows:
255 $ICEWM_PRIVCFG/winoptions
257 $XDG_CONFIG_HOME/icewm/winoptions
258 $HOME/.icewm/winoptions
259 /etc/icewm/winoptions
260 /usr/share/icewm/winoptions
261 The locations are searched in the order listed; the first file found is
263 read and the remainder ignored.
264
266 icewm(1), icesh(1), icewmhint(1), setxkbmap(1), XParseGeometry(3).
267
269 Brian Bidulock <mailto:bidulock@openss7.org>.
270
272 IceWM is licensed under the GNU Library General Public License. See
273 the COPYING file in the distribution.
274icewm 2.3.4 2021-05-10 ICEWM-WINOPTIONS(5)