Debian Codegraph @

upstream/opensuse-tumbleweed/man5/icewm-preferences.5

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