Debian Codegraph @

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

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\" ========================================================================
56 .\"
57 .IX Title "ICEWM-PREFERENCES 5"
58 .TH ICEWM-PREFERENCES 5 2025-05-03 "icewm\ 3.7.4" "Standards, Environments and Macros"
59 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
60 .\" way too many mistakes in technical documents.
61 .if n .ad l
62 .nh
63 .SS NAME
64 .IX Subsection "NAME"
65 .Vb 1
66 \& icewm\-preferences \- icewm preferences configuration file
67 .Ve
68 .SS SYNOPSIS
69 .IX Subsection "SYNOPSIS"
70 .Vb 5
71 \& $ICEWM_PRIVCFG/preferences
72 \& $XDG_CONFIG_HOME/icewm/preferences
73 \& $HOME/.icewm/preferences
74 \& /etc/X11/icewm/preferences
75 \& /usr/share/icewm/preferences
76 .Ve
77 .SS DESCRIPTION
78 .IX Subsection "DESCRIPTION"
79 Contains general settings like paths, colors and fonts, but also options
80 to control the \fBicewm\fR focus behaviour and the applets that are
81 started in the task bar. The \fBicewm\fR installation will provide a
82 default \fIpreferences\fR file, that can be copied to the \fBicewm\fR user
83 configuration directory and modified.
84 .SS FORMAT
85 .IX Subsection "FORMAT"
86 .SS "FOCUS AND BEHAVIOR"
87 .IX Subsection "FOCUS AND BEHAVIOR"
88 The following preferences affect focus and general behavior of
89 \&\fBicewm\fR\|(1):
90 .IP \fBAlpha\fR=0 4
91 .IX Item "Alpha=0"
92 Use a 32\-bit visual for alpha blending
93 .IP \fBSynchronize\fR=0 4
94 .IX Item "Synchronize=0"
95 Synchronize X11 for debugging (slow)
96 .IP \fBLogEvents\fR=0 4
97 .IX Item "LogEvents=0"
98 Enable event logging for debugging
99 .IP "\fBOutputFile\fR=""""" 4
100 .IX Item "OutputFile="""""
101 Redirect all output to \fIFILE\fR.
102 A leading tilde or environment variable is expanded.
103 This file is truncated on startup if it exceeds 5 KB.
104 .IP "\fBSplash\fR=""""" 4
105 .IX Item "Splash="""""
106 Splash image on startup (IceWM.jpg)
107 .IP "\fBTrace\fR=""""" 4
108 .IX Item "Trace="""""
109 Enable tracing for the given list of modules.
110 Modules that are traceable include \fBconf, font, icon, prog, systray\fR.
111 .IP \fBClickToFocus\fR=1 4
112 .IX Item "ClickToFocus=1"
113 Focus windows by clicking in them.
114 .IP \fBFocusOnAppRaise\fR=0 4
115 .IX Item "FocusOnAppRaise=0"
116 Focus windows when applications request that they be raised.
117 .IP \fBRequestFocusOnAppRaise\fR=1 4
118 .IX Item "RequestFocusOnAppRaise=1"
119 Request focus (flashing in taskbar) when application requests raise.
120 .IP \fBRaiseOnFocus\fR=1 4
121 .IX Item "RaiseOnFocus=1"
122 Raise windows when focused.
123 .IP \fBFocusOnClickClient\fR=1 4
124 .IX Item "FocusOnClickClient=1"
125 Focus window when client area clicked.
126 .IP \fBRaiseOnClickClient\fR=1 4
127 .IX Item "RaiseOnClickClient=1"
128 Raise window when client area clicked.
129 .IP \fBRaiseOnClickTitleBar\fR=1 4
130 .IX Item "RaiseOnClickTitleBar=1"
131 Raise window when title bar is clicked.
132 .IP \fBRaiseOnClickButton\fR=1 4
133 .IX Item "RaiseOnClickButton=1"
134 Raise window when frame button is clicked.
135 .IP \fBRaiseOnClickFrame\fR=1 4
136 .IX Item "RaiseOnClickFrame=1"
137 Raise window when frame border is clicked.
138 .IP \fBLowerOnClickWhenRaised\fR=0 4
139 .IX Item "LowerOnClickWhenRaised=0"
140 Lower the active window when clicked again.
141 .IP \fBPassFirstClickToClient\fR=1 4
142 .IX Item "PassFirstClickToClient=1"
143 Pass focusing click on client area to client.
144 .IP \fBFocusChangesWorkspace\fR=0 4
145 .IX Item "FocusChangesWorkspace=0"
146 Change to the workspace of newly focused windows.
147 .IP \fBFocusCurrentWorkspace\fR=0 4
148 .IX Item "FocusCurrentWorkspace=0"
149 Move newly focused windows to current workspace.
150 .IP \fBFocusOnMap\fR=1 4
151 .IX Item "FocusOnMap=1"
152 Focus normal window when initially mapped.
153 .IP \fBFocusOnMapTransient\fR=0 4
154 .IX Item "FocusOnMapTransient=0"
155 Focus dialog window when initially mapped.
156 .IP \fBFocusOnMapTransientActive\fR=1 4
157 .IX Item "FocusOnMapTransientActive=1"
158 Focus dialog window when initially mapped only if parent frame focused.
159 .IP \fBMapInactiveOnTop\fR=1 4
160 .IX Item "MapInactiveOnTop=1"
161 Put new windows on top even if not focusing them.
162 .IP \fBPointerColormap\fR=1 4
163 .IX Item "PointerColormap=1"
164 Colormap focus follows pointer.
165 .IP \fBDontRotateMenuPointer\fR=1 4
166 .IX Item "DontRotateMenuPointer=1"
167 Don't rotate the cursor for popup menus.
168 .IP \fBLimitSize\fR=1 4
169 .IX Item "LimitSize=1"
170 Limit size of windows to screen.
171 .IP \fBLimitPosition\fR=1 4
172 .IX Item "LimitPosition=1"
173 Limit position of windows to screen.
174 .IP \fBLimitByDockLayer\fR=0 4
175 .IX Item "LimitByDockLayer=0"
176 Let the Dock layer limit the workspace (incompatible with GNOME Panel).
177 .IP \fBConsiderHBorder\fR=0 4
178 .IX Item "ConsiderHBorder=0"
179 Consider border frames when maximizing horizontally.
180 .IP \fBConsiderVBorder\fR=0 4
181 .IX Item "ConsiderVBorder=0"
182 Consider border frames when maximizing vertically.
183 .IP \fBConsiderSizeHintsMaximized\fR=1 4
184 .IX Item "ConsiderSizeHintsMaximized=1"
185 Consider XSizeHints if frame is maximized.
186 Turning this off allows the titlebar to cover the width of the screen.
187 .IP \fBCenterMaximizedWindows\fR=0 4
188 .IX Item "CenterMaximizedWindows=0"
189 Center maximized windows that can't fit the screen (like terminals).
190 .IP \fBHideBordersMaximized\fR=0 4
191 .IX Item "HideBordersMaximized=0"
192 Hide window borders if window is maximized.
193 .IP \fBSizeMaximized\fR=0 4
194 .IX Item "SizeMaximized=0"
195 Maximized windows can be resized.
196 .IP \fBShowMoveSizeStatus\fR=1 4
197 .IX Item "ShowMoveSizeStatus=1"
198 Show position status window during move/resize.
199 .IP \fBShowWorkspaceStatus\fR=1 4
200 .IX Item "ShowWorkspaceStatus=1"
201 Show name of current workspace while switching.
202 .IP \fBMinimizeToDesktop\fR=0 4
203 .IX Item "MinimizeToDesktop=0"
204 Display mini-icons on desktop for minimized windows.
205 .IP \fBMiniIconsPlaceHorizontal\fR=0 4
206 .IX Item "MiniIconsPlaceHorizontal=0"
207 Place the mini-icons horizontal instead of vertical.
208 .IP \fBMiniIconsRightToLeft\fR=0 4
209 .IX Item "MiniIconsRightToLeft=0"
210 Place new mini-icons from right to left.
211 .IP \fBMiniIconsBottomToTop\fR=0 4
212 .IX Item "MiniIconsBottomToTop=0"
213 Place new mini-icons from bottom to top.
214 .IP \fBStrongPointerFocus\fR=0 4
215 .IX Item "StrongPointerFocus=0"
216 Always maintain focus under mouse window. Makes some keyboard support
217 non-functional or unreliable.
218 .IP \fBOpaqueMove\fR=1 4
219 .IX Item "OpaqueMove=1"
220 Opaque window move.
221 .IP \fBOpaqueResize\fR=1 4
222 .IX Item "OpaqueResize=1"
223 Opaque window resize.
224 .IP \fBManualPlacement\fR=0 4
225 .IX Item "ManualPlacement=0"
226 Windows initially placed manually by user.
227 .IP \fBSmartPlacement\fR=1 4
228 .IX Item "SmartPlacement=1"
229 Smart window placement (minimal overlap).
230 .IP \fBHideTitleBarWhenMaximized\fR=0 4
231 .IX Item "HideTitleBarWhenMaximized=0"
232 Hide title bar when maximized.
233 .IP \fBCenterLarge\fR=0 4
234 .IX Item "CenterLarge=0"
235 Center large windows.
236 .IP \fBCenterTransientsOnOwner\fR=1 4
237 .IX Item "CenterTransientsOnOwner=1"
238 Center dialogs on owner window.
239 .IP \fBMenuMouseTracking\fR=0 4
240 .IX Item "MenuMouseTracking=0"
241 Menus track mouse even with no mouse buttons held.
242 .IP \fBAutoRaise\fR=0 4
243 .IX Item "AutoRaise=0"
244 Raise windows when the mouse pointer enters, after a delay of
245 \&\fIAutoRaiseDelay\fR milliseconds. Note that \f(CW\*(C`RaiseOnFocus=1\*(C'\fR
246 may interfere.
247 .IP \fBDelayPointerFocus\fR=1 4
248 .IX Item "DelayPointerFocus=1"
249 Delay pointer focusing when mouse moves.
250 .IP \fBWin95Keys\fR=1 4
251 .IX Item "Win95Keys=1"
252 Support the Windows/Super key modifier to activate special functions.
253 The left Super key toggles the Start menu, while the right Super key
254 toggles the Window list window.
255 .IP \fBModSuperIsCtrlAlt\fR=0 4
256 .IX Item "ModSuperIsCtrlAlt=0"
257 Treat the Super/Win key modifier as a synonym for the Ctrl+Alt modifier
258 combination. The default key bindings have many occurrences of Ctrl+Alt.
259 If you enable this, then the Super modifier is an alternative way to
260 activate them.
261 .IP \fBUseMouseWheel\fR=0 4
262 .IX Item "UseMouseWheel=0"
263 Support mouse wheel. When pressing Ctrl+Alt rotating the mouse wheel
264 on the root window will cycle the focus over the windows.
265 .IP \fBTaskBarTaskGrouping\fR=0 4
266 .IX Item "TaskBarTaskGrouping=0"
267 Group applications with the same class name under a single task button.
268 0 disables it, 1 shows the number of windows, 2 shows bread crumbs,
269 3 shows a number + bread crumbs.
270 .IP \fBShowPopupsAbovePointer\fR=0 4
271 .IX Item "ShowPopupsAbovePointer=0"
272 Show popup menus above mouse pointer.
273 .IP \fBReplayMenuCancelClick\fR=0 4
274 .IX Item "ReplayMenuCancelClick=0"
275 Send the clicks outside menus to target window.
276 .IP \fBClientWindowMouseActions\fR=1 4
277 .IX Item "ClientWindowMouseActions=1"
278 Allow mouse actions on client windows. This is buggy with some programs.
279 .IP \fBGrabRootWindow\fR=1 4
280 .IX Item "GrabRootWindow=1"
281 Manage root window (EXPERIMENTAL \- normally enabled!).
282 .IP \fBSnapMove\fR=1 4
283 .IX Item "SnapMove=1"
284 Snap to nearest screen edge/window when moving windows.
285 .IP "\fBSnapDistance\fR=8 [0\-64]" 4
286 .IX Item "SnapDistance=8 [0-64]"
287 Distance in pixels before windows snap together.
288 .IP \fBArrangeWindowsOnScreenSizeChange\fR=1 4
289 .IX Item "ArrangeWindowsOnScreenSizeChange=1"
290 Automatically arrange windows when screen size changes.
291 .IP \fBAllowFullscreen\fR=1 4
292 .IX Item "AllowFullscreen=1"
293 Allow to switch a window to fullscreen.
294 .IP \fBFullscreenUseAllMonitors\fR=0 4
295 .IX Item "FullscreenUseAllMonitors=0"
296 Span over all available screens if window goes into fullscreen.
297 .IP "\fBMsgBoxDefaultAction\fR=0 [0\-1]" 4
298 .IX Item "MsgBoxDefaultAction=0 [0-1]"
299 Preselect to Cancel (0) or the OK (1) button in message boxes.
300 .IP "\fBNetWorkAreaBehaviour\fR=0 [0\-2]" 4
301 .IX Item "NetWorkAreaBehaviour=0 [0-2]"
302 NET_WORKAREA behaviour: 0 (single/multi\-monitor with STRUT information,
303 like metacity), 1 (always full desktop), 2 (single monitor with STRUT,
304 multi-monitor without STRUT).
305 .SS "QUICK SWITCH"
306 .IX Subsection "QUICK SWITCH"
307 .IP \fBQuickSwitch\fR=1 4
308 .IX Item "QuickSwitch=1"
309 Enable Alt+Tab window switching.
310 .IP \fBQuickSwitchToMinimized\fR=1 4
311 .IX Item "QuickSwitchToMinimized=1"
312 Enable Alt+Tab to minimized windows.
313 .IP \fBQuickSwitchToHidden\fR=1 4
314 .IX Item "QuickSwitchToHidden=1"
315 Enable Alt+Tab to hidden windows.
316 .IP \fBQuickSwitchToUrgent\fR=1 4
317 .IX Item "QuickSwitchToUrgent=1"
318 Prioritize Alt+Tab to urgent windows.
319 .IP \fBQuickSwitchToAllWorkspaces\fR=0 4
320 .IX Item "QuickSwitchToAllWorkspaces=0"
321 Include windows from all workspaces in Alt+Tab.
322 .IP \fBQuickSwitchGroupWorkspaces\fR=1 4
323 .IX Item "QuickSwitchGroupWorkspaces=1"
324 Group windows by workspace together in Alt+Tab.
325 .IP \fBQuickSwitchPersistence\fR=0 4
326 .IX Item "QuickSwitchPersistence=0"
327 Time in seconds to remember the state of Alt+Tab.
328 .IP \fBQuickSwitchRaiseCandidate\fR=0 4
329 .IX Item "QuickSwitchRaiseCandidate=0"
330 Raise a selected window while Alt+Tabbing in the QuickSwitch.
331 .IP \fBQuickSwitchAllIcons\fR=1 4
332 .IX Item "QuickSwitchAllIcons=1"
333 Show all reachable icons when quick switching.
334 .IP \fBQuickSwitchTextFirst\fR=0 4
335 .IX Item "QuickSwitchTextFirst=0"
336 Show the window title above (all reachable) icons.
337 .IP \fBQuickSwitchSmallWindow\fR=0 4
338 .IX Item "QuickSwitchSmallWindow=0"
339 Create a smaller QuickSwitch window of 1/3 screen width.
340 .IP \fBQuickSwitchMaxWidth\fR=0 4
341 .IX Item "QuickSwitchMaxWidth=0"
342 Go trough all window titles and choose width of the longest one.
343 .IP \fBQuickSwitchVertical\fR=1 4
344 .IX Item "QuickSwitchVertical=1"
345 Place the icons and titles vertical instead of horizontal.
346 .IP \fBQuickSwitchHugeIcon\fR=0 4
347 .IX Item "QuickSwitchHugeIcon=0"
348 Show the huge (48x48) of the window icon for the active window.
349 .IP \fBQuickSwitchFillSelection\fR=0 4
350 .IX Item "QuickSwitchFillSelection=0"
351 Fill the rectangle highlighting the current icon.
352 .SS "EDGE SWITCHING"
353 .IX Subsection "EDGE SWITCHING"
354 .IP \fBEdgeSwitch\fR=0 4
355 .IX Item "EdgeSwitch=0"
356 Workspace switches by moving mouse to left/right screen edge.
357 .IP \fBHorizontalEdgeSwitch\fR=0 4
358 .IX Item "HorizontalEdgeSwitch=0"
359 Workspace switches by moving mouse to left/right screen edge.
360 .IP \fBVerticalEdgeSwitch\fR=0 4
361 .IX Item "VerticalEdgeSwitch=0"
362 Workspace switches by moving mouse to top/bottom screen edge.
363 .IP \fBContinuousEdgeSwitch\fR=1 4
364 .IX Item "ContinuousEdgeSwitch=1"
365 Workspace switches continuously when moving mouse to screen edge.
366 .IP "\fBEdgeResistance\fR=32 [0\-10000]" 4
367 .IX Item "EdgeResistance=32 [0-10000]"
368 Resistance in pixels when trying to move windows off the screen (10000 =
369 infinite).
370 .SS "TASK BAR"
371 .IX Subsection "TASK BAR"
372 The following preferences affect the \fBicewm\fR\|(1) task bar:
373 .IP \fBShowTaskBar\fR=1 4
374 .IX Item "ShowTaskBar=1"
375 Show task bar.
376 .IP \fBTaskBarAtTop\fR=0 4
377 .IX Item "TaskBarAtTop=0"
378 Task bar at top of the screen.
379 .IP \fBTaskBarKeepBelow\fR=0 4
380 .IX Item "TaskBarKeepBelow=0"
381 Keep the task bar below regular windows.
382 .IP \fBTaskBarAutoHide\fR=0 4
383 .IX Item "TaskBarAutoHide=0"
384 Auto hide task bar after delay.
385 .IP \fBTaskBarFullscreenAutoShow\fR=1 4
386 .IX Item "TaskBarFullscreenAutoShow=1"
387 Auto show task bar when fullscreen window active.
388 .IP \fBTaskBarShowClock\fR=1 4
389 .IX Item "TaskBarShowClock=1"
390 Show clock on task bar.
391 .IP \fBTaskBarShowAPMStatus\fR=0 4
392 .IX Item "TaskBarShowAPMStatus=0"
393 Show battery status monitor on task bar.
394 .IP \fBTaskBarShowAPMAuto\fR=1 4
395 .IX Item "TaskBarShowAPMAuto=1"
396 Enable TaskBarShowAPMStatus if a battery is present.
397 .IP \fBTaskBarShowAPMTime\fR=1 4
398 .IX Item "TaskBarShowAPMTime=1"
399 Show battery status on task bar in time-format
400 .IP \fBTaskBarShowAPMGraph\fR=1 4
401 .IX Item "TaskBarShowAPMGraph=1"
402 Show battery status in graph mode.
403 .IP \fBTaskBarShowMailboxStatus\fR=1 4
404 .IX Item "TaskBarShowMailboxStatus=1"
405 Show mailbox status on task bar.
406 .IP \fBTaskBarMailboxStatusBeepOnNewMail\fR=0 4
407 .IX Item "TaskBarMailboxStatusBeepOnNewMail=0"
408 Beep when new mail arrives.
409 .IP \fBTaskBarMailboxStatusCountMessages\fR=0 4
410 .IX Item "TaskBarMailboxStatusCountMessages=0"
411 Count messages in mailbox.
412 .IP \fBTaskBarShowWorkspaces\fR=1 4
413 .IX Item "TaskBarShowWorkspaces=1"
414 Show workspace switching buttons on task bar.
415 .IP \fBTaskBarShowWindows\fR=1 4
416 .IX Item "TaskBarShowWindows=1"
417 Show windows on the taskbar.
418 .IP \fBTaskBarShowShowDesktopButton\fR=1 4
419 .IX Item "TaskBarShowShowDesktopButton=1"
420 Show 'show desktop' button on taskbar. If set to 2, it will move the icon to the right side, after the clock.
421 .IP \fBShowEllipsis\fR=1 4
422 .IX Item "ShowEllipsis=1"
423 Show Ellipsis in taskbar items.
424 .IP \fBTaskBarShowTray\fR=1 4
425 .IX Item "TaskBarShowTray=1"
426 Show windows in the tray.
427 .IP \fBTaskBarEnableSystemTray\fR=1 4
428 .IX Item "TaskBarEnableSystemTray=1"
429 Enable the system tray in the taskbar.
430 .IP \fBTrayShowAllWindows\fR=1 4
431 .IX Item "TrayShowAllWindows=1"
432 Show windows from all workspaces on tray.
433 .IP \fBTaskBarShowTransientWindows\fR=1 4
434 .IX Item "TaskBarShowTransientWindows=1"
435 Show transient (dialogs, ...) windows on task bar.
436 .IP \fBTaskBarShowAllWindows\fR=0 4
437 .IX Item "TaskBarShowAllWindows=0"
438 Show windows from all workspaces on task bar.
439 .IP \fBTaskBarShowWindowIcons\fR=1 4
440 .IX Item "TaskBarShowWindowIcons=1"
441 Show icons of windows on task buttons of the task bar.
442 .IP \fBTaskBarShowWindowTitles\fR=1 4
443 .IX Item "TaskBarShowWindowTitles=1"
444 Show titles of windows on task buttons of the task bar.
445 .IP \fBTaskBarShowStartMenu\fR=1 4
446 .IX Item "TaskBarShowStartMenu=1"
447 Show 'Start' menu on task bar.
448 .IP \fBTaskBarShowWindowListMenu\fR=1 4
449 .IX Item "TaskBarShowWindowListMenu=1"
450 Show 'window list' menu on task bar.
451 .IP \fBTaskBarShowCPUStatus\fR=1 4
452 .IX Item "TaskBarShowCPUStatus=1"
453 Show CPU status on task bar (Linux & Solaris).
454 .IP \fBCPUStatusShowRamUsage\fR=1 4
455 .IX Item "CPUStatusShowRamUsage=1"
456 Show RAM usage in CPU status tool tip.
457 .IP \fBCPUStatusShowSwapUsage\fR=1 4
458 .IX Item "CPUStatusShowSwapUsage=1"
459 Show swap usage in CPU status tool tip.
460 .IP \fBCPUStatusShowAcpiTemp\fR=1 4
461 .IX Item "CPUStatusShowAcpiTemp=1"
462 Show ACPI temperature in CPU status tool tip.
463 .IP \fBCPUStatusShowAcpiTempInGraph\fR=0 4
464 .IX Item "CPUStatusShowAcpiTempInGraph=0"
465 Show ACPI temperature in CPU status bar.
466 .IP \fBCPUStatusShowCpuFreq\fR=1 4
467 .IX Item "CPUStatusShowCpuFreq=1"
468 Show CPU frequency in CPU status tool tip.
469 .IP \fBNetStatusShowOnlyRunning\fR=0 4
470 .IX Item "NetStatusShowOnlyRunning=0"
471 Show network status only for connected devices, such as an active Ethernet link
472 or associated wireless interface. If false, any network interface that has been
473 brought up will be displayed.
474 .IP \fBTaskBarShowMEMStatus\fR=1 4
475 .IX Item "TaskBarShowMEMStatus=1"
476 Show memory usage status on task bar (Linux only).
477 .IP \fBTaskBarShowNetStatus\fR=1 4
478 .IX Item "TaskBarShowNetStatus=1"
479 Show network status on task bar (Linux only).
480 .IP \fBTaskBarShowCollapseButton\fR=0 4
481 .IX Item "TaskBarShowCollapseButton=0"
482 Show a button to collapse the taskbar.
483 .IP \fBTaskBarDoubleHeight\fR=0 4
484 .IX Item "TaskBarDoubleHeight=0"
485 Use double-height task bar.
486 .IP \fBTaskBarWorkspacesLeft\fR=1 4
487 .IX Item "TaskBarWorkspacesLeft=1"
488 Place workspace pager on left, not right.
489 .IP \fBTaskBarWorkspacesTop\fR=0 4
490 .IX Item "TaskBarWorkspacesTop=0"
491 Place workspace pager on top row when using dual-height taskbar.
492 .IP "\fBTaskBarWorkspacesLimit\fR=""""" 4
493 .IX Item "TaskBarWorkspacesLimit="""""
494 Limit the number of taskbar workspaces buttons that are shown on the
495 workspaces pane of the taskbar. If the numeric value has a \f(CW\*(C`p\*(C'\fR suffix
496 then the limitation is in pixels. A \f(CW\*(C`%\*(C'\fR suffix limits by percentage of
497 desktop width. By default a \f(CW\*(C`B\*(C'\fR suffix is assumed for number of buttons.
498 .IP \fBTaskBarUseMouseWheel\fR=1 4
499 .IX Item "TaskBarUseMouseWheel=1"
500 Enable mouse wheel cycling over workspaces and task buttons in taskbar.
501 .IP \fBPagerShowPreview\fR=1 4
502 .IX Item "PagerShowPreview=1"
503 Show a mini desktop preview on each workspace button.
504 .IP \fBPagerShowWindowIcons\fR=1 4
505 .IX Item "PagerShowWindowIcons=1"
506 Draw window icons inside large enough preview windows on pager (if PagerShowPreview=1).
507 .IP \fBPagerShowMinimized\fR=1 4
508 .IX Item "PagerShowMinimized=1"
509 Draw even minimized windows as unfilled rectangles (if PagerShowPreview=1).
510 .IP \fBPagerShowBorders\fR=1 4
511 .IX Item "PagerShowBorders=1"
512 Draw border around workspace buttons (if PagerShowPreview=1).
513 .IP \fBPagerShowLabels\fR=1 4
514 .IX Item "PagerShowLabels=1"
515 Show workspace name label on workspace button (if PagerShowPreview=1)
516 .IP \fBPagerShowNumbers\fR=1 4
517 .IX Item "PagerShowNumbers=1"
518 Show number of workspace on workspace button (if PagerShowPreview=1).
519 .IP \fBTaskBarLaunchOnSingleClick\fR=1 4
520 .IX Item "TaskBarLaunchOnSingleClick=1"
521 Execute taskbar applet commands (like MailCommand, ClockCommand, ...) on single click.
522 .IP \fBEnableAddressBar\fR=1 4
523 .IX Item "EnableAddressBar=1"
524 Enable address bar functionality in taskbar.
525 .IP \fBShowAddressBar\fR=1 4
526 .IX Item "ShowAddressBar=1"
527 Show address bar in task bar.
528 .IP \fBMultiByte\fR=1 4
529 .IX Item "MultiByte=1"
530 Overrides automatic multiple byte detection.
531 .IP \fBConfirmLogout\fR=1 4
532 .IX Item "ConfirmLogout=1"
533 Confirm logout.
534 .IP \fBShapesProtectClientWindow\fR=1 4
535 .IX Item "ShapesProtectClientWindow=1"
536 Don't cut client windows by shapes set trough frame corner pixmap.
537 .IP \fBDoubleBuffer\fR=1 4
538 .IX Item "DoubleBuffer=1"
539 Use double buffering when redrawing the display.
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's 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 Open command.
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 'Network Status' \-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 'O' 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's 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't 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/X11/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.