Debian Codegraph @

upstream/debian-unstable/man5/icewm-preferences.5

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "ICEWM-PREFERENCES 5"
58 .TH ICEWM-PREFERENCES 5 2026-01-18 "icewm\ 4.0.0" "Standards, Environments and Macros"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SS NAME
64 .IX Subsection "NAME"
65 .Vb 1
66 \& icewm\-preferences \- icewm preferences configuration file
67 .Ve
68 .SS SYNOPSIS
69 .IX Subsection "SYNOPSIS"
70 .Vb 5
71 \& $ICEWM_PRIVCFG/preferences
72 \& $XDG_CONFIG_HOME/icewm/preferences
73 \& $HOME/.icewm/preferences
74 \& /etc/X11/icewm/preferences
75 \& /usr/share/icewm/preferences
76 .Ve
77 .SS DESCRIPTION
78 .IX Subsection "DESCRIPTION"
79 Contains general settings like paths, colors and fonts, but also options
80 to control the \fBicewm\fR focus behaviour and the applets that are
81 started in the task bar. The \fBicewm\fR installation will provide a
82 default \fIpreferences\fR file, that can be copied to the \fBicewm\fR user
83 configuration directory and modified.
84 .SS FORMAT
85 .IX Subsection "FORMAT"
86 .SS "FOCUS AND BEHAVIOR"
87 .IX Subsection "FOCUS AND BEHAVIOR"
88 The following preferences affect focus and general behavior of
89 \&\fBicewm\fR\|(1):
90 .IP \fBAlpha\fR=0 4
91 .IX Item "Alpha=0"
92 Use a 32\-bit visual for alpha blending
93 .IP \fBSynchronize\fR=0 4
94 .IX Item "Synchronize=0"
95 Synchronize X11 for debugging (slow)
96 .IP \fBLogEvents\fR=0 4
97 .IX Item "LogEvents=0"
98 Enable event logging for debugging
99 .IP "\fBOutputFile\fR=""""" 4
100 .IX Item "OutputFile="""""
101 Redirect all output to \fIFILE\fR.
102 A leading tilde or environment variable is expanded.
103 This file is truncated on startup if it exceeds 5 KB.
104 .IP "\fBSplash\fR=""""" 4
105 .IX Item "Splash="""""
106 Splash image on startup (IceWM.jpg)
107 .IP "\fBTrace\fR=""""" 4
108 .IX Item "Trace="""""
109 Enable tracing for the given list of modules.
110 Modules that are traceable include \fBconf, font, icon, prog, systray\fR.
111 .IP \fBClickToFocus\fR=1 4
112 .IX Item "ClickToFocus=1"
113 Focus windows by clicking in them.
114 .IP \fBFocusOnAppRaise\fR=0 4
115 .IX Item "FocusOnAppRaise=0"
116 Focus windows when applications request that they be raised.
117 .IP \fBRequestFocusOnAppRaise\fR=1 4
118 .IX Item "RequestFocusOnAppRaise=1"
119 Request focus (flashing in taskbar) when application requests raise.
120 .IP \fBRaiseOnFocus\fR=1 4
121 .IX Item "RaiseOnFocus=1"
122 Raise windows when focused.
123 .IP \fBFocusOnClickClient\fR=1 4
124 .IX Item "FocusOnClickClient=1"
125 Focus window when client area clicked.
126 .IP \fBRaiseOnClickClient\fR=1 4
127 .IX Item "RaiseOnClickClient=1"
128 Raise window when client area clicked.
129 .IP \fBRaiseOnClickTitleBar\fR=1 4
130 .IX Item "RaiseOnClickTitleBar=1"
131 Raise window when title bar is clicked.
132 .IP \fBRaiseOnClickButton\fR=1 4
133 .IX Item "RaiseOnClickButton=1"
134 Raise window when frame button is clicked.
135 .IP \fBRaiseOnClickFrame\fR=1 4
136 .IX Item "RaiseOnClickFrame=1"
137 Raise window when frame border is clicked.
138 .IP \fBLowerOnClickWhenRaised\fR=0 4
139 .IX Item "LowerOnClickWhenRaised=0"
140 Lower the active window when clicked again.
141 .IP \fBPassFirstClickToClient\fR=1 4
142 .IX Item "PassFirstClickToClient=1"
143 Pass focusing click on client area to client.
144 .IP \fBFocusChangesWorkspace\fR=0 4
145 .IX Item "FocusChangesWorkspace=0"
146 Change to the workspace of newly focused windows.
147 .IP \fBFocusCurrentWorkspace\fR=0 4
148 .IX Item "FocusCurrentWorkspace=0"
149 Move newly focused windows to current workspace.
150 .IP \fBFocusOnMap\fR=1 4
151 .IX Item "FocusOnMap=1"
152 Focus normal window when initially mapped.
153 .IP \fBFocusOnMapTransient\fR=0 4
154 .IX Item "FocusOnMapTransient=0"
155 Focus dialog window when initially mapped.
156 .IP \fBFocusOnMapTransientActive\fR=1 4
157 .IX Item "FocusOnMapTransientActive=1"
158 Focus dialog window when initially mapped only if parent frame focused.
159 .IP \fBMapInactiveOnTop\fR=1 4
160 .IX Item "MapInactiveOnTop=1"
161 Put new windows on top even if not focusing them.
162 .IP \fBPointerColormap\fR=1 4
163 .IX Item "PointerColormap=1"
164 Colormap focus follows pointer.
165 .IP \fBDontRotateMenuPointer\fR=1 4
166 .IX Item "DontRotateMenuPointer=1"
167 Don't rotate the cursor for popup menus.
168 .IP \fBLimitSize\fR=1 4
169 .IX Item "LimitSize=1"
170 Limit size of windows to screen.
171 .IP \fBLimitPosition\fR=1 4
172 .IX Item "LimitPosition=1"
173 Limit position of windows to screen.
174 .IP \fBLimitByDockLayer\fR=0 4
175 .IX Item "LimitByDockLayer=0"
176 Let the Dock layer limit the workspace (incompatible with GNOME Panel).
177 .IP \fBConsiderHBorder\fR=0 4
178 .IX Item "ConsiderHBorder=0"
179 Consider border frames when maximizing horizontally.
180 .IP \fBConsiderVBorder\fR=0 4
181 .IX Item "ConsiderVBorder=0"
182 Consider border frames when maximizing vertically.
183 .IP \fBConsiderSizeHintsMaximized\fR=1 4
184 .IX Item "ConsiderSizeHintsMaximized=1"
185 Consider XSizeHints if frame is maximized.
186 Turning this off allows the titlebar to cover the width of the screen.
187 .IP \fBCenterMaximizedWindows\fR=0 4
188 .IX Item "CenterMaximizedWindows=0"
189 Center maximized windows that can't fit the screen (like terminals).
190 .IP \fBHideBordersMaximized\fR=0 4
191 .IX Item "HideBordersMaximized=0"
192 Hide window borders if window is maximized.
193 .IP \fBSizeMaximized\fR=0 4
194 .IX Item "SizeMaximized=0"
195 Maximized windows can be resized.
196 .IP \fBShowMoveSizeStatus\fR=1 4
197 .IX Item "ShowMoveSizeStatus=1"
198 Show position status window during move/resize.
199 .IP \fBShowWorkspaceStatus\fR=1 4
200 .IX Item "ShowWorkspaceStatus=1"
201 Show name of current workspace while switching.
202 .IP \fBMinimizeToDesktop\fR=0 4
203 .IX Item "MinimizeToDesktop=0"
204 Display mini-icons on desktop for minimized windows.
205 .IP \fBMiniIconsPlaceHorizontal\fR=0 4
206 .IX Item "MiniIconsPlaceHorizontal=0"
207 Place the mini-icons horizontal instead of vertical.
208 .IP \fBMiniIconsRightToLeft\fR=0 4
209 .IX Item "MiniIconsRightToLeft=0"
210 Place new mini-icons from right to left.
211 .IP \fBMiniIconsBottomToTop\fR=0 4
212 .IX Item "MiniIconsBottomToTop=0"
213 Place new mini-icons from bottom to top.
214 .IP \fBStrongPointerFocus\fR=0 4
215 .IX Item "StrongPointerFocus=0"
216 Always maintain focus under mouse window. Makes some keyboard support
217 non-functional or unreliable.
218 .IP \fBOpaqueMove\fR=1 4
219 .IX Item "OpaqueMove=1"
220 Opaque window move.
221 .IP \fBOpaqueResize\fR=1 4
222 .IX Item "OpaqueResize=1"
223 Opaque window resize.
224 .IP \fBManualPlacement\fR=0 4
225 .IX Item "ManualPlacement=0"
226 Windows initially placed manually by user.
227 .IP \fBSmartPlacement\fR=1 4
228 .IX Item "SmartPlacement=1"
229 Smart window placement (minimal overlap).
230 .IP \fBHideTitleBarWhenMaximized\fR=0 4
231 .IX Item "HideTitleBarWhenMaximized=0"
232 Hide title bar when maximized.
233 .IP \fBCenterLarge\fR=0 4
234 .IX Item "CenterLarge=0"
235 Center large windows.
236 .IP \fBCenterTransientsOnOwner\fR=1 4
237 .IX Item "CenterTransientsOnOwner=1"
238 Center dialogs on owner window.
239 .IP \fBMenuMouseTracking\fR=0 4
240 .IX Item "MenuMouseTracking=0"
241 Menus track mouse even with no mouse buttons held.
242 .IP \fBAutoRaise\fR=0 4
243 .IX Item "AutoRaise=0"
244 Raise windows when the mouse pointer enters, after a delay of
245 \&\fIAutoRaiseDelay\fR milliseconds. Note that \f(CW\*(C`RaiseOnFocus=1\*(C'\fR
246 may interfere.
247 .IP \fBDelayPointerFocus\fR=1 4
248 .IX Item "DelayPointerFocus=1"
249 Delay pointer focusing when mouse moves.
250 .IP \fBWin95Keys\fR=1 4
251 .IX Item "Win95Keys=1"
252 Support the Windows/Super key modifier to activate special functions.
253 The left Super key toggles the Start menu, while the right Super key
254 toggles the Window list window.
255 .IP \fBModSuperIsCtrlAlt\fR=0 4
256 .IX Item "ModSuperIsCtrlAlt=0"
257 Treat the Super/Win key modifier as a synonym for the Ctrl+Alt modifier
258 combination. The default key bindings have many occurrences of Ctrl+Alt.
259 If you enable this, then the Super modifier is an alternative way to
260 activate them.
261 .IP \fBUseMouseWheel\fR=0 4
262 .IX Item "UseMouseWheel=0"
263 Support mouse wheel. When pressing Ctrl+Alt rotating the mouse wheel
264 on the root window will cycle the focus over the windows.
265 .IP \fBTaskBarTaskGrouping\fR=0 4
266 .IX Item "TaskBarTaskGrouping=0"
267 Group applications with the same class name under a single task button.
268 0 disables it, 1 shows the number of windows, 2 shows bread crumbs,
269 3 shows a number + bread crumbs.
270 .IP \fBShowPopupsAbovePointer\fR=0 4
271 .IX Item "ShowPopupsAbovePointer=0"
272 Show popup menus above mouse pointer.
273 .IP \fBReplayMenuCancelClick\fR=0 4
274 .IX Item "ReplayMenuCancelClick=0"
275 Send the clicks outside menus to target window.
276 .IP \fBClientWindowMouseActions\fR=1 4
277 .IX Item "ClientWindowMouseActions=1"
278 Allow mouse actions on client windows. This is buggy with some programs.
279 .IP \fBGrabRootWindow\fR=1 4
280 .IX Item "GrabRootWindow=1"
281 Manage root window (EXPERIMENTAL \- normally enabled!).
282 .IP \fBSnapMove\fR=1 4
283 .IX Item "SnapMove=1"
284 Snap to nearest screen edge/window when moving windows.
285 .IP "\fBSnapDistance\fR=8 [0\-64]" 4
286 .IX Item "SnapDistance=8 [0-64]"
287 Distance in pixels before windows snap together.
288 .IP \fBArrangeWindowsOnScreenSizeChange\fR=1 4
289 .IX Item "ArrangeWindowsOnScreenSizeChange=1"
290 Automatically arrange windows when screen size changes.
291 .IP \fBAllowFullscreen\fR=1 4
292 .IX Item "AllowFullscreen=1"
293 Allow to switch a window to fullscreen.
294 .IP \fBFullscreenUseAllMonitors\fR=0 4
295 .IX Item "FullscreenUseAllMonitors=0"
296 Span over all available screens if window goes into fullscreen.
297 .IP "\fBMsgBoxDefaultAction\fR=0 [0\-1]" 4
298 .IX Item "MsgBoxDefaultAction=0 [0-1]"
299 Preselect to Cancel (0) or the OK (1) button in message boxes.
300 .IP "\fBNetWorkAreaBehaviour\fR=0 [0\-2]" 4
301 .IX Item "NetWorkAreaBehaviour=0 [0-2]"
302 NET_WORKAREA behaviour: 0 (single/multi\-monitor with STRUT information,
303 like metacity), 1 (always full desktop), 2 (single monitor with STRUT,
304 multi-monitor without STRUT).
305 .SS "QUICK SWITCH"
306 .IX Subsection "QUICK SWITCH"
307 .IP \fBQuickSwitch\fR=1 4
308 .IX Item "QuickSwitch=1"
309 Enable Alt+Tab window switching.
310 .IP \fBQuickSwitchToMinimized\fR=1 4
311 .IX Item "QuickSwitchToMinimized=1"
312 Enable Alt+Tab to minimized windows.
313 .IP \fBQuickSwitchToHidden\fR=1 4
314 .IX Item "QuickSwitchToHidden=1"
315 Enable Alt+Tab to hidden windows.
316 .IP \fBQuickSwitchToUrgent\fR=1 4
317 .IX Item "QuickSwitchToUrgent=1"
318 Prioritize Alt+Tab to urgent windows.
319 .IP \fBQuickSwitchToAllWorkspaces\fR=0 4
320 .IX Item "QuickSwitchToAllWorkspaces=0"
321 Include windows from all workspaces in Alt+Tab.
322 .IP \fBQuickSwitchGroupWorkspaces\fR=1 4
323 .IX Item "QuickSwitchGroupWorkspaces=1"
324 Group windows by workspace together in Alt+Tab.
325 .IP \fBQuickSwitchPersistence\fR=0 4
326 .IX Item "QuickSwitchPersistence=0"
327 Time in seconds to remember the state of Alt+Tab.
328 .IP \fBQuickSwitchPreview\fR=0 4
329 .IX Item "QuickSwitchPreview=0"
330 Use a QuickSwitch that shows previews of applications.
331 .IP \fBQuickSwitchRaiseCandidate\fR=0 4
332 .IX Item "QuickSwitchRaiseCandidate=0"
333 Raise a selected window while Alt+Tabbing in the QuickSwitch.
334 .IP \fBQuickSwitchAllIcons\fR=1 4
335 .IX Item "QuickSwitchAllIcons=1"
336 Show all reachable icons when quick switching.
337 .IP \fBQuickSwitchTextFirst\fR=0 4
338 .IX Item "QuickSwitchTextFirst=0"
339 Show the window title above (all reachable) icons.
340 .IP \fBQuickSwitchSmallWindow\fR=0 4
341 .IX Item "QuickSwitchSmallWindow=0"
342 Create a smaller QuickSwitch window of 1/3 screen width.
343 .IP \fBQuickSwitchVertical\fR=1 4
344 .IX Item "QuickSwitchVertical=1"
345 Place the icons and titles vertical instead of horizontal.
346 .IP \fBQuickSwitchHugeIcon\fR=0 4
347 .IX Item "QuickSwitchHugeIcon=0"
348 Show the huge (48x48) of the window icon for the active window.
349 .IP \fBQuickSwitchFillSelection\fR=0 4
350 .IX Item "QuickSwitchFillSelection=0"
351 Fill the rectangle highlighting the current icon.
352 .SS "EDGE SWITCHING"
353 .IX Subsection "EDGE SWITCHING"
354 .IP \fBEdgeSwitch\fR=0 4
355 .IX Item "EdgeSwitch=0"
356 Workspace switches by moving mouse to left/right screen edge.
357 .IP \fBHorizontalEdgeSwitch\fR=0 4
358 .IX Item "HorizontalEdgeSwitch=0"
359 Workspace switches by moving mouse to left/right screen edge.
360 .IP \fBVerticalEdgeSwitch\fR=0 4
361 .IX Item "VerticalEdgeSwitch=0"
362 Workspace switches by moving mouse to top/bottom screen edge.
363 .IP \fBContinuousEdgeSwitch\fR=1 4
364 .IX Item "ContinuousEdgeSwitch=1"
365 Workspace switches continuously when moving mouse to screen edge.
366 .IP "\fBEdgeResistance\fR=32 [0\-10000]" 4
367 .IX Item "EdgeResistance=32 [0-10000]"
368 Resistance in pixels when trying to move windows off the screen (10000 =
369 infinite).
370 .SS "TASK BAR"
371 .IX Subsection "TASK BAR"
372 The following preferences affect the \fBicewm\fR\|(1) task bar:
373 .IP \fBShowTaskBar\fR=1 4
374 .IX Item "ShowTaskBar=1"
375 Show task bar.
376 .IP \fBTaskBarAtTop\fR=0 4
377 .IX Item "TaskBarAtTop=0"
378 Task bar at top of the screen.
379 .IP \fBTaskBarKeepBelow\fR=0 4
380 .IX Item "TaskBarKeepBelow=0"
381 Keep the task bar below regular windows.
382 .IP \fBTaskBarAutoHide\fR=0 4
383 .IX Item "TaskBarAutoHide=0"
384 Auto hide task bar after delay.
385 .IP \fBTaskBarFullscreenAutoShow\fR=1 4
386 .IX Item "TaskBarFullscreenAutoShow=1"
387 Auto show task bar when fullscreen window active.
388 .IP \fBTaskBarShowClock\fR=1 4
389 .IX Item "TaskBarShowClock=1"
390 Show clock on task bar.
391 .IP \fBTaskBarShowAPMStatus\fR=0 4
392 .IX Item "TaskBarShowAPMStatus=0"
393 Show battery status monitor on task bar.
394 .IP \fBTaskBarShowAPMAuto\fR=1 4
395 .IX Item "TaskBarShowAPMAuto=1"
396 Enable TaskBarShowAPMStatus if a battery is present.
397 .IP \fBTaskBarShowAPMTime\fR=1 4
398 .IX Item "TaskBarShowAPMTime=1"
399 Show battery status on task bar in time-format
400 .IP \fBTaskBarShowAPMGraph\fR=1 4
401 .IX Item "TaskBarShowAPMGraph=1"
402 Show battery status in graph mode.
403 .IP \fBTaskBarShowMailboxStatus\fR=1 4
404 .IX Item "TaskBarShowMailboxStatus=1"
405 Show mailbox status on task bar.
406 .IP \fBTaskBarMailboxStatusBeepOnNewMail\fR=0 4
407 .IX Item "TaskBarMailboxStatusBeepOnNewMail=0"
408 Beep when new mail arrives.
409 .IP \fBTaskBarMailboxStatusCountMessages\fR=0 4
410 .IX Item "TaskBarMailboxStatusCountMessages=0"
411 Count messages in mailbox.
412 .IP \fBTaskBarShowWorkspaces\fR=1 4
413 .IX Item "TaskBarShowWorkspaces=1"
414 Show workspace switching buttons on task bar.
415 .IP \fBTaskBarShowWindows\fR=1 4
416 .IX Item "TaskBarShowWindows=1"
417 Show windows on the taskbar.
418 .IP \fBTaskBarShowShowDesktopButton\fR=1 4
419 .IX Item "TaskBarShowShowDesktopButton=1"
420 Show 'show desktop' button on taskbar. If set to 2, it will move the icon to the right side, after the clock.
421 .IP \fBShowEllipsis\fR=1 4
422 .IX Item "ShowEllipsis=1"
423 Show Ellipsis in taskbar items.
424 .IP \fBTaskBarShowTray\fR=1 4
425 .IX Item "TaskBarShowTray=1"
426 Show windows in the tray.
427 .IP \fBTaskBarEnableSystemTray\fR=1 4
428 .IX Item "TaskBarEnableSystemTray=1"
429 Enable the system tray in the taskbar.
430 .IP \fBTrayShowAllWindows\fR=1 4
431 .IX Item "TrayShowAllWindows=1"
432 Show windows from all workspaces on tray.
433 .IP \fBTaskBarShowTransientWindows\fR=1 4
434 .IX Item "TaskBarShowTransientWindows=1"
435 Show transient (dialogs, ...) windows on task bar.
436 .IP \fBTaskBarShowAllWindows\fR=0 4
437 .IX Item "TaskBarShowAllWindows=0"
438 Show windows from all workspaces on task bar.
439 .IP \fBTaskBarShowWindowIcons\fR=1 4
440 .IX Item "TaskBarShowWindowIcons=1"
441 Show icons of windows on task buttons of the task bar.
442 .IP \fBTaskBarShowWindowTitles\fR=1 4
443 .IX Item "TaskBarShowWindowTitles=1"
444 Show titles of windows on task buttons of the task bar.
445 .IP \fBTaskBarShowStartMenu\fR=1 4
446 .IX Item "TaskBarShowStartMenu=1"
447 Show 'Start' menu on task bar.
448 .IP \fBTaskBarShowWindowListMenu\fR=1 4
449 .IX Item "TaskBarShowWindowListMenu=1"
450 Show 'window list' menu on task bar.
451 .IP \fBTaskBarShowCPUStatus\fR=1 4
452 .IX Item "TaskBarShowCPUStatus=1"
453 Show CPU status on task bar (Linux & Solaris).
454 .IP \fBCPUStatusShowRamUsage\fR=1 4
455 .IX Item "CPUStatusShowRamUsage=1"
456 Show RAM usage in CPU status tool tip.
457 .IP \fBCPUStatusShowSwapUsage\fR=1 4
458 .IX Item "CPUStatusShowSwapUsage=1"
459 Show swap usage in CPU status tool tip.
460 .IP \fBCPUStatusShowAcpiTemp\fR=1 4
461 .IX Item "CPUStatusShowAcpiTemp=1"
462 Show ACPI temperature in CPU status tool tip.
463 .IP \fBCPUStatusShowAcpiTempInGraph\fR=0 4
464 .IX Item "CPUStatusShowAcpiTempInGraph=0"
465 Show ACPI temperature in CPU status bar.
466 .IP \fBCPUStatusShowCpuFreq\fR=1 4
467 .IX Item "CPUStatusShowCpuFreq=1"
468 Show CPU frequency in CPU status tool tip.
469 .IP \fBNetStatusShowOnlyRunning\fR=0 4
470 .IX Item "NetStatusShowOnlyRunning=0"
471 Show network status only for connected devices, such as an active Ethernet link
472 or associated wireless interface. If false, any network interface that has been
473 brought up will be displayed.
474 .IP \fBTaskBarShowMEMStatus\fR=1 4
475 .IX Item "TaskBarShowMEMStatus=1"
476 Show memory usage status on task bar (Linux only).
477 .IP \fBTaskBarShowNetStatus\fR=1 4
478 .IX Item "TaskBarShowNetStatus=1"
479 Show network status on task bar (Linux only).
480 .IP \fBTaskBarShowCollapseButton\fR=0 4
481 .IX Item "TaskBarShowCollapseButton=0"
482 Show a button to collapse the taskbar.
483 .IP \fBTaskBarDoubleHeight\fR=0 4
484 .IX Item "TaskBarDoubleHeight=0"
485 Use double-height task bar.
486 .IP \fBTaskBarWorkspacesLeft\fR=1 4
487 .IX Item "TaskBarWorkspacesLeft=1"
488 Place workspace pager on left, not right.
489 .IP \fBTaskBarWorkspacesTop\fR=0 4
490 .IX Item "TaskBarWorkspacesTop=0"
491 Place workspace pager on top row when using dual-height taskbar.
492 .IP "\fBTaskBarWorkspacesLimit\fR=""""" 4
493 .IX Item "TaskBarWorkspacesLimit="""""
494 Limit the number of taskbar workspaces buttons that are shown on the
495 workspaces pane of the taskbar. If the numeric value has a \f(CW\*(C`p\*(C'\fR suffix
496 then the limitation is in pixels. A \f(CW\*(C`%\*(C'\fR suffix limits by percentage of
497 desktop width. By default a \f(CW\*(C`B\*(C'\fR suffix is assumed for number of buttons.
498 .IP \fBTaskBarUseMouseWheel\fR=1 4
499 .IX Item "TaskBarUseMouseWheel=1"
500 Enable mouse wheel cycling over workspaces and task buttons in taskbar.
501 .IP \fBPagerShowPreview\fR=1 4
502 .IX Item "PagerShowPreview=1"
503 Show a mini desktop preview on each workspace button.
504 .IP \fBPagerShowWindowIcons\fR=1 4
505 .IX Item "PagerShowWindowIcons=1"
506 Draw window icons inside large enough preview windows on pager (if PagerShowPreview=1).
507 .IP \fBPagerShowMinimized\fR=1 4
508 .IX Item "PagerShowMinimized=1"
509 Draw even minimized windows as unfilled rectangles (if PagerShowPreview=1).
510 .IP \fBPagerShowBorders\fR=1 4
511 .IX Item "PagerShowBorders=1"
512 Draw border around workspace buttons (if PagerShowPreview=1).
513 .IP \fBPagerShowLabels\fR=1 4
514 .IX Item "PagerShowLabels=1"
515 Show workspace name label on workspace button (if PagerShowPreview=1)
516 .IP \fBPagerShowNumbers\fR=1 4
517 .IX Item "PagerShowNumbers=1"
518 Show number of workspace on workspace button (if PagerShowPreview=1).
519 .IP \fBTaskBarLaunchOnSingleClick\fR=1 4
520 .IX Item "TaskBarLaunchOnSingleClick=1"
521 Execute taskbar applet commands (like MailCommand, ClockCommand, ...) on single click.
522 .IP \fBEnableAddressBar\fR=1 4
523 .IX Item "EnableAddressBar=1"
524 Enable address bar functionality in taskbar.
525 .IP \fBShowAddressBar\fR=1 4
526 .IX Item "ShowAddressBar=1"
527 Show address bar in task bar.
528 .IP \fBMultiByte\fR=1 4
529 .IX Item "MultiByte=1"
530 Overrides automatic multiple byte detection.
531 .IP \fBConfirmLogout\fR=1 4
532 .IX Item "ConfirmLogout=1"
533 Confirm logout.
534 .IP \fBShapesProtectClientWindow\fR=1 4
535 .IX Item "ShapesProtectClientWindow=1"
536 Don't cut client windows by shapes set trough frame corner pixmap.
537 .IP \fBXRRDisable\fR=1 4
538 .IX Item "XRRDisable=1"
539 Disable use of new XRANDR API for dual head (nvidia workaround).
540 .IP \fBPreferFreetypeFonts\fR=1 4
541 .IX Item "PreferFreetypeFonts=1"
542 Favour Xft fonts over core X11 fonts where possible.
543 .IP "\fBMailBoxPath\fR=""""" 4
544 .IX Item "MailBoxPath="""""
545 A list of paths of your mailboxes separated by spaces.
546 If this is empty, \f(CW$MAILPATH\fR or \f(CW$MAIL\fR is used instead.
547 .Sp
548 Path to a mbox file. Remote mail boxes are accessed by specifying an URL
549 using the Common Internet Scheme Syntax (RFC 1738):
550 .Sp
551 .Vb 1
552 \& \`scheme://[user[:password]@]server[:port][/path]\`.
553 .Ve
554 .Sp
555 Supported schemes are \f(CW\*(C`pop3\*(C'\fR, \f(CW\*(C`imap\*(C'\fR and \f(CW\*(C`file\*(C'\fR. When the scheme is
556 omitted \fIfile://\fR is prepended silently. IMAP subfolders can be
557 accessed by using the path component. Reserved characters like
558 \&\fIslash\fR (\f(CW\*(C`/\*(C'\fR), \fIat\fR (\f(CW\*(C`@\*(C'\fR) and \fIcolon\fR (\f(CW\*(C`:\*(C'\fR) can be specified using
559 escape sequences with a hexadecimal encoding like \f(CW%2f\fR for the slash
560 or \f(CW%40\fR for the at sign. For example:
561 .Sp
562 .Vb 3
563 \& file:///var/spool/mail/captnmark
564 \& pop3://markus:%2f%40%[email protected]/
565 \& imap://mathias@localhost/INBOX.Maillisten.icewm\-user
566 .Ve
567 .IP "\fBNetworkStatusDevice\fR=""eth0 wlan0""" 4
568 .IX Item "NetworkStatusDevice=""eth0 wlan0"""
569 Network devices for which to show status.
570 .IP "\fBTimeFormat\fR=""%X""" 4
571 .IX Item "TimeFormat=""%X"""
572 The clock time format. See the strftime manpage for the meaning of all
573 the percent options. It is possible to define multiple clocks for
574 different time zones in a single \fITimeFormat\fR. A new clock is defined
575 by the beginning of the string, and by each time zone specification
576 that starts with \f(CW\*(C`TZ=...\*(C'\fR, followed by a space. For example,
577 \&\fBTimeFormat\fR=\f(CW\*(C`%X TZ=Asia/Aden %T TZ=Asia/Baku %T\*(C'\fR defines 3 clocks.
578 .IP "\fBTimeFormatAlt\fR=""""" 4
579 .IX Item "TimeFormatAlt="""""
580 Alternate Clock Time format shown every other second.
581 .IP "\fBDateFormat\fR=""%c""" 4
582 .IX Item "DateFormat=""%c"""
583 Clock Date format for tooltip (strftime format string).
584 .IP "\fBDockApps\fR=""right high desktop""" 4
585 .IX Item "DockApps=""right high desktop"""
586 Support DockApps (right, left, center, down, high, above, dock, ontop,
587 normal, below, desktop, or empty to disable). The first five control
588 positioning, while the next six set the layer. Control with Ctrl+Mouse.
589 .IP "\fBXRRPrimaryScreenName\fR=""""" 4
590 .IX Item "XRRPrimaryScreenName="""""
591 Screen/output name of the primary screen.
592 .IP "\fBAcpiIgnoreBatteries\fR=""""" 4
593 .IX Item "AcpiIgnoreBatteries="""""
594 List of battery names (directories) in /proc/acpi/battery to ignore.
595 Useful when more slots are built-in, but only one battery is used.
596 .IP "\fBTaskBarCPUSamples\fR=20 [2\-1000]" 4
597 .IX Item "TaskBarCPUSamples=20 [2-1000]"
598 The width of the CPU Monitor applet in pixels.
599 .IP "\fBTaskBarMEMSamples\fR=20 [2\-1000]" 4
600 .IX Item "TaskBarMEMSamples=20 [2-1000]"
601 The width of the Memory Monitor applet in pixels.
602 .IP "\fBTaskBarNetSamples\fR=20 [2\-1000]" 4
603 .IX Item "TaskBarNetSamples=20 [2-1000]"
604 The width of the Net Monitor applet in pixels.
605 .IP "\fBTaskbarButtonWidthDivisor\fR=3 [1\-25]" 4
606 .IX Item "TaskbarButtonWidthDivisor=3 [1-25]"
607 Default number of tasks in taskbar.
608 .IP "\fBTaskBarWidthPercentage\fR=100 [0\-100]" 4
609 .IX Item "TaskBarWidthPercentage=100 [0-100]"
610 Task bar width as percentage of the screen width.
611 .IP "\fBTaskBarJustify\fR=""left""" 4
612 .IX Item "TaskBarJustify=""left"""
613 Taskbar justify left, right or center.
614 .IP "\fBTaskBarApmGraphWidth\fR=10 [1\-1000]" 4
615 .IX Item "TaskBarApmGraphWidth=10 [1-1000]"
616 Width of battery Monitor.
617 .IP "\fBXineramaPrimaryScreen\fR=0 [0\-63]" 4
618 .IX Item "XineramaPrimaryScreen=0 [0-63]"
619 Primary screen for xinerama (taskbar, ...).
620 .IP "\fBKeyboardLayouts\fR=""""" 4
621 .IX Item "KeyboardLayouts="""""
622 A comma-separated list of keyboard layouts.
623 A layout may be enclosed in double quotes.
624 Each layout is a name with optional arguments,
625 that is to be parsed by the \f(CW\*(C`setxkbmap\*(C'\fR program.
626 To support changing keyboard layouts, the
627 \&\f(CW\*(C`setxkbmap\*(C'\fR program must be installed.
628 The first in the list is the default layout.
629 Programs may have their own keyboard layout
630 defined in the \fIwinoptions\fR file.
631 The first two letters of a layout are used
632 to locate an icon image file.
633 .SS MENUS
634 .IX Subsection "MENUS"
635 .IP \fBAutoReloadMenus\fR=1 4
636 .IX Item "AutoReloadMenus=1"
637 Reload menu files automatically.
638 .IP \fBShowProgramsMenu\fR=0 4
639 .IX Item "ShowProgramsMenu=0"
640 Show programs submenu.
641 .IP \fBShowSettingsMenu\fR=1 4
642 .IX Item "ShowSettingsMenu=1"
643 Show settings submenu.
644 .IP \fBShowFocusModeMenu\fR=1 4
645 .IX Item "ShowFocusModeMenu=1"
646 Show focus mode submenu.
647 .IP \fBShowThemesMenu\fR=1 4
648 .IX Item "ShowThemesMenu=1"
649 Show themes submenu.
650 .IP \fBShowLogoutMenu\fR=1 4
651 .IX Item "ShowLogoutMenu=1"
652 Show logout menu.
653 .IP \fBShowHelp\fR=1 4
654 .IX Item "ShowHelp=1"
655 Show the help menu item.
656 .IP \fBShowLogoutSubMenu\fR=1 4
657 .IX Item "ShowLogoutSubMenu=1"
658 Show logout submenu.
659 .IP \fBShowAbout\fR=1 4
660 .IX Item "ShowAbout=1"
661 Show the about menu item.
662 .IP \fBShowRun\fR=1 4
663 .IX Item "ShowRun=1"
664 Show the run menu item.
665 .IP \fBShowWindowList\fR=1 4
666 .IX Item "ShowWindowList=1"
667 Show the window menu item.
668 .IP "\fBMenuMaximalWidth\fR=0 [0\-16384]" 4
669 .IX Item "MenuMaximalWidth=0 [0-16384]"
670 Maximal width of popup menus, 2/3 of the screen's width if set to zero.
671 .IP "\fBNestedThemeMenuMinNumber\fR=25 [0\-1234]" 4
672 .IX Item "NestedThemeMenuMinNumber=25 [0-1234]"
673 Minimal number of themes after which the Themes menu becomes nested (0=disabled).
674 .SS TIMINGS
675 .IX Subsection "TIMINGS"
676 .IP "\fBDelayFuzziness\fR=10 (0\-100)" 4
677 .IX Item "DelayFuzziness=10 (0-100)"
678 Delay fuzziness, to allow merging of multiple timer timeouts into one
679 (notebook power saving).
680 .IP "\fBClickMotionDistance\fR=4 [0\-32]" 4
681 .IX Item "ClickMotionDistance=4 [0-32]"
682 Pointer motion distance before click gets interpreted as drag.
683 .IP "\fBClickMotionDelay\fR=200 [0\-2000]" 4
684 .IX Item "ClickMotionDelay=200 [0-2000]"
685 Delay before click gets interpreted as drag.
686 .IP "\fBMultiClickTime\fR=400 [0\-5000]" 4
687 .IX Item "MultiClickTime=400 [0-5000]"
688 Multiple click time.
689 .IP "\fBMenuActivateDelay\fR=40 [0\-5000]" 4
690 .IX Item "MenuActivateDelay=40 [0-5000]"
691 Delay before activating menu items.
692 .IP "\fBSubmenuMenuActivateDelay\fR=300 [0\-5000]" 4
693 .IX Item "SubmenuMenuActivateDelay=300 [0-5000]"
694 Delay before activating menu submenus.
695 .IP \fBToolTipIcon\fR=1 4
696 .IX Item "ToolTipIcon=1"
697 Show an application icon in toolbar and tray tooltips.
698 .IP "\fBToolTipDelay\fR=1000 [0\-5000]" 4
699 .IX Item "ToolTipDelay=1000 [0-5000]"
700 Delay before tooltip window is displayed.
701 .IP "\fBToolTipTime\fR=0 [0\-60000]" 4
702 .IX Item "ToolTipTime=0 [0-60000]"
703 Time before tooltip window is hidden (0 means never).
704 .IP "\fBAutoHideDelay\fR=300 [0\-5000]" 4
705 .IX Item "AutoHideDelay=300 [0-5000]"
706 Delay before task bar is hidden.
707 .IP "\fBAutoShowDelay\fR=500 [0\-5000]" 4
708 .IX Item "AutoShowDelay=500 [0-5000]"
709 Delay before task bar is shown.
710 .IP "\fBAutoRaiseDelay\fR=400 [0\-5000]" 4
711 .IX Item "AutoRaiseDelay=400 [0-5000]"
712 Delay before windows are auto raised if \f(CW\*(C`AutoRaise=1\*(C'\fR.
713 .IP "\fBPointerFocusDelay\fR=200 [0\-1000]" 4
714 .IX Item "PointerFocusDelay=200 [0-1000]"
715 Delay for pointer focus switching.
716 .IP "\fBEdgeSwitchDelay\fR=600 [0\-5000]" 4
717 .IX Item "EdgeSwitchDelay=600 [0-5000]"
718 Screen edge workspace switching delay.
719 .IP "\fBScrollBarStartDelay\fR=500 [0\-5000]" 4
720 .IX Item "ScrollBarStartDelay=500 [0-5000]"
721 Initial scroll bar autoscroll delay.
722 .IP "\fBScrollBarDelay\fR=30 [0\-5000]" 4
723 .IX Item "ScrollBarDelay=30 [0-5000]"
724 Scroll bar autoscroll delay.
725 .IP "\fBAutoScrollStartDelay\fR=500 [0\-5000]" 4
726 .IX Item "AutoScrollStartDelay=500 [0-5000]"
727 Auto scroll start delay.
728 .IP "\fBAutoScrollDelay\fR=60 [0\-5000]" 4
729 .IX Item "AutoScrollDelay=60 [0-5000]"
730 Auto scroll delay.
731 .IP "\fBWorkspaceStatusTime\fR=2500 [0\-2500]" 4
732 .IX Item "WorkspaceStatusTime=2500 [0-2500]"
733 Time before workspace status window is hidden.
734 .IP "\fBMailCheckDelay\fR=30 [0\-86400]" 4
735 .IX Item "MailCheckDelay=30 [0-86400]"
736 Delay between new-mail checks. (seconds).
737 .IP "\fBTaskBarCPUDelay\fR=500 [10\-3600000]" 4
738 .IX Item "TaskBarCPUDelay=500 [10-3600000]"
739 Delay between CPU Monitor samples in ms.
740 .IP "\fBTaskBarMEMDelay\fR=500 [10\-3600000]" 4
741 .IX Item "TaskBarMEMDelay=500 [10-3600000]"
742 Delay between Memory Monitor samples in ms.
743 .IP "\fBTaskBarNetDelay\fR=500 [10\-3600000]" 4
744 .IX Item "TaskBarNetDelay=500 [10-3600000]"
745 Delay between Net Monitor samples in ms.
746 .IP "\fBFocusRequestFlashTime\fR=0 [0\-86400]" 4
747 .IX Item "FocusRequestFlashTime=0 [0-86400]"
748 Number of seconds the taskbar app will blink when requesting focus (0 = forever).
749 .IP "\fBFocusRequestFlashInterval\fR=250 [0\-30000]" 4
750 .IX Item "FocusRequestFlashInterval=250 [0-30000]"
751 Taskbar blink interval (ms) when requesting focus (0 = blinking disabled).
752 .IP "\fBBatteryPollingPeriod\fR=10 [2\-3600]" 4
753 .IX Item "BatteryPollingPeriod=10 [2-3600]"
754 Delay between power status updates (seconds).
755 .IP "\fBPingTimeout\fR=3 [0\-86400]" 4
756 .IX Item "PingTimeout=3 [0-86400]"
757 Timeout in seconds for applications to respond to the _NET_WM_PING protocol.
758 .SS "BUTTONS AND KEYS"
759 .IX Subsection "BUTTONS AND KEYS"
760 .IP "\fBUseRootButtons\fR=255 [0\-255]" 4
761 .IX Item "UseRootButtons=255 [0-255]"
762 Bitmask of root window button click to use in window manager.
763 .IP "\fBButtonRaiseMask\fR=1 [0\-255]" 4
764 .IX Item "ButtonRaiseMask=1 [0-255]"
765 Bitmask of buttons that raise the window when pressed.
766 .IP "\fBDesktopWinMenuButton\fR=0 [0\-20]" 4
767 .IX Item "DesktopWinMenuButton=0 [0-20]"
768 Desktop mouse-button click to show the window list menu.
769 .IP "\fBDesktopWinListButton\fR=2 # [0\-20]" 4
770 .IX Item "DesktopWinListButton=2 # [0-20]"
771 Desktop mouse-button click to show the window list
772 .IP "\fBDesktopMenuButton\fR=3 [0\-20]" 4
773 .IX Item "DesktopMenuButton=3 [0-20]"
774 Desktop mouse-button click to show the root menu.
775 .IP "\fBTitleBarMaximizeButton\fR=1 [0\-5]" 4
776 .IX Item "TitleBarMaximizeButton=1 [0-5]"
777 Title bar mouse-button double-click to maximize the window to full
778 screen with the frame border visible.
779 Press Shift to maximize only in the vertical direction.
780 Press Alt+Shift to maximize only in the horizontal direction.
781 .IP "\fBTitleBarRollupButton\fR=2 [0\-5]" 4
782 .IX Item "TitleBarRollupButton=2 [0-5]"
783 Title bar mouse-button double-click to rollup the window.
784 Press Shift to maximize in the horizontal direction.
785 .SS WORKSPACES
786 .IX Subsection "WORKSPACES"
787 .IP "\fBWorkspaceNames\fR="" 1 "", "" 2 "", "" 3 "", "" 4 """ 4
788 .IX Item "WorkspaceNames="" 1 "", "" 2 "", "" 3 "", "" 4 """
789 Create four workspaces with names \f(CW 1 \fR, \f(CW 2 \fR, \f(CW 3 \fR and \f(CW 4 \fR.
790 .SS PATHS
791 .IX Subsection "PATHS"
792 .IP "\fBIconPath\fR=""/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps""" 4
793 .IX Item "IconPath=""/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps"""
794 Icon search path (colon separated). Also, the icons/ subdirectory in
795 IceWM resource folders are searched first.
796 .IP "\fBIconThemes\fR=""*:\-HighContrast""" 4
797 .IX Item "IconThemes=""*:-HighContrast"""
798 List of icon themes (colon separated), acting as additional filter of
799 icon subdirectories in any of the \fBIconPath\fR folders. Expressions can be
800 wildcards, also special wildcards (starting with \fB\-\fR) can exclude matched
801 themes from selection.
802 .IP "\fBMailBoxPath\fR=""""" 4
803 .IX Item "MailBoxPath="""""
804 A colon separated list of paths of your mailboxes.
805 If this is empty, \f(CW$MAILPATH\fR or \f(CW$MAIL\fR is used instead.
806 .SS PROGRAMS
807 .IX Subsection "PROGRAMS"
808 .IP "\fBMailCommand\fR=""xterm \-name mutt \-e mutt""" 4
809 .IX Item "MailCommand=""xterm -name mutt -e mutt"""
810 Command to run on mailbox.
811 .IP "\fBMailClassHint\fR=""mutt.XTerm""" 4
812 .IX Item "MailClassHint=""mutt.XTerm"""
813 \&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBMailCommand\fR.
814 .IP "\fBNewMailCommand\fR=""""" 4
815 .IX Item "NewMailCommand="""""
816 Command to run when new mail arrives.
817 .IP "\fBLockCommand\fR=""""" 4
818 .IX Item "LockCommand="""""
819 Command to lock display/screensaver.
820 .IP "\fBClockCommand\fR=""xclock \-name icewm \-title Clock""" 4
821 .IX Item "ClockCommand=""xclock -name icewm -title Clock"""
822 Command to run on clock.
823 .IP "\fBClockClassHint\fR=""icewm.XClock""" 4
824 .IX Item "ClockClassHint=""icewm.XClock"""
825 \&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBClockCommand\fR.
826 .IP "\fBRunCommand\fR=""""" 4
827 .IX Item "RunCommand="""""
828 Command to select and run a program.
829 .IP "\fBOpenCommand\fR=""""" 4
830 .IX Item "OpenCommand="""""
831 Command to open a file or directory from the Start menu.
832 .IP "\fBTerminalCommand\fR=""xterm""" 4
833 .IX Item "TerminalCommand=""xterm"""
834 Terminal emulator must accept \-e option.
835 .IP "\fBLogoutCommand\fR=""""" 4
836 .IX Item "LogoutCommand="""""
837 Command to start logout.
838 .IP "\fBLogoutCancelCommand\fR=""""" 4
839 .IX Item "LogoutCancelCommand="""""
840 Command to cancel logout.
841 .IP "\fBShutdownCommand\fR=""/bin/sh \-c ""{ test \-e /run/systemd/system && systemctl poweroff || loginctl poweroff; }""""" 4
842 .IX Item "ShutdownCommand=""/bin/sh -c ""{ test -e /run/systemd/system && systemctl poweroff || loginctl poweroff; }"""""
843 Command to shutdown the system.
844 .IP "\fBRebootCommand\fR=""/bin/sh \-c ""{ test \-e /run/systemd/system && systemctl reboot || loginctl reboot; }""""" 4
845 .IX Item "RebootCommand=""/bin/sh -c ""{ test -e /run/systemd/system && systemctl reboot || loginctl reboot; }"""""
846 Command to reboot the system.
847 .IP "\fBSuspendCommand\fR=""test \-e /run/systemd/system && systemctl suspend || loginctl suspend""" 4
848 .IX Item "SuspendCommand=""test -e /run/systemd/system && systemctl suspend || loginctl suspend"""
849 Command to send the system to standby mode
850 .IP "\fBSuspendCommand\fR=""test \-e /run/systemd/system && systemctl hibernate || loginctl hibernate""" 4
851 .IX Item "SuspendCommand=""test -e /run/systemd/system && systemctl hibernate || loginctl hibernate"""
852 Command to hibernate the system.
853 .IP "\fBCPUStatusCommand\fR=""xterm \-name top \-title Process\e Status \-e top""" 4
854 .IX Item "CPUStatusCommand=""xterm -name top -title Process Status -e top"""
855 Command to run on CPU status.
856 .IP "\fBCPUStatusClassHint\fR=""top.XTerm""" 4
857 .IX Item "CPUStatusClassHint=""top.XTerm"""
858 \&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBCPUStatusCommand\fR.
859 .IP "\fBCPUStatusCombine\fR=1 0/1" 4
860 .IX Item "CPUStatusCombine=1 0/1"
861 Combine all CPUs to one.
862 .IP "\fBNetStatusCommand\fR=""xterm \-name netstat \-title 'Network Status' \-e netstat \-c""" 4
863 .IX Item "NetStatusCommand=""xterm -name netstat -title 'Network Status' -e netstat -c"""
864 Command to run on Net status.
865 .IP "\fBNetStatusClassHint\fR=""netstat.XTerm""" 4
866 .IX Item "NetStatusClassHint=""netstat.XTerm"""
867 \&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBNetStatusCommand\fR.
868 .IP "\fBAddressBarCommand\fR=""""" 4
869 .IX Item "AddressBarCommand="""""
870 Command to run for address bar entries.
871 .IP "\fBInputIgnorePrefix\fR=""nohup|(nice[[:space:]]+\-n[[:space:]]*[[:digit:]]+)|sudo|(LANG|LC_[[:alnum:]]]*)(=|=[^[:space:]]+)""" 4
872 .IX Item "InputIgnorePrefix=""nohup|(nice[[:space:]]+-n[[:space:]]*[[:digit:]]+)|sudo|(LANG|LC_[[:alnum:]]]*)(=|=[^[:space:]]+)"""
873 Regular expression (POSIX Extended flavor) which marks the begin of a
874 command line in command input fields. Such prefixes are ignored while
875 the auto-completion action is performed, typically for commands acting
876 as pass-through wrapper, executing the specified command.
877 .SS "WINDOW MENUS"
878 .IX Subsection "WINDOW MENUS"
879 .IP "\fBWinMenuItems\fR=""rmsnxfhualytiecw""" 4
880 .IX Item "WinMenuItems=""rmsnxfhualytiecw"""
881 Items supported in menu window (rmsnxfhualytieckw)
882 .IP \fBRolloverButtonsSupported\fR=0 4
883 .IX Item "RolloverButtonsSupported=0"
884 Does it support the 'O' title bar button images (for mouse rollover).
885 .IP "\fBShowMenuButtonIcon\fR=1 # 0/1" 4
886 .IX Item "ShowMenuButtonIcon=1 # 0/1"
887 Show application icon over menu button
888 .SS "THEME SETTINGS"
889 .IX Subsection "THEME SETTINGS"
890 The following sections show settings that can be set in theme files.
891 They can also be set in the \fIpreferences\fR file, but themes will override
892 the values set there. To override the theme values, the settings should
893 be set in \fIprefoverrides\fR file: see \fBicewm\-prefoverrides\fR\|(5). Default
894 values are shown following the equal sign.
895 .PP
896 \fITHEME DESCRIPTION\fR
897 .IX Subsection "THEME DESCRIPTION"
898 .IP "\fBThemeAuthor\fR=""""" 4
899 .IX Item "ThemeAuthor="""""
900 Theme author, e\-mail address, credits.
901 .IP "\fBThemeDescription\fR=""""" 4
902 .IX Item "ThemeDescription="""""
903 Description of the theme, credits.
904 .IP "\fBLook\fR=""nice""" 4
905 .IX Item "Look=""nice"""
906 Choose a theme look from one of:
907 "win95", "motif", "warp3", "warp4",
908 "nice", "metal2", "gtk2", and some others.
909 .IP "\fBGradients\fR=""""" 4
910 .IX Item "Gradients="""""
911 List of gradient pixmaps in the current theme.
912 .PP
913 \fITHEME BORDERS, ICONS, MARGINS AND BUTTONS\fR
914 .IX Subsection "THEME BORDERS, ICONS, MARGINS AND BUTTONS"
915 .IP "\fBBorderSizeX\fR=6 [0\-128]" 4
916 .IX Item "BorderSizeX=6 [0-128]"
917 Horizontal window border.
918 .IP "\fBBorderSizeY\fR=6 [0\-128]" 4
919 .IX Item "BorderSizeY=6 [0-128]"
920 Vertical window border.
921 .IP "\fBDlgBorderSizeX\fR=2 [0\-128]" 4
922 .IX Item "DlgBorderSizeX=2 [0-128]"
923 Horizontal dialog window border.
924 .IP "\fBDlgBorderSizeY\fR=2 [0\-128]" 4
925 .IX Item "DlgBorderSizeY=2 [0-128]"
926 Vertical dialog window border.
927 .IP "\fBCornerSizeX\fR=24 [0\-64]" 4
928 .IX Item "CornerSizeX=24 [0-64]"
929 Resize corner width.
930 .IP "\fBCornerSizeY\fR=24 [0\-64]" 4
931 .IX Item "CornerSizeY=24 [0-64]"
932 Resize corner height.
933 .IP "\fBTitleBarHeight\fR=20 [0\-128]" 4
934 .IX Item "TitleBarHeight=20 [0-128]"
935 Title bar height.
936 .IP "\fBTitleBarJustify\fR=0 [0\-100]" 4
937 .IX Item "TitleBarJustify=0 [0-100]"
938 Justification of the window title.
939 .IP "\fBTitleBarHorzOffset\fR=0 [\-128\-128]" 4
940 .IX Item "TitleBarHorzOffset=0 [-128-128]"
941 Horizontal offset for the window title text.
942 .IP "\fBTitleBarVertOffset\fR=0 [\-128\-128]" 4
943 .IX Item "TitleBarVertOffset=0 [-128-128]"
944 Vertical offset for the window title text.
945 .IP "\fBMenuButtonIconVertOffset\fR=0 [\-128\-128]" 4
946 .IX Item "MenuButtonIconVertOffset=0 [-128-128]"
947 Vertical offset for the menu button icon.
948 .IP "\fBScrollBarX\fR=16 [0\-64]" 4
949 .IX Item "ScrollBarX=16 [0-64]"
950 Scrollbar width.
951 .IP "\fBScrollBarY\fR=16 [0\-64]" 4
952 .IX Item "ScrollBarY=16 [0-64]"
953 Scrollbar (button) height.
954 .IP "\fBMenuIconSize\fR=16 [8\-128]" 4
955 .IX Item "MenuIconSize=16 [8-128]"
956 Menu icon size.
957 .IP "\fBSmallIconSize\fR=16 [8\-128]" 4
958 .IX Item "SmallIconSize=16 [8-128]"
959 Dimension of the small icons.
960 .IP "\fBLargeIconSize\fR=32 [8\-128]" 4
961 .IX Item "LargeIconSize=32 [8-128]"
962 Dimension of the large icons.
963 .IP "\fBHugeIconSize\fR=48 [8\-128]" 4
964 .IX Item "HugeIconSize=48 [8-128]"
965 Dimension of the large icons.
966 .IP "\fBQuickSwitchHorzMargin\fR=3 [0\-64]" 4
967 .IX Item "QuickSwitchHorzMargin=3 [0-64]"
968 Horizontal margin of the quickswitch window.
969 .IP "\fBQuickSwitchVertMargin\fR=3 [0\-64]" 4
970 .IX Item "QuickSwitchVertMargin=3 [0-64]"
971 Vertical margin of the quickswitch window.
972 .IP "\fBQuickSwitchIconMargin\fR=4 [0\-64]" 4
973 .IX Item "QuickSwitchIconMargin=4 [0-64]"
974 Vertical margin in the quickswitch window.
975 .IP "\fBQuickSwitchIconBorder\fR=2 [0\-64]" 4
976 .IX Item "QuickSwitchIconBorder=2 [0-64]"
977 Distance between the active icon and it's border.
978 .IP "\fBQuickSwitchSeparatorSize\fR=6 [0\-64]" 4
979 .IX Item "QuickSwitchSeparatorSize=6 [0-64]"
980 Height of the separator between (all reachable) icons and text, 0 to avoid it.
981 .IP "\fBTitleButtonsLeft\fR=""s""" 4
982 .IX Item "TitleButtonsLeft=""s"""
983 Titlebar buttons from left to right (x=close, m=max, i=min, h=hide, r=rollup, s=sysmenu, d=depth).
984 .IP "\fBTitleButtonsRight\fR=""xmir""" 4
985 .IX Item "TitleButtonsRight=""xmir"""
986 Titlebar buttons from right to left (x=close, m=max, i=min, h=hide, r=rollup, s=sysmenu, d=depth).
987 .IP "\fBTitleButtonsSupported\fR=""xmis""" 4
988 .IX Item "TitleButtonsSupported=""xmis"""
989 Titlebar buttons supported by theme (x,m,i,r,h,s,d).
990 .IP "\fBTitleBarCentered\fR=0 # 0/1" 4
991 .IX Item "TitleBarCentered=0 # 0/1"
992 Draw window title centered (obsoleted by TitleBarJustify).
993 .IP "\fBTitleBarJoinLeft\fR=0 # 0/1" 4
994 .IX Item "TitleBarJoinLeft=0 # 0/1"
995 Join title*S and title*T.
996 .IP "\fBTitleBarJoinRight\fR=0 # 0/1" 4
997 .IX Item "TitleBarJoinRight=0 # 0/1"
998 Join title*T and title*B.
999 .IP "\fBTaskBarClockLeds\fR=0 # 0/1" 4
1000 .IX Item "TaskBarClockLeds=0 # 0/1"
1001 Task bar clock/battery monitor uses nice pixmap LCD display (but then it
1002 doesn't display correctly in many languages anymore, e.g., for
1003 Japanese and Korean it works only when a real font is used and not
1004 the LCD pixmaps.)
1005 .IP "\fBTaskBarGraphHeight\fR=20 [16\-1000]" 4
1006 .IX Item "TaskBarGraphHeight=20 [16-1000]"
1007 Height of taskbar monitoring applets.
1008 .IP "\fBTaskbuttonIconOffset\fR=0 # [0\-16]" 4
1009 .IX Item "TaskbuttonIconOffset=0 # [0-16]"
1010 Width of taskbutton side icons.
1011 .IP "\fBTrayIconMaxWidth\fR=32 # [16\-128]" 4
1012 .IX Item "TrayIconMaxWidth=32 # [16-128]"
1013 Maximum scaled width of tray icons.
1014 .IP "\fBTrayIconMaxHeight\fR=24 # [16\-128]" 4
1015 .IX Item "TrayIconMaxHeight=24 # [16-128]"
1016 Maximum scaled height of tray icons.
1017 .IP "\fBTrayDrawBevel\fR=0 # 0/1" 4
1018 .IX Item "TrayDrawBevel=0 # 0/1"
1019 Surround the tray with plastic border.
1020 .PP
1021 \fITHEME FONTS\fR
1022 .IX Subsection "THEME FONTS"
1023 .IP "\fBTitleFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1024 .IX Item "TitleFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1025 .PD 0
1026 .IP "\fBTitleFontNameXft\fR=""sans\-serif:size=12""" 4
1027 .IX Item "TitleFontNameXft=""sans-serif:size=12"""
1028 .PD
1029 Name of the title bar font.
1030 .IP "\fBMenuFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-100\-*\-*\-*\-*\-*\-*""" 4
1031 .IX Item "MenuFontName=""-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"""
1032 .PD 0
1033 .IP "\fBMenuFontNameXft\fR=""sans\-serif:size=10:bold""" 4
1034 .IX Item "MenuFontNameXft=""sans-serif:size=10:bold"""
1035 .PD
1036 Name of the menu font.
1037 .IP "\fBStatusFontName\fR=""\-*\-monospace\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1038 .IX Item "StatusFontName=""-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"""
1039 .PD 0
1040 .IP "\fBStatusFontNameXft\fR=""monospace:size=12:bold""" 4
1041 .IX Item "StatusFontNameXft=""monospace:size=12:bold"""
1042 .PD
1043 Name of the status display font.
1044 .IP "\fBQuickSwitchFontName\fR=""\-*\-monospace\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1045 .IX Item "QuickSwitchFontName=""-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"""
1046 .PD 0
1047 .IP "\fBQuickSwitchFontNameXft\fR=""monospace:size=12:bold""" 4
1048 .IX Item "QuickSwitchFontNameXft=""monospace:size=12:bold"""
1049 .PD
1050 Name of the font for Alt+Tab switcher window.
1051 .IP "\fBNormalButtonFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1052 .IX Item "NormalButtonFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1053 .PD 0
1054 .IP "\fBNormalButtonFontNameXft\fR=""sans\-serif:size=12""" 4
1055 .IX Item "NormalButtonFontNameXft=""sans-serif:size=12"""
1056 .PD
1057 Name of the normal button font.
1058 .IP "\fBActiveButtonFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1059 .IX Item "ActiveButtonFontName=""-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"""
1060 .PD 0
1061 .IP "\fBActiveButtonFontNameXft\fR=""sans\-serif:size=12:bold""" 4
1062 .IX Item "ActiveButtonFontNameXft=""sans-serif:size=12:bold"""
1063 .PD
1064 Name of the active button font.
1065 .IP "\fBNormalTaskBarFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1066 .IX Item "NormalTaskBarFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1067 .PD 0
1068 .IP "\fBNormalTaskBarFontNameXft\fR=""sans\-serif:size=12""" 4
1069 .IX Item "NormalTaskBarFontNameXft=""sans-serif:size=12"""
1070 .PD
1071 Name of the normal task bar item font.
1072 .IP "\fBActiveTaskBarFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1073 .IX Item "ActiveTaskBarFontName=""-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"""
1074 .PD 0
1075 .IP "\fBActiveTaskBarFontNameXft\fR=""sans\-serif:size=12:bold""" 4
1076 .IX Item "ActiveTaskBarFontNameXft=""sans-serif:size=12:bold"""
1077 .PD
1078 Name of the active task bar item font.
1079 .IP "\fBToolButtonFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1080 .IX Item "ToolButtonFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1081 .PD 0
1082 .IP "\fBToolButtonFontNameXft\fR=""sans\-serif:size=12""" 4
1083 .IX Item "ToolButtonFontNameXft=""sans-serif:size=12"""
1084 .PD
1085 Name of the tool button font (fallback: NormalButtonFontName).
1086 .IP "\fBNormalWorkspaceFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1087 .IX Item "NormalWorkspaceFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1088 .PD 0
1089 .IP "\fBNormalWorkspaceFontNameXft\fR=""sans\-serif:size=12""" 4
1090 .IX Item "NormalWorkspaceFontNameXft=""sans-serif:size=12"""
1091 .PD
1092 Name of the normal workspace button font (fallback: NormalButtonFontName).
1093 .IP "\fBActiveWorkspaceFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1094 .IX Item "ActiveWorkspaceFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1095 .PD 0
1096 .IP "\fBActiveWorkspaceFontNameXft\fR=""sans\-serif:size=12""" 4
1097 .IX Item "ActiveWorkspaceFontNameXft=""sans-serif:size=12"""
1098 .PD
1099 Name of the active workspace button font (fallback: ActiveButtonFontName).
1100 .IP "\fBMinimizedWindowFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1101 .IX Item "MinimizedWindowFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1102 .PD 0
1103 .IP "\fBMinimizedWindowFontNameXft\fR=""sans\-serif:size=12""" 4
1104 .IX Item "MinimizedWindowFontNameXft=""sans-serif:size=12"""
1105 .PD
1106 Name of the mini-window font.
1107 .IP "\fBListBoxFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1108 .IX Item "ListBoxFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1109 .PD 0
1110 .IP "\fBListBoxFontNameXft\fR=""sans\-serif:size=12""" 4
1111 .IX Item "ListBoxFontNameXft=""sans-serif:size=12"""
1112 .PD
1113 Name of the window list font.
1114 .IP "\fBToolTipFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1115 .IX Item "ToolTipFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1116 .PD 0
1117 .IP "\fBToolTipFontNameXft\fR=""sans\-serif:size=12""" 4
1118 .IX Item "ToolTipFontNameXft=""sans-serif:size=12"""
1119 .PD
1120 Name of the tool tip font.
1121 .IP "\fBClockFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1122 .IX Item "ClockFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"""
1123 .PD 0
1124 .IP "\fBClockFontNameXft\fR=""monospace:size=12""" 4
1125 .IX Item "ClockFontNameXft=""monospace:size=12"""
1126 .PD
1127 Name of the task bar clock font.
1128 .IP "\fBTempFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1129 .IX Item "TempFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"""
1130 .PD 0
1131 .IP "\fBTempFontNameXft\fR=""monospace:size=12""" 4
1132 .IX Item "TempFontNameXft=""monospace:size=12"""
1133 .PD
1134 Name of the task bar temperature font.
1135 .IP "\fBApmFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1136 .IX Item "ApmFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"""
1137 .PD 0
1138 .IP "\fBApmFontNameXft\fR=""monospace:size=12""" 4
1139 .IX Item "ApmFontNameXft=""monospace:size=12"""
1140 .PD
1141 Name of the task bar battery font.
1142 .IP "\fBInputFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1143 .IX Item "InputFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"""
1144 .PD 0
1145 .IP "\fBInputFontNameXft\fR=""monospace:size=12""" 4
1146 .IX Item "InputFontNameXft=""monospace:size=12"""
1147 .PD
1148 Name of the input field font.
1149 .IP "\fBLabelFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1150 .IX Item "LabelFontName=""-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"""
1151 .PD 0
1152 .IP "\fBLabelFontNameXft\fR=""sans\-serif:size=12""" 4
1153 .IX Item "LabelFontNameXft=""sans-serif:size=12"""
1154 .PD
1155 Name of the label font.
1156 .PP
1157 \fITHEME COLORS\fR
1158 .IX Subsection "THEME COLORS"
1159 .IP "\fBColorDialog\fR = ""rgb:C0/C0/C0""" 4
1160 .IX Item "ColorDialog = ""rgb:C0/C0/C0"""
1161 Background of dialog windows.
1162 .IP "\fBColorNormalBorder\fR = ""rgb:C0/C0/C0""" 4
1163 .IX Item "ColorNormalBorder = ""rgb:C0/C0/C0"""
1164 Border of inactive windows.
1165 .IP "\fBColorActiveBorder\fR = ""rgb:C0/C0/C0""" 4
1166 .IX Item "ColorActiveBorder = ""rgb:C0/C0/C0"""
1167 Border of active windows.
1168 .IP "\fBColorNormalButton\fR = ""rgb:C0/C0/C0""" 4
1169 .IX Item "ColorNormalButton = ""rgb:C0/C0/C0"""
1170 Background of regular buttons.
1171 .IP "\fBColorNormalButtonText\fR = ""rgb:00/00/00""" 4
1172 .IX Item "ColorNormalButtonText = ""rgb:00/00/00"""
1173 Text color of regular buttons.
1174 .IP "\fBColorActiveButton\fR = ""rgb:E0/E0/E0""" 4
1175 .IX Item "ColorActiveButton = ""rgb:E0/E0/E0"""
1176 Background of pressed buttons.
1177 .IP "\fBColorActiveButtonText\fR = ""rgb:00/00/00""" 4
1178 .IX Item "ColorActiveButtonText = ""rgb:00/00/00"""
1179 Text color of pressed buttons.
1180 .IP "\fBColorNormalTitleButton\fR = ""rgb:C0/C0/C0""" 4
1181 .IX Item "ColorNormalTitleButton = ""rgb:C0/C0/C0"""
1182 Background of titlebar buttons.
1183 .IP "\fBColorNormalTitleButtonText\fR = ""rgb:00/00/00""" 4
1184 .IX Item "ColorNormalTitleButtonText = ""rgb:00/00/00"""
1185 Text color of titlebar buttons.
1186 .IP "\fBColorToolButton\fR = """"" 4
1187 .IX Item "ColorToolButton = """""
1188 Background of toolbar buttons, ColorNormalButton is used if empty.
1189 .IP "\fBColorToolButtonText\fR = """"" 4
1190 .IX Item "ColorToolButtonText = """""
1191 Text color of toolbar buttons, ColorNormalButtonText is used if empty.
1192 .IP "\fBColorNormalWorkspaceButton\fR = """"" 4
1193 .IX Item "ColorNormalWorkspaceButton = """""
1194 Background of workspace buttons, ColorNormalButton is used if empty.
1195 .IP "\fBColorNormalWorkspaceButtonText\fR = """"" 4
1196 .IX Item "ColorNormalWorkspaceButtonText = """""
1197 Text color of workspace buttons, ColorNormalButtonText is used if empty.
1198 .IP "\fBColorActiveWorkspaceButton\fR = """"" 4
1199 .IX Item "ColorActiveWorkspaceButton = """""
1200 Background of the active workspace button, ColorActiveButton is used if empty.
1201 .IP "\fBColorActiveWorkspaceButtonText\fR = """"" 4
1202 .IX Item "ColorActiveWorkspaceButtonText = """""
1203 Text color of the active workspace button, ColorActiveButtonText is used if empty.
1204 .IP "\fBColorNormalTitleBar\fR = ""rgb:80/80/80""" 4
1205 .IX Item "ColorNormalTitleBar = ""rgb:80/80/80"""
1206 Background of the titlebar of regular windows.
1207 .IP "\fBColorNormalTitleBarText\fR = ""rgb:00/00/00""" 4
1208 .IX Item "ColorNormalTitleBarText = ""rgb:00/00/00"""
1209 Text color of the titlebar of regular windows.
1210 .IP "\fBColorNormalTitleBarShadow\fR = """"" 4
1211 .IX Item "ColorNormalTitleBarShadow = """""
1212 Text shadow of the titlebar of regular windows.
1213 .IP "\fBColorActiveTitleBar\fR = ""rgb:00/00/A0""" 4
1214 .IX Item "ColorActiveTitleBar = ""rgb:00/00/A0"""
1215 Background of the titlebar of active windows.
1216 .IP "\fBColorActiveTitleBarText\fR = ""rgb:FF/FF/FF""" 4
1217 .IX Item "ColorActiveTitleBarText = ""rgb:FF/FF/FF"""
1218 Text color of the titlebar of active windows.
1219 .IP "\fBColorActiveTitleBarShadow\fR = """"" 4
1220 .IX Item "ColorActiveTitleBarShadow = """""
1221 Text shadow of the titlebar of active windows.
1222 .IP "\fBColorNormalMinimizedWindow\fR = ""rgb:C0/C0/C0""" 4
1223 .IX Item "ColorNormalMinimizedWindow = ""rgb:C0/C0/C0"""
1224 Background for mini icons of regular windows.
1225 .IP "\fBColorNormalMinimizedWindowText\fR = ""rgb:00/00/00""" 4
1226 .IX Item "ColorNormalMinimizedWindowText = ""rgb:00/00/00"""
1227 Text color for mini icons of regular windows.
1228 .IP "\fBColorActiveMinimizedWindow\fR = ""rgb:E0/E0/E0""" 4
1229 .IX Item "ColorActiveMinimizedWindow = ""rgb:E0/E0/E0"""
1230 Background for mini icons of active windows.
1231 .IP "\fBColorActiveMinimizedWindowText\fR = ""rgb:00/00/00""" 4
1232 .IX Item "ColorActiveMinimizedWindowText = ""rgb:00/00/00"""
1233 Text color for mini icons of active windows.
1234 .IP "\fBColorNormalMenu\fR = ""rgb:C0/C0/C0""" 4
1235 .IX Item "ColorNormalMenu = ""rgb:C0/C0/C0"""
1236 Background of pop-up menus.
1237 .IP "\fBColorNormalMenuItemText\fR = ""rgb:00/00/00""" 4
1238 .IX Item "ColorNormalMenuItemText = ""rgb:00/00/00"""
1239 Text color of regular menu items.
1240 .IP "\fBColorActiveMenuItem\fR = ""rgb:A0/A0/A0""" 4
1241 .IX Item "ColorActiveMenuItem = ""rgb:A0/A0/A0"""
1242 Background of selected menu item, leave empty to force transparency.
1243 .IP "\fBColorActiveMenuItemText\fR = ""rgb:00/00/00""" 4
1244 .IX Item "ColorActiveMenuItemText = ""rgb:00/00/00"""
1245 Text color of selected menu items.
1246 .IP "\fBColorDisabledMenuItemText\fR = ""rgb:80/80/80""" 4
1247 .IX Item "ColorDisabledMenuItemText = ""rgb:80/80/80"""
1248 Text color of disabled menu items.
1249 .IP "\fBColorDisabledMenuItemShadow\fR = """"" 4
1250 .IX Item "ColorDisabledMenuItemShadow = """""
1251 Shadow of regular menu items.
1252 .IP "\fBColorMoveSizeStatus\fR = ""rgb:C0/C0/C0""" 4
1253 .IX Item "ColorMoveSizeStatus = ""rgb:C0/C0/C0"""
1254 Background of move/resize status window.
1255 .IP "\fBColorMoveSizeStatusText\fR = ""rgb:00/00/00""" 4
1256 .IX Item "ColorMoveSizeStatusText = ""rgb:00/00/00"""
1257 Text color of move/resize status window.
1258 .IP "\fBColorQuickSwitch\fR = ""rgb:C0/C0/C0""" 4
1259 .IX Item "ColorQuickSwitch = ""rgb:C0/C0/C0"""
1260 Background of the quick switch window.
1261 .IP "\fBColorQuickSwitchText\fR = ""rgb:00/00/00""" 4
1262 .IX Item "ColorQuickSwitchText = ""rgb:00/00/00"""
1263 Text color in the quick switch window.
1264 .IP "\fBColorQuickSwitchActive\fR = """"" 4
1265 .IX Item "ColorQuickSwitchActive = """""
1266 Rectangle around the active icon in the quick switch window.
1267 .IP "\fBColorQuickSwitchBorder\fR = """"" 4
1268 .IX Item "ColorQuickSwitchBorder = """""
1269 The color for the quick switch border. When empty, a one pixel wide
1270 elevation border will be drawn, based on the quick switch background.
1271 .IP "\fBColorDefaultTaskBar\fR = ""rgb:C0/C0/C0""" 4
1272 .IX Item "ColorDefaultTaskBar = ""rgb:C0/C0/C0"""
1273 Background of the taskbar.
1274 .IP "\fBColorNormalTaskBarApp\fR = ""rgb:C0/C0/C0""" 4
1275 .IX Item "ColorNormalTaskBarApp = ""rgb:C0/C0/C0"""
1276 Background for task buttons of regular windows.
1277 .IP "\fBColorNormalTaskBarAppText\fR = ""rgb:00/00/00""" 4
1278 .IX Item "ColorNormalTaskBarAppText = ""rgb:00/00/00"""
1279 Text color for task buttons of regular windows.
1280 .IP "\fBColorActiveTaskBarApp\fR = ""rgb:E0/E0/E0""" 4
1281 .IX Item "ColorActiveTaskBarApp = ""rgb:E0/E0/E0"""
1282 Background for task buttons of the active window.
1283 .IP "\fBColorActiveTaskBarAppText\fR = ""rgb:00/00/00""" 4
1284 .IX Item "ColorActiveTaskBarAppText = ""rgb:00/00/00"""
1285 Text color for task buttons of the active window.
1286 .IP "\fBColorMinimizedTaskBarApp\fR = ""rgb:A0/A0/A0""" 4
1287 .IX Item "ColorMinimizedTaskBarApp = ""rgb:A0/A0/A0"""
1288 Background for task buttons of minimized windows.
1289 .IP "\fBColorMinimizedTaskBarAppText\fR = ""rgb:00/00/00""" 4
1290 .IX Item "ColorMinimizedTaskBarAppText = ""rgb:00/00/00"""
1291 Text color for task buttons of minimized windows.
1292 .IP "\fBColorInvisibleTaskBarApp\fR = ""rgb:80/80/80""" 4
1293 .IX Item "ColorInvisibleTaskBarApp = ""rgb:80/80/80"""
1294 Background for task buttons of windows on other workspaces.
1295 .IP "\fBColorInvisibleTaskBarAppText\fR = ""rgb:00/00/00""" 4
1296 .IX Item "ColorInvisibleTaskBarAppText = ""rgb:00/00/00"""
1297 Text color for task buttons of windows on other workspaces.
1298 .IP "\fBColorScrollBar\fR = ""rgb:A0/A0/A0""" 4
1299 .IX Item "ColorScrollBar = ""rgb:A0/A0/A0"""
1300 Scrollbar background (sliding area).
1301 .IP "\fBColorScrollBarSlider\fR = ""rgb:C0/C0/C0""" 4
1302 .IX Item "ColorScrollBarSlider = ""rgb:C0/C0/C0"""
1303 Background of the slider button in scrollbars.
1304 .IP "\fBColorScrollBarButton\fR = ""rgb:C0/C0/C0""" 4
1305 .IX Item "ColorScrollBarButton = ""rgb:C0/C0/C0"""
1306 Background of the arrow buttons in scrollbars.
1307 .IP "\fBColorScrollBarArrow\fR = ""rgb:C0/C0/C0""" 4
1308 .IX Item "ColorScrollBarArrow = ""rgb:C0/C0/C0"""
1309 Background of the arrow buttons in scrollbars (obsolete).
1310 .IP "\fBColorScrollBarButtonArrow\fR = ""rgb:00/00/00""" 4
1311 .IX Item "ColorScrollBarButtonArrow = ""rgb:00/00/00"""
1312 Color of active arrows on scrollbar buttons.
1313 .IP "\fBColorScrollBarInactiveArrow\fR = ""rgb:80/80/80""" 4
1314 .IX Item "ColorScrollBarInactiveArrow = ""rgb:80/80/80"""
1315 Color of inactive arrows on scrollbar buttons.
1316 .IP "\fBColorListBox\fR = ""rgb:C0/C0/C0""" 4
1317 .IX Item "ColorListBox = ""rgb:C0/C0/C0"""
1318 Background of listboxes.
1319 .IP "\fBColorListBoxText\fR = ""rgb:00/00/00""" 4
1320 .IX Item "ColorListBoxText = ""rgb:00/00/00"""
1321 Text color in listboxes.
1322 .IP "\fBColorListBoxSelection\fR = ""rgb:80/80/80""" 4
1323 .IX Item "ColorListBoxSelection = ""rgb:80/80/80"""
1324 Background of selected listbox items.
1325 .IP "\fBColorListBoxSelectionText\fR = ""rgb:00/00/00""" 4
1326 .IX Item "ColorListBoxSelectionText = ""rgb:00/00/00"""
1327 Text color of selected listbox items.
1328 .IP "\fBColorToolTip\fR = ""rgb:E0/E0/00""" 4
1329 .IX Item "ColorToolTip = ""rgb:E0/E0/00"""
1330 Background of tooltips.
1331 .IP "\fBColorToolTipText\fR = ""rgb:00/00/00""" 4
1332 .IX Item "ColorToolTipText = ""rgb:00/00/00"""
1333 Text color of tooltips.
1334 .IP "\fBColorLabel\fR = ""rgb:C0/C0/C0""" 4
1335 .IX Item "ColorLabel = ""rgb:C0/C0/C0"""
1336 Background of labels, leave empty to force transparency.
1337 .IP "\fBColorLabelText\fR = ""rgb:00/00/00""" 4
1338 .IX Item "ColorLabelText = ""rgb:00/00/00"""
1339 Text color of labels.
1340 .IP "\fBColorInput\fR = ""rgb:FF/FF/FF""" 4
1341 .IX Item "ColorInput = ""rgb:FF/FF/FF"""
1342 Background of text entry fields (e.g., the addressbar).
1343 .IP "\fBColorInputText\fR = ""rgb:00/00/00""" 4
1344 .IX Item "ColorInputText = ""rgb:00/00/00"""
1345 Text color of text entry fields (e.g., the addressbar).
1346 .IP "\fBColorInputSelection\fR = ""rgb:80/80/80""" 4
1347 .IX Item "ColorInputSelection = ""rgb:80/80/80"""
1348 Background of selected text in an entry field.
1349 .IP "\fBColorInputSelectionText\fR = ""rgb:00/00/00""" 4
1350 .IX Item "ColorInputSelectionText = ""rgb:00/00/00"""
1351 Selected text in an entry field.
1352 .IP "\fBColorClock\fR = ""rgb:00/00/00""" 4
1353 .IX Item "ColorClock = ""rgb:00/00/00"""
1354 Background of non-LCD clock, leave empty to force transparency.
1355 .IP "\fBColorClockText\fR = ""rgb:00/FF/00""" 4
1356 .IX Item "ColorClockText = ""rgb:00/FF/00"""
1357 Text color of non-LCD clock.
1358 .IP "\fBColorKeyboardLayoutText\fR = """"" 4
1359 .IX Item "ColorKeyboardLayoutText = """""
1360 Color of keyboard layout indicator.
1361 .IP "\fBColorApm\fR = ""rgb:00/00/00""" 4
1362 .IX Item "ColorApm = ""rgb:00/00/00"""
1363 Background of battery monitor, leave empty to force transparency.
1364 .IP "\fBColorApmText\fR = ""rgb:00/FF/00""" 4
1365 .IX Item "ColorApmText = ""rgb:00/FF/00"""
1366 Text color of battery monitor.
1367 .IP "\fBColorApmBattery\fR = ""rgb:FF/FF/00""" 4
1368 .IX Item "ColorApmBattery = ""rgb:FF/FF/00"""
1369 Color of battery monitor when discharging.
1370 .IP "\fBColorApmLine\fR = ""rgb:00/FF/00""" 4
1371 .IX Item "ColorApmLine = ""rgb:00/FF/00"""
1372 Color of battery monitor when charging.
1373 .IP "\fBColorApmGraphBg\fR = ""rgb:00/00/00""" 4
1374 .IX Item "ColorApmGraphBg = ""rgb:00/00/00"""
1375 Background color for graph mode.
1376 .IP "\fBColorCPUStatusUser\fR = ""rgb:00/FF/00""" 4
1377 .IX Item "ColorCPUStatusUser = ""rgb:00/FF/00"""
1378 User load on the CPU monitor.
1379 .IP "\fBColorCPUStatusSystem\fR = ""rgb:FF/00/00""" 4
1380 .IX Item "ColorCPUStatusSystem = ""rgb:FF/00/00"""
1381 System load on the CPU monitor.
1382 .IP "\fBColorCPUStatusInterrupts\fR = ""rgb:FF/FF/00""" 4
1383 .IX Item "ColorCPUStatusInterrupts = ""rgb:FF/FF/00"""
1384 Interrupts on the CPU monitor.
1385 .IP "\fBColorCPUStatusIoWait\fR = ""rgb:60/00/60""" 4
1386 .IX Item "ColorCPUStatusIoWait = ""rgb:60/00/60"""
1387 IO Wait on the CPU monitor.
1388 .IP "\fBColorCPUStatusSoftIrq\fR = ""rgb:00/FF/FF""" 4
1389 .IX Item "ColorCPUStatusSoftIrq = ""rgb:00/FF/FF"""
1390 Soft Interrupts on the CPU monitor.
1391 .IP "\fBColorCPUStatusNice\fR = ""rgb:00/00/FF""" 4
1392 .IX Item "ColorCPUStatusNice = ""rgb:00/00/FF"""
1393 Nice load on the CPU monitor.
1394 .IP "\fBColorCPUStatusIdle\fR = ""rgb:00/00/00""" 4
1395 .IX Item "ColorCPUStatusIdle = ""rgb:00/00/00"""
1396 Idle (non) load on the CPU monitor, leave empty to force
1397 transparency.
1398 .IP "\fBColorCPUStatusSteal\fR = ""rgb:FF/8A/91""" 4
1399 .IX Item "ColorCPUStatusSteal = ""rgb:FF/8A/91"""
1400 Involuntary Wait on the CPU monitor.
1401 .IP "\fBColorCPUStatusTemp\fR = ""rgb:60/60/C0""" 4
1402 .IX Item "ColorCPUStatusTemp = ""rgb:60/60/C0"""
1403 Temperature of the CPU.
1404 .IP "\fBColorMEMStatusUser\fR = ""rgb:40/40/80""" 4
1405 .IX Item "ColorMEMStatusUser = ""rgb:40/40/80"""
1406 User program usage in the memory monitor.
1407 .IP "\fBColorMEMStatusBuffers\fR = ""rgb:60/60/C0""" 4
1408 .IX Item "ColorMEMStatusBuffers = ""rgb:60/60/C0"""
1409 OS buffers usage in the memory monitor.
1410 .IP "\fBColorMEMStatusCached\fR = ""rgb:80/80/FF""" 4
1411 .IX Item "ColorMEMStatusCached = ""rgb:80/80/FF"""
1412 OS cached usage in the memory monitor.
1413 .IP "\fBColorMEMStatusFree\fR = ""rgb:00/00/00""" 4
1414 .IX Item "ColorMEMStatusFree = ""rgb:00/00/00"""
1415 Free memory in the memory monitor.
1416 .IP "\fBColorNetSend\fR = ""rgb:FF/FF/00""" 4
1417 .IX Item "ColorNetSend = ""rgb:FF/FF/00"""
1418 Outgoing load on the network monitor.
1419 .IP "\fBColorNetReceive\fR = ""rgb:FF/00/FF""" 4
1420 .IX Item "ColorNetReceive = ""rgb:FF/00/FF"""
1421 Incoming load on the network monitor.
1422 .IP "\fBColorNetIdle\fR = ""rgb:00/00/00""" 4
1423 .IX Item "ColorNetIdle = ""rgb:00/00/00"""
1424 Idle (non) load on the network monitor, leave empty to force transparency.
1425 .PP
1426 \fIDESKTOP BACKGROUND\fR
1427 .IX Subsection "DESKTOP BACKGROUND"
1428 .PP
1429 The following themeable preferences are read by \fBicewmbg\fR\|(1):
1430 .IP "\fBDesktopBackgroundCenter\fR=0 0/1" 4
1431 .IX Item "DesktopBackgroundCenter=0 0/1"
1432 Display desktop background centered and not tiled.
1433 .IP "\fBDesktopBackgroundScaled\fR=0 0/1" 4
1434 .IX Item "DesktopBackgroundScaled=0 0/1"
1435 Resize desktop background to full screen.
1436 .IP "\fBDesktopBackgroundColor\fR=""""" 4
1437 .IX Item "DesktopBackgroundColor="""""
1438 A comma-separated list of zero or more desktop background colors.
1439 .IP "\fBDesktopBackgroundImage\fR=""""" 4
1440 .IX Item "DesktopBackgroundImage="""""
1441 A comma-separated list of zero or more desktop background images.
1442 Each image may be a path with a \fBglob\fR\|(7) pattern, or start with a
1443 tilde or environment variable.
1444 .IP "\fBShuffleBackgroundImages\fR=0 0/1" 4
1445 .IX Item "ShuffleBackgroundImages=0 0/1"
1446 Choose a random selection from the list of background images.
1447 .IP "\fBSupportSemitransparency\fR=1 0/1" 4
1448 .IX Item "SupportSemitransparency=1 0/1"
1449 Support for semitransparent terminals like Eterm or gnome-terminal.
1450 .IP "\fBDesktopTransparencyColor\fR=""""" 4
1451 .IX Item "DesktopTransparencyColor="""""
1452 Color(s) to announce for semitransparent windows.
1453 .IP "\fBDesktopTransparencyImage\fR=""""" 4
1454 .IX Item "DesktopTransparencyImage="""""
1455 Image(s) to announce for semitransparent windows.
1456 This is a list similar to \fBDesktopBackgroundImage\fR.
1457 .IP "\fBDesktopBackgroundMultihead\fR=0 0/1" 4
1458 .IX Item "DesktopBackgroundMultihead=0 0/1"
1459 Paint the background image over all multihead monitors combined.
1460 .IP \fBCycleBackgroundsPeriod\fR=0 4
1461 .IX Item "CycleBackgroundsPeriod=0"
1462 Seconds between cycling over all background images, default zero is off.
1463 .SS EXAMPLES
1464 .IX Subsection "EXAMPLES"
1465 .Vb 10
1466 \& Alpha=1
1467 \& Splash="IceWM.jpg"
1468 \& LimitSize=0
1469 \& LimitPosition=0
1470 \& LimitByDockLayer=1
1471 \& QuickSwitchToAllWorkspaces=1
1472 \& QuickSwitchHugeIcon=1
1473 \& QuickSwitchFillSelection=1
1474 \& TaskBarMailboxStatusBeepOnNewMail=1
1475 \& TaskBarMailboxStatusCountMessages=1
1476 \& TaskBarShowMEMStatus=0
1477 \& TaskBarShowCollapseButton=1
1478 \& TaskBarWorkspacesLimit="8"
1479 \& ShowProgramsMenu=1
1480 \& ShowAddressBar=0
1481 \& ToolTipDelay=200
1482 \& ToolTipTime=5000
1483 \& AutoHideDelay=900
1484 \& AutoShowDelay=100
1485 \& EdgeResistance=3
1486 \& KeySysWinMenu=""
1487 \& KeySysWinListMenu="Shift+Ctrl+Esc"
1488 .Ve
1489 .PP
1490 The above example shows how to tell \fBicewm\fR to not bind a specific key:
1491 \&\fIKeySysWinMenu\fR in this case.
1492 .SS FILES
1493 .IX Subsection "FILES"
1494 Locations for the \fIpreferences\fR file are as follows:
1495 .PP
1496 .Vb 5
1497 \& $ICEWM_PRIVCFG/preferences
1498 \& $XDG_CONFIG_HOME/icewm/preferences
1499 \& $HOME/.icewm/preferences
1500 \& /etc/X11/icewm/preferences
1501 \& /usr/share/icewm/preferences
1502 .Ve
1503 .PP
1504 The locations are searched in the order listed; the first file found is
1505 read and the remainder ignored.
1506 .SS "SEE ALSO"
1507 .IX Subsection "SEE ALSO"
1508 \&\fBicewm\fR\|(1),
1509 \&\fBicewm\-prefoverride\fR\|(5).
1510 .SS AUTHOR
1511 .IX Subsection "AUTHOR"
1512 Brian Bidulock <mailto:[email protected]>.
1513 .SS LICENSE
1514 .IX Subsection "LICENSE"
1515 \&\fBIceWM\fR is licensed under the GNU Library General Public License.
1516 See the \fICOPYING\fR file in the distribution.