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