Debian Codegraph @

upstream/mageia-cauldron/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 2026-01-01 "icewm 4.0.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 \fBQuickSwitchPreview\fR=0 4
332 .IX Item "QuickSwitchPreview=0"
333 Use a QuickSwitch that shows previews of applications.
334 .IP \fBQuickSwitchRaiseCandidate\fR=0 4
335 .IX Item "QuickSwitchRaiseCandidate=0"
336 Raise a selected window while Alt+Tabbing in the QuickSwitch.
337 .IP \fBQuickSwitchAllIcons\fR=1 4
338 .IX Item "QuickSwitchAllIcons=1"
339 Show all reachable icons when quick switching.
340 .IP \fBQuickSwitchTextFirst\fR=0 4
341 .IX Item "QuickSwitchTextFirst=0"
342 Show the window title above (all reachable) icons.
343 .IP \fBQuickSwitchSmallWindow\fR=0 4
344 .IX Item "QuickSwitchSmallWindow=0"
345 Create a smaller QuickSwitch window of 1/3 screen width.
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 \fBXRRDisable\fR=1 4
541 .IX Item "XRRDisable=1"
542 Disable use of new XRANDR API for dual head (nvidia workaround).
543 .IP \fBPreferFreetypeFonts\fR=1 4
544 .IX Item "PreferFreetypeFonts=1"
545 Favour Xft fonts over core X11 fonts where possible.
546 .IP "\fBMailBoxPath\fR=""""" 4
547 .IX Item "MailBoxPath="""""
548 A list of paths of your mailboxes separated by spaces.
549 If this is empty, \f(CW$MAILPATH\fR or \f(CW$MAIL\fR is used instead.
550 .Sp
551 Path to a mbox file. Remote mail boxes are accessed by specifying an URL
552 using the Common Internet Scheme Syntax (RFC 1738):
553 .Sp
554 .Vb 1
555 \& \`scheme://[user[:password]@]server[:port][/path]\`.
556 .Ve
557 .Sp
558 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
559 omitted \fIfile://\fR is prepended silently. IMAP subfolders can be
560 accessed by using the path component. Reserved characters like
561 \&\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
562 escape sequences with a hexadecimal encoding like \f(CW%2f\fR for the slash
563 or \f(CW%40\fR for the at sign. For example:
564 .Sp
565 .Vb 3
566 \& file:///var/spool/mail/captnmark
567 \& pop3://markus:%2f%40%[email protected]/
568 \& imap://mathias@localhost/INBOX.Maillisten.icewm\-user
569 .Ve
570 .IP "\fBNetworkStatusDevice\fR=""eth0 wlan0""" 4
571 .IX Item "NetworkStatusDevice=""eth0 wlan0"""
572 Network devices for which to show status.
573 .IP "\fBTimeFormat\fR=""%X""" 4
574 .IX Item "TimeFormat=""%X"""
575 The clock time format. See the strftime manpage for the meaning of all
576 the percent options. It is possible to define multiple clocks for
577 different time zones in a single \fITimeFormat\fR. A new clock is defined
578 by the beginning of the string, and by each time zone specification
579 that starts with \f(CW\*(C`TZ=...\*(C'\fR, followed by a space. For example,
580 \&\fBTimeFormat\fR=\f(CW\*(C`%X TZ=Asia/Aden %T TZ=Asia/Baku %T\*(C'\fR defines 3 clocks.
581 .IP "\fBTimeFormatAlt\fR=""""" 4
582 .IX Item "TimeFormatAlt="""""
583 Alternate Clock Time format shown every other second.
584 .IP "\fBDateFormat\fR=""%c""" 4
585 .IX Item "DateFormat=""%c"""
586 Clock Date format for tooltip (strftime format string).
587 .IP "\fBDockApps\fR=""right high desktop""" 4
588 .IX Item "DockApps=""right high desktop"""
589 Support DockApps (right, left, center, down, high, above, dock, ontop,
590 normal, below, desktop, or empty to disable). The first five control
591 positioning, while the next six set the layer. Control with Ctrl+Mouse.
592 .IP "\fBXRRPrimaryScreenName\fR=""""" 4
593 .IX Item "XRRPrimaryScreenName="""""
594 Screen/output name of the primary screen.
595 .IP "\fBAcpiIgnoreBatteries\fR=""""" 4
596 .IX Item "AcpiIgnoreBatteries="""""
597 List of battery names (directories) in /proc/acpi/battery to ignore.
598 Useful when more slots are built\-in, but only one battery is used.
599 .IP "\fBTaskBarCPUSamples\fR=20 [2\-1000]" 4
600 .IX Item "TaskBarCPUSamples=20 [2-1000]"
601 The width of the CPU Monitor applet in pixels.
602 .IP "\fBTaskBarMEMSamples\fR=20 [2\-1000]" 4
603 .IX Item "TaskBarMEMSamples=20 [2-1000]"
604 The width of the Memory Monitor applet in pixels.
605 .IP "\fBTaskBarNetSamples\fR=20 [2\-1000]" 4
606 .IX Item "TaskBarNetSamples=20 [2-1000]"
607 The width of the Net Monitor applet in pixels.
608 .IP "\fBTaskbarButtonWidthDivisor\fR=3 [1\-25]" 4
609 .IX Item "TaskbarButtonWidthDivisor=3 [1-25]"
610 Default number of tasks in taskbar.
611 .IP "\fBTaskBarWidthPercentage\fR=100 [0\-100]" 4
612 .IX Item "TaskBarWidthPercentage=100 [0-100]"
613 Task bar width as percentage of the screen width.
614 .IP "\fBTaskBarJustify\fR=""left""" 4
615 .IX Item "TaskBarJustify=""left"""
616 Taskbar justify left, right or center.
617 .IP "\fBTaskBarApmGraphWidth\fR=10 [1\-1000]" 4
618 .IX Item "TaskBarApmGraphWidth=10 [1-1000]"
619 Width of battery Monitor.
620 .IP "\fBXineramaPrimaryScreen\fR=0 [0\-63]" 4
621 .IX Item "XineramaPrimaryScreen=0 [0-63]"
622 Primary screen for xinerama (taskbar, ...).
623 .IP "\fBKeyboardLayouts\fR=""""" 4
624 .IX Item "KeyboardLayouts="""""
625 A comma\-separated list of keyboard layouts.
626 A layout may be enclosed in double quotes.
627 Each layout is a name with optional arguments,
628 that is to be parsed by the \f(CW\*(C`setxkbmap\*(C'\fR program.
629 To support changing keyboard layouts, the
630 \&\f(CW\*(C`setxkbmap\*(C'\fR program must be installed.
631 The first in the list is the default layout.
632 Programs may have their own keyboard layout
633 defined in the \fIwinoptions\fR file.
634 The first two letters of a layout are used
635 to locate an icon image file.
636 .SS MENUS
637 .IX Subsection "MENUS"
638 .IP \fBAutoReloadMenus\fR=1 4
639 .IX Item "AutoReloadMenus=1"
640 Reload menu files automatically.
641 .IP \fBShowProgramsMenu\fR=0 4
642 .IX Item "ShowProgramsMenu=0"
643 Show programs submenu.
644 .IP \fBShowSettingsMenu\fR=1 4
645 .IX Item "ShowSettingsMenu=1"
646 Show settings submenu.
647 .IP \fBShowFocusModeMenu\fR=1 4
648 .IX Item "ShowFocusModeMenu=1"
649 Show focus mode submenu.
650 .IP \fBShowThemesMenu\fR=1 4
651 .IX Item "ShowThemesMenu=1"
652 Show themes submenu.
653 .IP \fBShowLogoutMenu\fR=1 4
654 .IX Item "ShowLogoutMenu=1"
655 Show logout menu.
656 .IP \fBShowHelp\fR=1 4
657 .IX Item "ShowHelp=1"
658 Show the help menu item.
659 .IP \fBShowLogoutSubMenu\fR=1 4
660 .IX Item "ShowLogoutSubMenu=1"
661 Show logout submenu.
662 .IP \fBShowAbout\fR=1 4
663 .IX Item "ShowAbout=1"
664 Show the about menu item.
665 .IP \fBShowRun\fR=1 4
666 .IX Item "ShowRun=1"
667 Show the run menu item.
668 .IP \fBShowWindowList\fR=1 4
669 .IX Item "ShowWindowList=1"
670 Show the window menu item.
671 .IP "\fBMenuMaximalWidth\fR=0 [0\-16384]" 4
672 .IX Item "MenuMaximalWidth=0 [0-16384]"
673 Maximal width of popup menus, 2/3 of the screen\*(Aqs width if set to zero.
674 .IP "\fBNestedThemeMenuMinNumber\fR=25 [0\-1234]" 4
675 .IX Item "NestedThemeMenuMinNumber=25 [0-1234]"
676 Minimal number of themes after which the Themes menu becomes nested (0=disabled).
677 .SS TIMINGS
678 .IX Subsection "TIMINGS"
679 .IP "\fBDelayFuzziness\fR=10 (0\-100)" 4
680 .IX Item "DelayFuzziness=10 (0-100)"
681 Delay fuzziness, to allow merging of multiple timer timeouts into one
682 (notebook power saving).
683 .IP "\fBClickMotionDistance\fR=4 [0\-32]" 4
684 .IX Item "ClickMotionDistance=4 [0-32]"
685 Pointer motion distance before click gets interpreted as drag.
686 .IP "\fBClickMotionDelay\fR=200 [0\-2000]" 4
687 .IX Item "ClickMotionDelay=200 [0-2000]"
688 Delay before click gets interpreted as drag.
689 .IP "\fBMultiClickTime\fR=400 [0\-5000]" 4
690 .IX Item "MultiClickTime=400 [0-5000]"
691 Multiple click time.
692 .IP "\fBMenuActivateDelay\fR=40 [0\-5000]" 4
693 .IX Item "MenuActivateDelay=40 [0-5000]"
694 Delay before activating menu items.
695 .IP "\fBSubmenuMenuActivateDelay\fR=300 [0\-5000]" 4
696 .IX Item "SubmenuMenuActivateDelay=300 [0-5000]"
697 Delay before activating menu submenus.
698 .IP \fBToolTipIcon\fR=1 4
699 .IX Item "ToolTipIcon=1"
700 Show an application icon in toolbar and tray tooltips.
701 .IP "\fBToolTipDelay\fR=1000 [0\-5000]" 4
702 .IX Item "ToolTipDelay=1000 [0-5000]"
703 Delay before tooltip window is displayed.
704 .IP "\fBToolTipTime\fR=0 [0\-60000]" 4
705 .IX Item "ToolTipTime=0 [0-60000]"
706 Time before tooltip window is hidden (0 means never).
707 .IP "\fBAutoHideDelay\fR=300 [0\-5000]" 4
708 .IX Item "AutoHideDelay=300 [0-5000]"
709 Delay before task bar is hidden.
710 .IP "\fBAutoShowDelay\fR=500 [0\-5000]" 4
711 .IX Item "AutoShowDelay=500 [0-5000]"
712 Delay before task bar is shown.
713 .IP "\fBAutoRaiseDelay\fR=400 [0\-5000]" 4
714 .IX Item "AutoRaiseDelay=400 [0-5000]"
715 Delay before windows are auto raised if \f(CW\*(C`AutoRaise=1\*(C'\fR.
716 .IP "\fBPointerFocusDelay\fR=200 [0\-1000]" 4
717 .IX Item "PointerFocusDelay=200 [0-1000]"
718 Delay for pointer focus switching.
719 .IP "\fBEdgeSwitchDelay\fR=600 [0\-5000]" 4
720 .IX Item "EdgeSwitchDelay=600 [0-5000]"
721 Screen edge workspace switching delay.
722 .IP "\fBScrollBarStartDelay\fR=500 [0\-5000]" 4
723 .IX Item "ScrollBarStartDelay=500 [0-5000]"
724 Initial scroll bar autoscroll delay.
725 .IP "\fBScrollBarDelay\fR=30 [0\-5000]" 4
726 .IX Item "ScrollBarDelay=30 [0-5000]"
727 Scroll bar autoscroll delay.
728 .IP "\fBAutoScrollStartDelay\fR=500 [0\-5000]" 4
729 .IX Item "AutoScrollStartDelay=500 [0-5000]"
730 Auto scroll start delay.
731 .IP "\fBAutoScrollDelay\fR=60 [0\-5000]" 4
732 .IX Item "AutoScrollDelay=60 [0-5000]"
733 Auto scroll delay.
734 .IP "\fBWorkspaceStatusTime\fR=2500 [0\-2500]" 4
735 .IX Item "WorkspaceStatusTime=2500 [0-2500]"
736 Time before workspace status window is hidden.
737 .IP "\fBMailCheckDelay\fR=30 [0\-86400]" 4
738 .IX Item "MailCheckDelay=30 [0-86400]"
739 Delay between new\-mail checks. (seconds).
740 .IP "\fBTaskBarCPUDelay\fR=500 [10\-3600000]" 4
741 .IX Item "TaskBarCPUDelay=500 [10-3600000]"
742 Delay between CPU Monitor samples in ms.
743 .IP "\fBTaskBarMEMDelay\fR=500 [10\-3600000]" 4
744 .IX Item "TaskBarMEMDelay=500 [10-3600000]"
745 Delay between Memory Monitor samples in ms.
746 .IP "\fBTaskBarNetDelay\fR=500 [10\-3600000]" 4
747 .IX Item "TaskBarNetDelay=500 [10-3600000]"
748 Delay between Net Monitor samples in ms.
749 .IP "\fBFocusRequestFlashTime\fR=0 [0\-86400]" 4
750 .IX Item "FocusRequestFlashTime=0 [0-86400]"
751 Number of seconds the taskbar app will blink when requesting focus (0 = forever).
752 .IP "\fBFocusRequestFlashInterval\fR=250 [0\-30000]" 4
753 .IX Item "FocusRequestFlashInterval=250 [0-30000]"
754 Taskbar blink interval (ms) when requesting focus (0 = blinking disabled).
755 .IP "\fBBatteryPollingPeriod\fR=10 [2\-3600]" 4
756 .IX Item "BatteryPollingPeriod=10 [2-3600]"
757 Delay between power status updates (seconds).
758 .IP "\fBPingTimeout\fR=3 [0\-86400]" 4
759 .IX Item "PingTimeout=3 [0-86400]"
760 Timeout in seconds for applications to respond to the _NET_WM_PING protocol.
761 .SS "BUTTONS AND KEYS"
762 .IX Subsection "BUTTONS AND KEYS"
763 .IP "\fBUseRootButtons\fR=255 [0\-255]" 4
764 .IX Item "UseRootButtons=255 [0-255]"
765 Bitmask of root window button click to use in window manager.
766 .IP "\fBButtonRaiseMask\fR=1 [0\-255]" 4
767 .IX Item "ButtonRaiseMask=1 [0-255]"
768 Bitmask of buttons that raise the window when pressed.
769 .IP "\fBDesktopWinMenuButton\fR=0 [0\-20]" 4
770 .IX Item "DesktopWinMenuButton=0 [0-20]"
771 Desktop mouse\-button click to show the window list menu.
772 .IP "\fBDesktopWinListButton\fR=2 # [0\-20]" 4
773 .IX Item "DesktopWinListButton=2 # [0-20]"
774 Desktop mouse\-button click to show the window list
775 .IP "\fBDesktopMenuButton\fR=3 [0\-20]" 4
776 .IX Item "DesktopMenuButton=3 [0-20]"
777 Desktop mouse\-button click to show the root menu.
778 .IP "\fBTitleBarMaximizeButton\fR=1 [0\-5]" 4
779 .IX Item "TitleBarMaximizeButton=1 [0-5]"
780 Title bar mouse\-button double\-click to maximize the window to full
781 screen with the frame border visible.
782 Press Shift to maximize only in the vertical direction.
783 Press Alt+Shift to maximize only in the horizontal direction.
784 .IP "\fBTitleBarRollupButton\fR=2 [0\-5]" 4
785 .IX Item "TitleBarRollupButton=2 [0-5]"
786 Title bar mouse\-button double\-click to rollup the window.
787 Press Shift to maximize in the horizontal direction.
788 .SS WORKSPACES
789 .IX Subsection "WORKSPACES"
790 .IP "\fBWorkspaceNames\fR="" 1 "", "" 2 "", "" 3 "", "" 4 """ 4
791 .IX Item "WorkspaceNames="" 1 "", "" 2 "", "" 3 "", "" 4 """
792 Create four workspaces with names \f(CW 1 \fR, \f(CW 2 \fR, \f(CW 3 \fR and \f(CW 4 \fR.
793 .SS PATHS
794 .IX Subsection "PATHS"
795 .IP "\fBIconPath\fR=""/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps""" 4
796 .IX Item "IconPath=""/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps"""
797 Icon search path (colon separated). Also, the icons/ subdirectory in
798 IceWM resource folders are searched first.
799 .IP "\fBIconThemes\fR=""*:\-HighContrast""" 4
800 .IX Item "IconThemes=""*:-HighContrast"""
801 List of icon themes (colon separated), acting as additional filter of
802 icon subdirectories in any of the \fBIconPath\fR folders. Expressions can be
803 wildcards, also special wildcards (starting with \fB\-\fR) can exclude matched
804 themes from selection.
805 .IP "\fBMailBoxPath\fR=""""" 4
806 .IX Item "MailBoxPath="""""
807 A colon separated list of paths of your mailboxes.
808 If this is empty, \f(CW$MAILPATH\fR or \f(CW$MAIL\fR is used instead.
809 .SS PROGRAMS
810 .IX Subsection "PROGRAMS"
811 .IP "\fBMailCommand\fR=""xterm \-name mutt \-e mutt""" 4
812 .IX Item "MailCommand=""xterm -name mutt -e mutt"""
813 Command to run on mailbox.
814 .IP "\fBMailClassHint\fR=""mutt.XTerm""" 4
815 .IX Item "MailClassHint=""mutt.XTerm"""
816 \&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBMailCommand\fR.
817 .IP "\fBNewMailCommand\fR=""""" 4
818 .IX Item "NewMailCommand="""""
819 Command to run when new mail arrives.
820 .IP "\fBLockCommand\fR=""""" 4
821 .IX Item "LockCommand="""""
822 Command to lock display/screensaver.
823 .IP "\fBClockCommand\fR=""xclock \-name icewm \-title Clock""" 4
824 .IX Item "ClockCommand=""xclock -name icewm -title Clock"""
825 Command to run on clock.
826 .IP "\fBClockClassHint\fR=""icewm.XClock""" 4
827 .IX Item "ClockClassHint=""icewm.XClock"""
828 \&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBClockCommand\fR.
829 .IP "\fBRunCommand\fR=""""" 4
830 .IX Item "RunCommand="""""
831 Command to select and run a program.
832 .IP "\fBOpenCommand\fR=""""" 4
833 .IX Item "OpenCommand="""""
834 Command to open a file or directory from the Start menu.
835 .IP "\fBTerminalCommand\fR=""xterm""" 4
836 .IX Item "TerminalCommand=""xterm"""
837 Terminal emulator must accept \-e option.
838 .IP "\fBLogoutCommand\fR=""""" 4
839 .IX Item "LogoutCommand="""""
840 Command to start logout.
841 .IP "\fBLogoutCancelCommand\fR=""""" 4
842 .IX Item "LogoutCancelCommand="""""
843 Command to cancel logout.
844 .IP "\fBShutdownCommand\fR=""/bin/sh \-c ""{ test \-e /run/systemd/system && systemctl poweroff || loginctl poweroff; }""""" 4
845 .IX Item "ShutdownCommand=""/bin/sh -c ""{ test -e /run/systemd/system && systemctl poweroff || loginctl poweroff; }"""""
846 Command to shutdown the system.
847 .IP "\fBRebootCommand\fR=""/bin/sh \-c ""{ test \-e /run/systemd/system && systemctl reboot || loginctl reboot; }""""" 4
848 .IX Item "RebootCommand=""/bin/sh -c ""{ test -e /run/systemd/system && systemctl reboot || loginctl reboot; }"""""
849 Command to reboot the system.
850 .IP "\fBSuspendCommand\fR=""test \-e /run/systemd/system && systemctl suspend || loginctl suspend""" 4
851 .IX Item "SuspendCommand=""test -e /run/systemd/system && systemctl suspend || loginctl suspend"""
852 Command to send the system to standby mode
853 .IP "\fBSuspendCommand\fR=""test \-e /run/systemd/system && systemctl hibernate || loginctl hibernate""" 4
854 .IX Item "SuspendCommand=""test -e /run/systemd/system && systemctl hibernate || loginctl hibernate"""
855 Command to hibernate the system.
856 .IP "\fBCPUStatusCommand\fR=""xterm \-name top \-title Process\e Status \-e top""" 4
857 .IX Item "CPUStatusCommand=""xterm -name top -title Process Status -e top"""
858 Command to run on CPU status.
859 .IP "\fBCPUStatusClassHint\fR=""top.XTerm""" 4
860 .IX Item "CPUStatusClassHint=""top.XTerm"""
861 \&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBCPUStatusCommand\fR.
862 .IP "\fBCPUStatusCombine\fR=1 0/1" 4
863 .IX Item "CPUStatusCombine=1 0/1"
864 Combine all CPUs to one.
865 .IP "\fBNetStatusCommand\fR=""xterm \-name netstat \-title \*(AqNetwork Status\*(Aq \-e netstat \-c""" 4
866 .IX Item "NetStatusCommand=""xterm -name netstat -title 'Network Status' -e netstat -c"""
867 Command to run on Net status.
868 .IP "\fBNetStatusClassHint\fR=""netstat.XTerm""" 4
869 .IX Item "NetStatusClassHint=""netstat.XTerm"""
870 \&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBNetStatusCommand\fR.
871 .IP "\fBAddressBarCommand\fR=""""" 4
872 .IX Item "AddressBarCommand="""""
873 Command to run for address bar entries.
874 .IP "\fBInputIgnorePrefix\fR=""nohup|(nice[[:space:]]+\-n[[:space:]]*[[:digit:]]+)|sudo|(LANG|LC_[[:alnum:]]]*)(=|=[^[:space:]]+)""" 4
875 .IX Item "InputIgnorePrefix=""nohup|(nice[[:space:]]+-n[[:space:]]*[[:digit:]]+)|sudo|(LANG|LC_[[:alnum:]]]*)(=|=[^[:space:]]+)"""
876 Regular expression (POSIX Extended flavor) which marks the begin of a
877 command line in command input fields. Such prefixes are ignored while
878 the auto\-completion action is performed, typically for commands acting
879 as pass\-through wrapper, executing the specified command.
880 .SS "WINDOW MENUS"
881 .IX Subsection "WINDOW MENUS"
882 .IP "\fBWinMenuItems\fR=""rmsnxfhualytiecw""" 4
883 .IX Item "WinMenuItems=""rmsnxfhualytiecw"""
884 Items supported in menu window (rmsnxfhualytieckw)
885 .IP \fBRolloverButtonsSupported\fR=0 4
886 .IX Item "RolloverButtonsSupported=0"
887 Does it support the \*(AqO\*(Aq title bar button images (for mouse rollover).
888 .IP "\fBShowMenuButtonIcon\fR=1 # 0/1" 4
889 .IX Item "ShowMenuButtonIcon=1 # 0/1"
890 Show application icon over menu button
891 .SS "THEME SETTINGS"
892 .IX Subsection "THEME SETTINGS"
893 The following sections show settings that can be set in theme files.
894 They can also be set in the \fIpreferences\fR file, but themes will override
895 the values set there. To override the theme values, the settings should
896 be set in \fIprefoverrides\fR file: see \fBicewm\-prefoverrides\fR\|(5). Default
897 values are shown following the equal sign.
898 .PP
899 \fITHEME DESCRIPTION\fR
900 .IX Subsection "THEME DESCRIPTION"
901 .IP "\fBThemeAuthor\fR=""""" 4
902 .IX Item "ThemeAuthor="""""
903 Theme author, e\-mail address, credits.
904 .IP "\fBThemeDescription\fR=""""" 4
905 .IX Item "ThemeDescription="""""
906 Description of the theme, credits.
907 .IP "\fBLook\fR=""nice""" 4
908 .IX Item "Look=""nice"""
909 Choose a theme look from one of:
910 "win95", "motif", "warp3", "warp4",
911 "nice", "metal2", "gtk2", and some others.
912 .IP "\fBGradients\fR=""""" 4
913 .IX Item "Gradients="""""
914 List of gradient pixmaps in the current theme.
915 .PP
916 \fITHEME BORDERS, ICONS, MARGINS AND BUTTONS\fR
917 .IX Subsection "THEME BORDERS, ICONS, MARGINS AND BUTTONS"
918 .IP "\fBBorderSizeX\fR=6 [0\-128]" 4
919 .IX Item "BorderSizeX=6 [0-128]"
920 Horizontal window border.
921 .IP "\fBBorderSizeY\fR=6 [0\-128]" 4
922 .IX Item "BorderSizeY=6 [0-128]"
923 Vertical window border.
924 .IP "\fBDlgBorderSizeX\fR=2 [0\-128]" 4
925 .IX Item "DlgBorderSizeX=2 [0-128]"
926 Horizontal dialog window border.
927 .IP "\fBDlgBorderSizeY\fR=2 [0\-128]" 4
928 .IX Item "DlgBorderSizeY=2 [0-128]"
929 Vertical dialog window border.
930 .IP "\fBCornerSizeX\fR=24 [0\-64]" 4
931 .IX Item "CornerSizeX=24 [0-64]"
932 Resize corner width.
933 .IP "\fBCornerSizeY\fR=24 [0\-64]" 4
934 .IX Item "CornerSizeY=24 [0-64]"
935 Resize corner height.
936 .IP "\fBTitleBarHeight\fR=20 [0\-128]" 4
937 .IX Item "TitleBarHeight=20 [0-128]"
938 Title bar height.
939 .IP "\fBTitleBarJustify\fR=0 [0\-100]" 4
940 .IX Item "TitleBarJustify=0 [0-100]"
941 Justification of the window title.
942 .IP "\fBTitleBarHorzOffset\fR=0 [\-128\-128]" 4
943 .IX Item "TitleBarHorzOffset=0 [-128-128]"
944 Horizontal offset for the window title text.
945 .IP "\fBTitleBarVertOffset\fR=0 [\-128\-128]" 4
946 .IX Item "TitleBarVertOffset=0 [-128-128]"
947 Vertical offset for the window title text.
948 .IP "\fBMenuButtonIconVertOffset\fR=0 [\-128\-128]" 4
949 .IX Item "MenuButtonIconVertOffset=0 [-128-128]"
950 Vertical offset for the menu button icon.
951 .IP "\fBScrollBarX\fR=16 [0\-64]" 4
952 .IX Item "ScrollBarX=16 [0-64]"
953 Scrollbar width.
954 .IP "\fBScrollBarY\fR=16 [0\-64]" 4
955 .IX Item "ScrollBarY=16 [0-64]"
956 Scrollbar (button) height.
957 .IP "\fBMenuIconSize\fR=16 [8\-128]" 4
958 .IX Item "MenuIconSize=16 [8-128]"
959 Menu icon size.
960 .IP "\fBSmallIconSize\fR=16 [8\-128]" 4
961 .IX Item "SmallIconSize=16 [8-128]"
962 Dimension of the small icons.
963 .IP "\fBLargeIconSize\fR=32 [8\-128]" 4
964 .IX Item "LargeIconSize=32 [8-128]"
965 Dimension of the large icons.
966 .IP "\fBHugeIconSize\fR=48 [8\-128]" 4
967 .IX Item "HugeIconSize=48 [8-128]"
968 Dimension of the large icons.
969 .IP "\fBQuickSwitchHorzMargin\fR=3 [0\-64]" 4
970 .IX Item "QuickSwitchHorzMargin=3 [0-64]"
971 Horizontal margin of the quickswitch window.
972 .IP "\fBQuickSwitchVertMargin\fR=3 [0\-64]" 4
973 .IX Item "QuickSwitchVertMargin=3 [0-64]"
974 Vertical margin of the quickswitch window.
975 .IP "\fBQuickSwitchIconMargin\fR=4 [0\-64]" 4
976 .IX Item "QuickSwitchIconMargin=4 [0-64]"
977 Vertical margin in the quickswitch window.
978 .IP "\fBQuickSwitchIconBorder\fR=2 [0\-64]" 4
979 .IX Item "QuickSwitchIconBorder=2 [0-64]"
980 Distance between the active icon and it\*(Aqs border.
981 .IP "\fBQuickSwitchSeparatorSize\fR=6 [0\-64]" 4
982 .IX Item "QuickSwitchSeparatorSize=6 [0-64]"
983 Height of the separator between (all reachable) icons and text, 0 to avoid it.
984 .IP "\fBTitleButtonsLeft\fR=""s""" 4
985 .IX Item "TitleButtonsLeft=""s"""
986 Titlebar buttons from left to right (x=close, m=max, i=min, h=hide, r=rollup, s=sysmenu, d=depth).
987 .IP "\fBTitleButtonsRight\fR=""xmir""" 4
988 .IX Item "TitleButtonsRight=""xmir"""
989 Titlebar buttons from right to left (x=close, m=max, i=min, h=hide, r=rollup, s=sysmenu, d=depth).
990 .IP "\fBTitleButtonsSupported\fR=""xmis""" 4
991 .IX Item "TitleButtonsSupported=""xmis"""
992 Titlebar buttons supported by theme (x,m,i,r,h,s,d).
993 .IP "\fBTitleBarCentered\fR=0 # 0/1" 4
994 .IX Item "TitleBarCentered=0 # 0/1"
995 Draw window title centered (obsoleted by TitleBarJustify).
996 .IP "\fBTitleBarJoinLeft\fR=0 # 0/1" 4
997 .IX Item "TitleBarJoinLeft=0 # 0/1"
998 Join title*S and title*T.
999 .IP "\fBTitleBarJoinRight\fR=0 # 0/1" 4
1000 .IX Item "TitleBarJoinRight=0 # 0/1"
1001 Join title*T and title*B.
1002 .IP "\fBTaskBarClockLeds\fR=0 # 0/1" 4
1003 .IX Item "TaskBarClockLeds=0 # 0/1"
1004 Task bar clock/battery monitor uses nice pixmap LCD display (but then it
1005 doesn\*(Aqt display correctly in many languages anymore, e.g., for
1006 Japanese and Korean it works only when a real font is used and not
1007 the LCD pixmaps.)
1008 .IP "\fBTaskBarGraphHeight\fR=20 [16\-1000]" 4
1009 .IX Item "TaskBarGraphHeight=20 [16-1000]"
1010 Height of taskbar monitoring applets.
1011 .IP "\fBTaskbuttonIconOffset\fR=0 # [0\-16]" 4
1012 .IX Item "TaskbuttonIconOffset=0 # [0-16]"
1013 Width of taskbutton side icons.
1014 .IP "\fBTrayIconMaxWidth\fR=32 # [16\-128]" 4
1015 .IX Item "TrayIconMaxWidth=32 # [16-128]"
1016 Maximum scaled width of tray icons.
1017 .IP "\fBTrayIconMaxHeight\fR=24 # [16\-128]" 4
1018 .IX Item "TrayIconMaxHeight=24 # [16-128]"
1019 Maximum scaled height of tray icons.
1020 .IP "\fBTrayDrawBevel\fR=0 # 0/1" 4
1021 .IX Item "TrayDrawBevel=0 # 0/1"
1022 Surround the tray with plastic border.
1023 .PP
1024 \fITHEME FONTS\fR
1025 .IX Subsection "THEME FONTS"
1026 .IP "\fBTitleFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1027 .IX Item "TitleFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1028 .PD 0
1029 .IP "\fBTitleFontNameXft\fR=""sans\-serif:size=12""" 4
1030 .IX Item "TitleFontNameXft=""sans-serif:size=12"""
1031 .PD
1032 Name of the title bar font.
1033 .IP "\fBMenuFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-100\-*\-*\-*\-*\-*\-*""" 4
1034 .IX Item "MenuFontName=""-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"""
1035 .PD 0
1036 .IP "\fBMenuFontNameXft\fR=""sans\-serif:size=10:bold""" 4
1037 .IX Item "MenuFontNameXft=""sans-serif:size=10:bold"""
1038 .PD
1039 Name of the menu font.
1040 .IP "\fBStatusFontName\fR=""\-*\-monospace\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1041 .IX Item "StatusFontName=""-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"""
1042 .PD 0
1043 .IP "\fBStatusFontNameXft\fR=""monospace:size=12:bold""" 4
1044 .IX Item "StatusFontNameXft=""monospace:size=12:bold"""
1045 .PD
1046 Name of the status display font.
1047 .IP "\fBQuickSwitchFontName\fR=""\-*\-monospace\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1048 .IX Item "QuickSwitchFontName=""-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"""
1049 .PD 0
1050 .IP "\fBQuickSwitchFontNameXft\fR=""monospace:size=12:bold""" 4
1051 .IX Item "QuickSwitchFontNameXft=""monospace:size=12:bold"""
1052 .PD
1053 Name of the font for Alt+Tab switcher window.
1054 .IP "\fBNormalButtonFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1055 .IX Item "NormalButtonFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1056 .PD 0
1057 .IP "\fBNormalButtonFontNameXft\fR=""sans\-serif:size=12""" 4
1058 .IX Item "NormalButtonFontNameXft=""sans-serif:size=12"""
1059 .PD
1060 Name of the normal button font.
1061 .IP "\fBActiveButtonFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1062 .IX Item "ActiveButtonFontName=""-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"""
1063 .PD 0
1064 .IP "\fBActiveButtonFontNameXft\fR=""sans\-serif:size=12:bold""" 4
1065 .IX Item "ActiveButtonFontNameXft=""sans-serif:size=12:bold"""
1066 .PD
1067 Name of the active button font.
1068 .IP "\fBNormalTaskBarFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1069 .IX Item "NormalTaskBarFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1070 .PD 0
1071 .IP "\fBNormalTaskBarFontNameXft\fR=""sans\-serif:size=12""" 4
1072 .IX Item "NormalTaskBarFontNameXft=""sans-serif:size=12"""
1073 .PD
1074 Name of the normal task bar item font.
1075 .IP "\fBActiveTaskBarFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1076 .IX Item "ActiveTaskBarFontName=""-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"""
1077 .PD 0
1078 .IP "\fBActiveTaskBarFontNameXft\fR=""sans\-serif:size=12:bold""" 4
1079 .IX Item "ActiveTaskBarFontNameXft=""sans-serif:size=12:bold"""
1080 .PD
1081 Name of the active task bar item font.
1082 .IP "\fBToolButtonFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1083 .IX Item "ToolButtonFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1084 .PD 0
1085 .IP "\fBToolButtonFontNameXft\fR=""sans\-serif:size=12""" 4
1086 .IX Item "ToolButtonFontNameXft=""sans-serif:size=12"""
1087 .PD
1088 Name of the tool button font (fallback: NormalButtonFontName).
1089 .IP "\fBNormalWorkspaceFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1090 .IX Item "NormalWorkspaceFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1091 .PD 0
1092 .IP "\fBNormalWorkspaceFontNameXft\fR=""sans\-serif:size=12""" 4
1093 .IX Item "NormalWorkspaceFontNameXft=""sans-serif:size=12"""
1094 .PD
1095 Name of the normal workspace button font (fallback: NormalButtonFontName).
1096 .IP "\fBActiveWorkspaceFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1097 .IX Item "ActiveWorkspaceFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1098 .PD 0
1099 .IP "\fBActiveWorkspaceFontNameXft\fR=""sans\-serif:size=12""" 4
1100 .IX Item "ActiveWorkspaceFontNameXft=""sans-serif:size=12"""
1101 .PD
1102 Name of the active workspace button font (fallback: ActiveButtonFontName).
1103 .IP "\fBMinimizedWindowFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1104 .IX Item "MinimizedWindowFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1105 .PD 0
1106 .IP "\fBMinimizedWindowFontNameXft\fR=""sans\-serif:size=12""" 4
1107 .IX Item "MinimizedWindowFontNameXft=""sans-serif:size=12"""
1108 .PD
1109 Name of the mini\-window font.
1110 .IP "\fBListBoxFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1111 .IX Item "ListBoxFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1112 .PD 0
1113 .IP "\fBListBoxFontNameXft\fR=""sans\-serif:size=12""" 4
1114 .IX Item "ListBoxFontNameXft=""sans-serif:size=12"""
1115 .PD
1116 Name of the window list font.
1117 .IP "\fBToolTipFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4
1118 .IX Item "ToolTipFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"""
1119 .PD 0
1120 .IP "\fBToolTipFontNameXft\fR=""sans\-serif:size=12""" 4
1121 .IX Item "ToolTipFontNameXft=""sans-serif:size=12"""
1122 .PD
1123 Name of the tool tip font.
1124 .IP "\fBClockFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1125 .IX Item "ClockFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"""
1126 .PD 0
1127 .IP "\fBClockFontNameXft\fR=""monospace:size=12""" 4
1128 .IX Item "ClockFontNameXft=""monospace:size=12"""
1129 .PD
1130 Name of the task bar clock font.
1131 .IP "\fBTempFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1132 .IX Item "TempFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"""
1133 .PD 0
1134 .IP "\fBTempFontNameXft\fR=""monospace:size=12""" 4
1135 .IX Item "TempFontNameXft=""monospace:size=12"""
1136 .PD
1137 Name of the task bar temperature font.
1138 .IP "\fBApmFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1139 .IX Item "ApmFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"""
1140 .PD 0
1141 .IP "\fBApmFontNameXft\fR=""monospace:size=12""" 4
1142 .IX Item "ApmFontNameXft=""monospace:size=12"""
1143 .PD
1144 Name of the task bar battery font.
1145 .IP "\fBInputFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1146 .IX Item "InputFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"""
1147 .PD 0
1148 .IP "\fBInputFontNameXft\fR=""monospace:size=12""" 4
1149 .IX Item "InputFontNameXft=""monospace:size=12"""
1150 .PD
1151 Name of the input field font.
1152 .IP "\fBLabelFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4
1153 .IX Item "LabelFontName=""-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"""
1154 .PD 0
1155 .IP "\fBLabelFontNameXft\fR=""sans\-serif:size=12""" 4
1156 .IX Item "LabelFontNameXft=""sans-serif:size=12"""
1157 .PD
1158 Name of the label font.
1159 .PP
1160 \fITHEME COLORS\fR
1161 .IX Subsection "THEME COLORS"
1162 .IP "\fBColorDialog\fR = ""rgb:C0/C0/C0""" 4
1163 .IX Item "ColorDialog = ""rgb:C0/C0/C0"""
1164 Background of dialog windows.
1165 .IP "\fBColorNormalBorder\fR = ""rgb:C0/C0/C0""" 4
1166 .IX Item "ColorNormalBorder = ""rgb:C0/C0/C0"""
1167 Border of inactive windows.
1168 .IP "\fBColorActiveBorder\fR = ""rgb:C0/C0/C0""" 4
1169 .IX Item "ColorActiveBorder = ""rgb:C0/C0/C0"""
1170 Border of active windows.
1171 .IP "\fBColorNormalButton\fR = ""rgb:C0/C0/C0""" 4
1172 .IX Item "ColorNormalButton = ""rgb:C0/C0/C0"""
1173 Background of regular buttons.
1174 .IP "\fBColorNormalButtonText\fR = ""rgb:00/00/00""" 4
1175 .IX Item "ColorNormalButtonText = ""rgb:00/00/00"""
1176 Text color of regular buttons.
1177 .IP "\fBColorActiveButton\fR = ""rgb:E0/E0/E0""" 4
1178 .IX Item "ColorActiveButton = ""rgb:E0/E0/E0"""
1179 Background of pressed buttons.
1180 .IP "\fBColorActiveButtonText\fR = ""rgb:00/00/00""" 4
1181 .IX Item "ColorActiveButtonText = ""rgb:00/00/00"""
1182 Text color of pressed buttons.
1183 .IP "\fBColorNormalTitleButton\fR = ""rgb:C0/C0/C0""" 4
1184 .IX Item "ColorNormalTitleButton = ""rgb:C0/C0/C0"""
1185 Background of titlebar buttons.
1186 .IP "\fBColorNormalTitleButtonText\fR = ""rgb:00/00/00""" 4
1187 .IX Item "ColorNormalTitleButtonText = ""rgb:00/00/00"""
1188 Text color of titlebar buttons.
1189 .IP "\fBColorToolButton\fR = """"" 4
1190 .IX Item "ColorToolButton = """""
1191 Background of toolbar buttons, ColorNormalButton is used if empty.
1192 .IP "\fBColorToolButtonText\fR = """"" 4
1193 .IX Item "ColorToolButtonText = """""
1194 Text color of toolbar buttons, ColorNormalButtonText is used if empty.
1195 .IP "\fBColorNormalWorkspaceButton\fR = """"" 4
1196 .IX Item "ColorNormalWorkspaceButton = """""
1197 Background of workspace buttons, ColorNormalButton is used if empty.
1198 .IP "\fBColorNormalWorkspaceButtonText\fR = """"" 4
1199 .IX Item "ColorNormalWorkspaceButtonText = """""
1200 Text color of workspace buttons, ColorNormalButtonText is used if empty.
1201 .IP "\fBColorActiveWorkspaceButton\fR = """"" 4
1202 .IX Item "ColorActiveWorkspaceButton = """""
1203 Background of the active workspace button, ColorActiveButton is used if empty.
1204 .IP "\fBColorActiveWorkspaceButtonText\fR = """"" 4
1205 .IX Item "ColorActiveWorkspaceButtonText = """""
1206 Text color of the active workspace button, ColorActiveButtonText is used if empty.
1207 .IP "\fBColorNormalTitleBar\fR = ""rgb:80/80/80""" 4
1208 .IX Item "ColorNormalTitleBar = ""rgb:80/80/80"""
1209 Background of the titlebar of regular windows.
1210 .IP "\fBColorNormalTitleBarText\fR = ""rgb:00/00/00""" 4
1211 .IX Item "ColorNormalTitleBarText = ""rgb:00/00/00"""
1212 Text color of the titlebar of regular windows.
1213 .IP "\fBColorNormalTitleBarShadow\fR = """"" 4
1214 .IX Item "ColorNormalTitleBarShadow = """""
1215 Text shadow of the titlebar of regular windows.
1216 .IP "\fBColorActiveTitleBar\fR = ""rgb:00/00/A0""" 4
1217 .IX Item "ColorActiveTitleBar = ""rgb:00/00/A0"""
1218 Background of the titlebar of active windows.
1219 .IP "\fBColorActiveTitleBarText\fR = ""rgb:FF/FF/FF""" 4
1220 .IX Item "ColorActiveTitleBarText = ""rgb:FF/FF/FF"""
1221 Text color of the titlebar of active windows.
1222 .IP "\fBColorActiveTitleBarShadow\fR = """"" 4
1223 .IX Item "ColorActiveTitleBarShadow = """""
1224 Text shadow of the titlebar of active windows.
1225 .IP "\fBColorNormalMinimizedWindow\fR = ""rgb:C0/C0/C0""" 4
1226 .IX Item "ColorNormalMinimizedWindow = ""rgb:C0/C0/C0"""
1227 Background for mini icons of regular windows.
1228 .IP "\fBColorNormalMinimizedWindowText\fR = ""rgb:00/00/00""" 4
1229 .IX Item "ColorNormalMinimizedWindowText = ""rgb:00/00/00"""
1230 Text color for mini icons of regular windows.
1231 .IP "\fBColorActiveMinimizedWindow\fR = ""rgb:E0/E0/E0""" 4
1232 .IX Item "ColorActiveMinimizedWindow = ""rgb:E0/E0/E0"""
1233 Background for mini icons of active windows.
1234 .IP "\fBColorActiveMinimizedWindowText\fR = ""rgb:00/00/00""" 4
1235 .IX Item "ColorActiveMinimizedWindowText = ""rgb:00/00/00"""
1236 Text color for mini icons of active windows.
1237 .IP "\fBColorNormalMenu\fR = ""rgb:C0/C0/C0""" 4
1238 .IX Item "ColorNormalMenu = ""rgb:C0/C0/C0"""
1239 Background of pop\-up menus.
1240 .IP "\fBColorNormalMenuItemText\fR = ""rgb:00/00/00""" 4
1241 .IX Item "ColorNormalMenuItemText = ""rgb:00/00/00"""
1242 Text color of regular menu items.
1243 .IP "\fBColorActiveMenuItem\fR = ""rgb:A0/A0/A0""" 4
1244 .IX Item "ColorActiveMenuItem = ""rgb:A0/A0/A0"""
1245 Background of selected menu item, leave empty to force transparency.
1246 .IP "\fBColorActiveMenuItemText\fR = ""rgb:00/00/00""" 4
1247 .IX Item "ColorActiveMenuItemText = ""rgb:00/00/00"""
1248 Text color of selected menu items.
1249 .IP "\fBColorDisabledMenuItemText\fR = ""rgb:80/80/80""" 4
1250 .IX Item "ColorDisabledMenuItemText = ""rgb:80/80/80"""
1251 Text color of disabled menu items.
1252 .IP "\fBColorDisabledMenuItemShadow\fR = """"" 4
1253 .IX Item "ColorDisabledMenuItemShadow = """""
1254 Shadow of regular menu items.
1255 .IP "\fBColorMoveSizeStatus\fR = ""rgb:C0/C0/C0""" 4
1256 .IX Item "ColorMoveSizeStatus = ""rgb:C0/C0/C0"""
1257 Background of move/resize status window.
1258 .IP "\fBColorMoveSizeStatusText\fR = ""rgb:00/00/00""" 4
1259 .IX Item "ColorMoveSizeStatusText = ""rgb:00/00/00"""
1260 Text color of move/resize status window.
1261 .IP "\fBColorQuickSwitch\fR = ""rgb:C0/C0/C0""" 4
1262 .IX Item "ColorQuickSwitch = ""rgb:C0/C0/C0"""
1263 Background of the quick switch window.
1264 .IP "\fBColorQuickSwitchText\fR = ""rgb:00/00/00""" 4
1265 .IX Item "ColorQuickSwitchText = ""rgb:00/00/00"""
1266 Text color in the quick switch window.
1267 .IP "\fBColorQuickSwitchActive\fR = """"" 4
1268 .IX Item "ColorQuickSwitchActive = """""
1269 Rectangle around the active icon in the quick switch window.
1270 .IP "\fBColorQuickSwitchBorder\fR = """"" 4
1271 .IX Item "ColorQuickSwitchBorder = """""
1272 The color for the quick switch border. When empty, a one pixel wide
1273 elevation border will be drawn, based on the quick switch background.
1274 .IP "\fBColorDefaultTaskBar\fR = ""rgb:C0/C0/C0""" 4
1275 .IX Item "ColorDefaultTaskBar = ""rgb:C0/C0/C0"""
1276 Background of the taskbar.
1277 .IP "\fBColorNormalTaskBarApp\fR = ""rgb:C0/C0/C0""" 4
1278 .IX Item "ColorNormalTaskBarApp = ""rgb:C0/C0/C0"""
1279 Background for task buttons of regular windows.
1280 .IP "\fBColorNormalTaskBarAppText\fR = ""rgb:00/00/00""" 4
1281 .IX Item "ColorNormalTaskBarAppText = ""rgb:00/00/00"""
1282 Text color for task buttons of regular windows.
1283 .IP "\fBColorActiveTaskBarApp\fR = ""rgb:E0/E0/E0""" 4
1284 .IX Item "ColorActiveTaskBarApp = ""rgb:E0/E0/E0"""
1285 Background for task buttons of the active window.
1286 .IP "\fBColorActiveTaskBarAppText\fR = ""rgb:00/00/00""" 4
1287 .IX Item "ColorActiveTaskBarAppText = ""rgb:00/00/00"""
1288 Text color for task buttons of the active window.
1289 .IP "\fBColorMinimizedTaskBarApp\fR = ""rgb:A0/A0/A0""" 4
1290 .IX Item "ColorMinimizedTaskBarApp = ""rgb:A0/A0/A0"""
1291 Background for task buttons of minimized windows.
1292 .IP "\fBColorMinimizedTaskBarAppText\fR = ""rgb:00/00/00""" 4
1293 .IX Item "ColorMinimizedTaskBarAppText = ""rgb:00/00/00"""
1294 Text color for task buttons of minimized windows.
1295 .IP "\fBColorInvisibleTaskBarApp\fR = ""rgb:80/80/80""" 4
1296 .IX Item "ColorInvisibleTaskBarApp = ""rgb:80/80/80"""
1297 Background for task buttons of windows on other workspaces.
1298 .IP "\fBColorInvisibleTaskBarAppText\fR = ""rgb:00/00/00""" 4
1299 .IX Item "ColorInvisibleTaskBarAppText = ""rgb:00/00/00"""
1300 Text color for task buttons of windows on other workspaces.
1301 .IP "\fBColorScrollBar\fR = ""rgb:A0/A0/A0""" 4
1302 .IX Item "ColorScrollBar = ""rgb:A0/A0/A0"""
1303 Scrollbar background (sliding area).
1304 .IP "\fBColorScrollBarSlider\fR = ""rgb:C0/C0/C0""" 4
1305 .IX Item "ColorScrollBarSlider = ""rgb:C0/C0/C0"""
1306 Background of the slider button in scrollbars.
1307 .IP "\fBColorScrollBarButton\fR = ""rgb:C0/C0/C0""" 4
1308 .IX Item "ColorScrollBarButton = ""rgb:C0/C0/C0"""
1309 Background of the arrow buttons in scrollbars.
1310 .IP "\fBColorScrollBarArrow\fR = ""rgb:C0/C0/C0""" 4
1311 .IX Item "ColorScrollBarArrow = ""rgb:C0/C0/C0"""
1312 Background of the arrow buttons in scrollbars (obsolete).
1313 .IP "\fBColorScrollBarButtonArrow\fR = ""rgb:00/00/00""" 4
1314 .IX Item "ColorScrollBarButtonArrow = ""rgb:00/00/00"""
1315 Color of active arrows on scrollbar buttons.
1316 .IP "\fBColorScrollBarInactiveArrow\fR = ""rgb:80/80/80""" 4
1317 .IX Item "ColorScrollBarInactiveArrow = ""rgb:80/80/80"""
1318 Color of inactive arrows on scrollbar buttons.
1319 .IP "\fBColorListBox\fR = ""rgb:C0/C0/C0""" 4
1320 .IX Item "ColorListBox = ""rgb:C0/C0/C0"""
1321 Background of listboxes.
1322 .IP "\fBColorListBoxText\fR = ""rgb:00/00/00""" 4
1323 .IX Item "ColorListBoxText = ""rgb:00/00/00"""
1324 Text color in listboxes.
1325 .IP "\fBColorListBoxSelection\fR = ""rgb:80/80/80""" 4
1326 .IX Item "ColorListBoxSelection = ""rgb:80/80/80"""
1327 Background of selected listbox items.
1328 .IP "\fBColorListBoxSelectionText\fR = ""rgb:00/00/00""" 4
1329 .IX Item "ColorListBoxSelectionText = ""rgb:00/00/00"""
1330 Text color of selected listbox items.
1331 .IP "\fBColorToolTip\fR = ""rgb:E0/E0/00""" 4
1332 .IX Item "ColorToolTip = ""rgb:E0/E0/00"""
1333 Background of tooltips.
1334 .IP "\fBColorToolTipText\fR = ""rgb:00/00/00""" 4
1335 .IX Item "ColorToolTipText = ""rgb:00/00/00"""
1336 Text color of tooltips.
1337 .IP "\fBColorLabel\fR = ""rgb:C0/C0/C0""" 4
1338 .IX Item "ColorLabel = ""rgb:C0/C0/C0"""
1339 Background of labels, leave empty to force transparency.
1340 .IP "\fBColorLabelText\fR = ""rgb:00/00/00""" 4
1341 .IX Item "ColorLabelText = ""rgb:00/00/00"""
1342 Text color of labels.
1343 .IP "\fBColorInput\fR = ""rgb:FF/FF/FF""" 4
1344 .IX Item "ColorInput = ""rgb:FF/FF/FF"""
1345 Background of text entry fields (e.g., the addressbar).
1346 .IP "\fBColorInputText\fR = ""rgb:00/00/00""" 4
1347 .IX Item "ColorInputText = ""rgb:00/00/00"""
1348 Text color of text entry fields (e.g., the addressbar).
1349 .IP "\fBColorInputSelection\fR = ""rgb:80/80/80""" 4
1350 .IX Item "ColorInputSelection = ""rgb:80/80/80"""
1351 Background of selected text in an entry field.
1352 .IP "\fBColorInputSelectionText\fR = ""rgb:00/00/00""" 4
1353 .IX Item "ColorInputSelectionText = ""rgb:00/00/00"""
1354 Selected text in an entry field.
1355 .IP "\fBColorClock\fR = ""rgb:00/00/00""" 4
1356 .IX Item "ColorClock = ""rgb:00/00/00"""
1357 Background of non\-LCD clock, leave empty to force transparency.
1358 .IP "\fBColorClockText\fR = ""rgb:00/FF/00""" 4
1359 .IX Item "ColorClockText = ""rgb:00/FF/00"""
1360 Text color of non\-LCD clock.
1361 .IP "\fBColorKeyboardLayoutText\fR = """"" 4
1362 .IX Item "ColorKeyboardLayoutText = """""
1363 Color of keyboard layout indicator.
1364 .IP "\fBColorApm\fR = ""rgb:00/00/00""" 4
1365 .IX Item "ColorApm = ""rgb:00/00/00"""
1366 Background of battery monitor, leave empty to force transparency.
1367 .IP "\fBColorApmText\fR = ""rgb:00/FF/00""" 4
1368 .IX Item "ColorApmText = ""rgb:00/FF/00"""
1369 Text color of battery monitor.
1370 .IP "\fBColorApmBattery\fR = ""rgb:FF/FF/00""" 4
1371 .IX Item "ColorApmBattery = ""rgb:FF/FF/00"""
1372 Color of battery monitor when discharging.
1373 .IP "\fBColorApmLine\fR = ""rgb:00/FF/00""" 4
1374 .IX Item "ColorApmLine = ""rgb:00/FF/00"""
1375 Color of battery monitor when charging.
1376 .IP "\fBColorApmGraphBg\fR = ""rgb:00/00/00""" 4
1377 .IX Item "ColorApmGraphBg = ""rgb:00/00/00"""
1378 Background color for graph mode.
1379 .IP "\fBColorCPUStatusUser\fR = ""rgb:00/FF/00""" 4
1380 .IX Item "ColorCPUStatusUser = ""rgb:00/FF/00"""
1381 User load on the CPU monitor.
1382 .IP "\fBColorCPUStatusSystem\fR = ""rgb:FF/00/00""" 4
1383 .IX Item "ColorCPUStatusSystem = ""rgb:FF/00/00"""
1384 System load on the CPU monitor.
1385 .IP "\fBColorCPUStatusInterrupts\fR = ""rgb:FF/FF/00""" 4
1386 .IX Item "ColorCPUStatusInterrupts = ""rgb:FF/FF/00"""
1387 Interrupts on the CPU monitor.
1388 .IP "\fBColorCPUStatusIoWait\fR = ""rgb:60/00/60""" 4
1389 .IX Item "ColorCPUStatusIoWait = ""rgb:60/00/60"""
1390 IO Wait on the CPU monitor.
1391 .IP "\fBColorCPUStatusSoftIrq\fR = ""rgb:00/FF/FF""" 4
1392 .IX Item "ColorCPUStatusSoftIrq = ""rgb:00/FF/FF"""
1393 Soft Interrupts on the CPU monitor.
1394 .IP "\fBColorCPUStatusNice\fR = ""rgb:00/00/FF""" 4
1395 .IX Item "ColorCPUStatusNice = ""rgb:00/00/FF"""
1396 Nice load on the CPU monitor.
1397 .IP "\fBColorCPUStatusIdle\fR = ""rgb:00/00/00""" 4
1398 .IX Item "ColorCPUStatusIdle = ""rgb:00/00/00"""
1399 Idle (non) load on the CPU monitor, leave empty to force
1400 transparency.
1401 .IP "\fBColorCPUStatusSteal\fR = ""rgb:FF/8A/91""" 4
1402 .IX Item "ColorCPUStatusSteal = ""rgb:FF/8A/91"""
1403 Involuntary Wait on the CPU monitor.
1404 .IP "\fBColorCPUStatusTemp\fR = ""rgb:60/60/C0""" 4
1405 .IX Item "ColorCPUStatusTemp = ""rgb:60/60/C0"""
1406 Temperature of the CPU.
1407 .IP "\fBColorMEMStatusUser\fR = ""rgb:40/40/80""" 4
1408 .IX Item "ColorMEMStatusUser = ""rgb:40/40/80"""
1409 User program usage in the memory monitor.
1410 .IP "\fBColorMEMStatusBuffers\fR = ""rgb:60/60/C0""" 4
1411 .IX Item "ColorMEMStatusBuffers = ""rgb:60/60/C0"""
1412 OS buffers usage in the memory monitor.
1413 .IP "\fBColorMEMStatusCached\fR = ""rgb:80/80/FF""" 4
1414 .IX Item "ColorMEMStatusCached = ""rgb:80/80/FF"""
1415 OS cached usage in the memory monitor.
1416 .IP "\fBColorMEMStatusFree\fR = ""rgb:00/00/00""" 4
1417 .IX Item "ColorMEMStatusFree = ""rgb:00/00/00"""
1418 Free memory in the memory monitor.
1419 .IP "\fBColorNetSend\fR = ""rgb:FF/FF/00""" 4
1420 .IX Item "ColorNetSend = ""rgb:FF/FF/00"""
1421 Outgoing load on the network monitor.
1422 .IP "\fBColorNetReceive\fR = ""rgb:FF/00/FF""" 4
1423 .IX Item "ColorNetReceive = ""rgb:FF/00/FF"""
1424 Incoming load on the network monitor.
1425 .IP "\fBColorNetIdle\fR = ""rgb:00/00/00""" 4
1426 .IX Item "ColorNetIdle = ""rgb:00/00/00"""
1427 Idle (non) load on the network monitor, leave empty to force transparency.
1428 .PP
1429 \fIDESKTOP BACKGROUND\fR
1430 .IX Subsection "DESKTOP BACKGROUND"
1431 .PP
1432 The following themeable preferences are read by \fBicewmbg\fR\|(1):
1433 .IP "\fBDesktopBackgroundCenter\fR=0 0/1" 4
1434 .IX Item "DesktopBackgroundCenter=0 0/1"
1435 Display desktop background centered and not tiled.
1436 .IP "\fBDesktopBackgroundScaled\fR=0 0/1" 4
1437 .IX Item "DesktopBackgroundScaled=0 0/1"
1438 Resize desktop background to full screen.
1439 .IP "\fBDesktopBackgroundColor\fR=""""" 4
1440 .IX Item "DesktopBackgroundColor="""""
1441 A comma\-separated list of zero or more desktop background colors.
1442 .IP "\fBDesktopBackgroundImage\fR=""""" 4
1443 .IX Item "DesktopBackgroundImage="""""
1444 A comma\-separated list of zero or more desktop background images.
1445 Each image may be a path with a \fBglob\fR\|(7) pattern, or start with a
1446 tilde or environment variable.
1447 .IP "\fBShuffleBackgroundImages\fR=0 0/1" 4
1448 .IX Item "ShuffleBackgroundImages=0 0/1"
1449 Choose a random selection from the list of background images.
1450 .IP "\fBSupportSemitransparency\fR=1 0/1" 4
1451 .IX Item "SupportSemitransparency=1 0/1"
1452 Support for semitransparent terminals like Eterm or gnome\-terminal.
1453 .IP "\fBDesktopTransparencyColor\fR=""""" 4
1454 .IX Item "DesktopTransparencyColor="""""
1455 Color(s) to announce for semitransparent windows.
1456 .IP "\fBDesktopTransparencyImage\fR=""""" 4
1457 .IX Item "DesktopTransparencyImage="""""
1458 Image(s) to announce for semitransparent windows.
1459 This is a list similar to \fBDesktopBackgroundImage\fR.
1460 .IP "\fBDesktopBackgroundMultihead\fR=0 0/1" 4
1461 .IX Item "DesktopBackgroundMultihead=0 0/1"
1462 Paint the background image over all multihead monitors combined.
1463 .IP \fBCycleBackgroundsPeriod\fR=0 4
1464 .IX Item "CycleBackgroundsPeriod=0"
1465 Seconds between cycling over all background images, default zero is off.
1466 .SS EXAMPLES
1467 .IX Subsection "EXAMPLES"
1468 .Vb 10
1469 \& Alpha=1
1470 \& Splash="IceWM.jpg"
1471 \& LimitSize=0
1472 \& LimitPosition=0
1473 \& LimitByDockLayer=1
1474 \& QuickSwitchToAllWorkspaces=1
1475 \& QuickSwitchHugeIcon=1
1476 \& QuickSwitchFillSelection=1
1477 \& TaskBarMailboxStatusBeepOnNewMail=1
1478 \& TaskBarMailboxStatusCountMessages=1
1479 \& TaskBarShowMEMStatus=0
1480 \& TaskBarShowCollapseButton=1
1481 \& TaskBarWorkspacesLimit="8"
1482 \& ShowProgramsMenu=1
1483 \& ShowAddressBar=0
1484 \& ToolTipDelay=200
1485 \& ToolTipTime=5000
1486 \& AutoHideDelay=900
1487 \& AutoShowDelay=100
1488 \& EdgeResistance=3
1489 \& KeySysWinMenu=""
1490 \& KeySysWinListMenu="Shift+Ctrl+Esc"
1491 .Ve
1492 .PP
1493 The above example shows how to tell \fBicewm\fR to not bind a specific key:
1494 \&\fIKeySysWinMenu\fR in this case.
1495 .SS FILES
1496 .IX Subsection "FILES"
1497 Locations for the \fIpreferences\fR file are as follows:
1498 .PP
1499 .Vb 5
1500 \& $ICEWM_PRIVCFG/preferences
1501 \& $XDG_CONFIG_HOME/icewm/preferences
1502 \& $HOME/.icewm/preferences
1503 \& /etc/icewm/preferences
1504 \& /usr/share/icewm/preferences
1505 .Ve
1506 .PP
1507 The locations are searched in the order listed; the first file found is
1508 read and the remainder ignored.
1509 .SS "SEE ALSO"
1510 .IX Subsection "SEE ALSO"
1511 \&\fBicewm\fR\|(1),
1512 \&\fBicewm\-prefoverride\fR\|(5).
1513 .SS AUTHOR
1514 .IX Subsection "AUTHOR"
1515 Brian Bidulock <mailto:[email protected]>.
1516 .SS LICENSE
1517 .IX Subsection "LICENSE"
1518 \&\fBIceWM\fR is licensed under the GNU Library General Public License.
1519 See the \fICOPYING\fR file in the distribution.