1ICEWM-PREFERENCES(5) Standards, Environments and Macros ICEWM-PREFERENCES(5)
2
3
4
6 icewm-preferences - icewm preferences configuration file
7
9 $ICEWM_PRIVCFG/preferences
10 $XDG_CONFIG_HOME/icewm/preferences
11 $HOME/.icewm/preferences
12 /etc/icewm/preferences
13 /usr/share/icewm/preferences
14
16 Contains general settings like paths, colors and fonts, but also
17 options to control the icewm focus behaviour and the applets which are
18 started in the task bar. The icewm installation will provide a default
19 preferences file, which can be copied to the icewm user configuration
20 directory and modified.
21
23 FOCUS AND BEHAVIOR
24 The following preferences affect focus and general behavior of
25 icewm(1):
26
27 Alpha=0
28 Use a 32-bit visual for alpha blending
29
30 Synchronize=0
31 Synchronize X11 for debugging (slow)
32
33 LogEvents=0
34 Enable event logging for debugging
35
36 Splash=""
37 Splash image on startup (IceWM.jpg)
38
39 Trace=""
40 Enable tracing for the given list of modules. Modules which are
41 traceable include conf, icon, prog, systray.
42
43 ClickToFocus=1
44 Focus windows by clicking in them.
45
46 FocusOnAppRaise=0
47 Focus windows when applications request that they be raised.
48
49 RequestFocusOnAppRaise=1
50 Request focus (flashing in taskbar) when application requests
51 raise.
52
53 RaiseOnFocus=1
54 Raise windows when focused.
55
56 FocusOnClickClient=1
57 Focus window when client area clicked.
58
59 RaiseOnClickClient=1
60 Raise window when client area clicked.
61
62 RaiseOnClickTitleBar=1
63 Raise window when title bar is clicked.
64
65 RaiseOnClickButton=1
66 Raise window when frame button is clicked.
67
68 RaiseOnClickFrame=1
69 Raise window when frame border is clicked.
70
71 LowerOnClickWhenRaised=0
72 Lower the active window when clicked again.
73
74 PassFirstClickToClient=1
75 Pass focusing click on client area to client.
76
77 FocusChangesWorkspace=0
78 Change to the workspace of newly focused windows.
79
80 FocusCurrentWorkspace=0
81 Move newly focused windows to current workspace.
82
83 FocusOnMap=1
84 Focus normal window when initially mapped.
85
86 FocusOnMapTransient=0
87 Focus dialog window when initially mapped.
88
89 FocusOnMapTransientActive=1
90 Focus dialog window when initially mapped only if parent frame
91 focused.
92
93 MapInactiveOnTop=1
94 Put new windows on top even if not focusing them.
95
96 PointerColormap=1
97 Colormap focus follows pointer.
98
99 DontRotateMenuPointer=1
100 Don't rotate the cursor for popup menus.
101
102 LimitSize=1
103 Limit size of windows to screen.
104
105 LimitPosition=1
106 Limit position of windows to screen.
107
108 LimitByDockLayer=0
109 Let the Dock layer limit the workspace (incompatible with GNOME
110 Panel).
111
112 ConsiderHBorder=0
113 Consider border frames when maximizing horizontally.
114
115 ConsiderVBorder=0
116 Consider border frames when maximizing vertically.
117
118 ConsiderSizeHintsMaximized=1
119 Consider XSizeHints if frame is maximized. Turning this off allows
120 the titlebar to cover the width of the screen.
121
122 CenterMaximizedWindows=0
123 Center maximized windows which can't fit the screen (like
124 terminals).
125
126 HideBordersMaximized=0
127 Hide window borders if window is maximized.
128
129 SizeMaximized=0
130 Maximized windows can be resized.
131
132 ShowMoveSizeStatus=1
133 Show position status window during move/resize.
134
135 ShowWorkspaceStatus=1
136 Show name of current workspace while switching.
137
138 MinimizeToDesktop=0
139 Display mini-icons on desktop for minimized windows.
140
141 MiniIconsPlaceHorizontal=0
142 Place the mini-icons horizontal instead of vertical.
143
144 MiniIconsRightToLeft=0
145 Place new mini-icons from right to left.
146
147 MiniIconsBottomToTop=0
148 Place new mini-icons from bottom to top.
149
150 StrongPointerFocus=0
151 Always maintain focus under mouse window (makes some keyboard
152 support non-functional or unreliable.
153
154 OpaqueMove=1
155 Opaque window move.
156
157 OpaqueResize=1
158 Opaque window resize.
159
160 ManualPlacement=0
161 Windows initially placed manually by user.
162
163 SmartPlacement=1
164 Smart window placement (minimal overlap).
165
166 HideTitleBarWhenMaximized=0
167 Hide title bar when maximized.
168
169 CenterLarge=0
170 Center large windows.
171
172 CenterTransientsOnOwner=1
173 Center dialogs on owner window.
174
175 MenuMouseTracking=0
176 Menus track mouse even with no mouse buttons held.
177
178 AutoRaise=0
179 Raise windows when the mouse pointer enters, after a delay of
180 AutoRaiseDelay milliseconds. Note that "RaiseOnFocus=1" may
181 interfere.
182
183 DelayPointerFocus=1
184 Delay pointer focusing when mouse moves.
185
186 Win95Keys=1
187 Support the Windows/Super key modifier to activate special
188 functions. The left Super key toggles the Start menu, while the
189 right Super key toggles the Window list window.
190
191 ModSuperIsCtrlAlt=0
192 Treat the Super/Win key modifier as a synonym for the Ctrl+Alt
193 modifier combination. The default key bindings have many
194 occurrences of Ctrl+Alt. If you enable this, then the Super
195 modifier is an alternative way to activate them.
196
197 UseMouseWheel=0
198 Support mouse wheel. When pressing Ctrl+Alt rotating the mouse
199 wheel on the root window will cycle the focus over the windows.
200
201 TaskBarTaskGrouping=0
202 Group applications with the same class name under a single task
203 button. 0 disables it, 1 shows the number of windows, 2 shows
204 bread crumbs, 3 shows a number + bread crumbs.
205
206 ShowPopupsAbovePointer=0
207 Show popup menus above mouse pointer.
208
209 ReplayMenuCancelClick=0
210 Send the clicks outside menus to target window.
211
212 ClientWindowMouseActions=1
213 Allow mouse actions on client windows (buggy with some programs).
214
215 GrabRootWindow=1
216 Manage root window (EXPERIMENTAL - normally enabled!).
217
218 SnapMove=1
219 Snap to nearest screen edge/window when moving windows.
220
221 SnapDistance=8 [0-64]
222 Distance in pixels before windows snap together.
223
224 ArrangeWindowsOnScreenSizeChange=1
225 Automatically arrange windows when screen size changes.
226
227 AllowFullscreen=1
228 Allow to switch a window to fullscreen.
229
230 FullscreenUseAllMonitors=0
231 Span over all available screens if window goes into fullscreen.
232
233 MsgBoxDefaultAction=0 [0-1]
234 Preselect to Cancel (0) or the OK (1) button in message boxes.
235
236 NetWorkAreaBehaviour=0 [0-2]
237 NET_WORKAREA behaviour: 0 (single/multi-monitor with STRUT
238 information, like metacity), 1 (always full desktop), 2 (single
239 monitor with STRUT, multi-monitor without STRUT).
240
241 QUICK SWITCH
242 QuickSwitch=1
243 Enable Alt+Tab window switching.
244
245 QuickSwitchToMinimized=1
246 Enable Alt+Tab to minimized windows.
247
248 QuickSwitchToHidden=1
249 Enable Alt+Tab to hidden windows.
250
251 QuickSwitchToUrgent=1
252 Prioritize Alt+Tab to urgent windows.
253
254 QuickSwitchToAllWorkspaces=0
255 Include windows from all workspaces in Alt+Tab.
256
257 QuickSwitchGroupWorkspaces=1
258 Group windows by workspace together in Alt+Tab.
259
260 QuickSwitchRaiseCandidate=0
261 Raise a selected window while Alt+Tabbing in the QuickSwitch.
262
263 QuickSwitchAllIcons=1
264 Show all reachable icons when quick switching.
265
266 QuickSwitchTextFirst=0
267 Show the window title above (all reachable) icons.
268
269 QuickSwitchSmallWindow=0
270 Create a smaller QuickSwitch window of 1/3 screen width.
271
272 QuickSwitchMaxWidth=0
273 Go trough all window titles and choose width of the longest one.
274
275 QuickSwitchVertical=1
276 Place the icons and titles vertical instead of horizontal.
277
278 QuickSwitchHugeIcon=0
279 Show the huge (48x48) of the window icon for the active window.
280
281 QuickSwitchFillSelection=0
282 Fill the rectangle highlighting the current icon.
283
284 EDGE SWITCHING
285 EdgeSwitch=0
286 Workspace switches by moving mouse to left/right screen edge.
287
288 HorizontalEdgeSwitch=0
289 Workspace switches by moving mouse to left/right screen edge.
290
291 VerticalEdgeSwitch=0
292 Workspace switches by moving mouse to top/bottom screen edge.
293
294 ContinuousEdgeSwitch=1
295 Workspace switches continuously when moving mouse to screen edge.
296
297 EdgeResistance=32 [0-10000]
298 Resistance in pixels when trying to move windows off the screen
299 (10000 = infinite).
300
301 TASK BAR
302 The following preferences affect the icewm(1) task bar:
303
304 ShowTaskBar=1
305 Show task bar.
306
307 TaskBarAtTop=0
308 Task bar at top of the screen.
309
310 TaskBarKeepBelow=0
311 Keep the task bar below regular windows.
312
313 TaskBarAutoHide=0
314 Auto hide task bar after delay.
315
316 TaskBarFullscreenAutoShow=1
317 Auto show task bar when fullscreen window active.
318
319 TaskBarShowClock=1
320 Show clock on task bar.
321
322 TaskBarShowAPMStatus=0
323 Show battery status monitor on task bar.
324
325 TaskBarShowAPMAuto=1
326 Enable TaskBarShowAPMStatus if a battery is present.
327
328 TaskBarShowAPMTime=1
329 Show battery status on task bar in time-format
330
331 TaskBarShowAPMGraph=1
332 Show battery status in graph mode.
333
334 TaskBarShowMailboxStatus=1
335 Show mailbox status on task bar.
336
337 TaskBarMailboxStatusBeepOnNewMail=0
338 Beep when new mail arrives.
339
340 TaskBarMailboxStatusCountMessages=0
341 Count messages in mailbox.
342
343 TaskBarShowWorkspaces=1
344 Show workspace switching buttons on task bar.
345
346 TaskBarShowWindows=1
347 Show windows on the taskbar.
348
349 TaskBarShowShowDesktopButton=1
350 Show 'show desktop' button on taskbar. If set to 2, it will move
351 the icon to the right side, after the clock.
352
353 ShowEllipsis=1
354 Show Ellipsis in taskbar items.
355
356 TaskBarShowTray=1
357 Show windows in the tray.
358
359 TaskBarEnableSystemTray=1
360 Enable the system tray in the taskbar.
361
362 TrayShowAllWindows=1
363 Show windows from all workspaces on tray.
364
365 TaskBarShowTransientWindows=1
366 Show transient (dialogs, ...) windows on task bar.
367
368 TaskBarShowAllWindows=0
369 Show windows from all workspaces on task bar.
370
371 TaskBarShowWindowIcons=1
372 Show icons of windows on the task bar.
373
374 TaskBarShowStartMenu=1
375 Show 'Start' menu on task bar.
376
377 TaskBarShowWindowListMenu=1
378 Show 'window list' menu on task bar.
379
380 TaskBarShowCPUStatus=1
381 Show CPU status on task bar (Linux & Solaris).
382
383 CPUStatusShowRamUsage=1
384 Show RAM usage in CPU status tool tip.
385
386 CPUStatusShowSwapUsage=1
387 Show swap usage in CPU status tool tip.
388
389 CPUStatusShowAcpiTemp=1
390 Show ACPI temperature in CPU status tool tip.
391
392 CPUStatusShowAcpiTempInGraph=0
393 Show ACPI temperature in CPU status bar.
394
395 CPUStatusShowCpuFreq=1
396 Show CPU frequency in CPU status tool tip.
397
398 NetStatusShowOnlyRunning=0
399 Show network status only for connected devices, such as an active
400 ethernet link or associated wireless interface. If false, any
401 network interface that has been brought up will be displayed.
402
403 TaskBarShowMEMStatus=1
404 Show memory usage status on task bar (Linux only).
405
406 TaskBarShowNetStatus=1
407 Show network status on task bar (Linux only).
408
409 TaskBarShowCollapseButton=0
410 Show a button to collapse the taskbar.
411
412 TaskBarDoubleHeight=0
413 Use double-height task bar.
414
415 TaskBarWorkspacesLeft=1
416 Place workspace pager on left, not right.
417
418 TaskBarWorkspacesTop=0
419 Place workspace pager on top row when using dual-height taskbar.
420
421 TaskBarWorkspacesLimit=""
422 Limit the number of taskbar workspaces buttons which are shown on
423 the workspaces pane of the taskbar. If the numeric value has a "p"
424 suffix then the limitation is in pixels. A "%" suffix limits by
425 percentage of desktop width. By default a "B" suffix is assumed for
426 number of buttons.
427
428 TaskBarUseMouseWheel=1
429 Enable mouse wheel cycling over workspaces and task buttons in
430 taskbar.
431
432 TaskBarClockLeds=0 # 0/1
433 Task bar clock/battery monitor uses nice pixmap LCD display (but
434 then it doesn't display correctly in many languages anymore, e.g.,
435 for Japanese and Korean it works only when a real font is used and
436 not the LCD pixmaps.
437
438 PagerShowPreview=1
439 Show a mini desktop preview on each workspace button.
440
441 PagerShowWindowIcons=1
442 Draw window icons inside large enough preview windows on pager (if
443 PagerShowPreview=1).
444
445 PagerShowMinimized=1
446 Draw even minimized windows as unfilled rectangles (if
447 PagerShowPreview=1).
448
449 PagerShowBorders=1
450 Draw border around workspace buttons (if PagerShowPreview=1).
451
452 PagerShowLabels=1
453 Show workspace name label on workspace button (if
454 PagerShowPreview=1)
455
456 PagerShowNumbers=1
457 Show number of workspace on workspace button (if
458 PagerShowPreview=1).
459
460 TaskBarLaunchOnSingleClick=1
461 Execute taskbar applet commands (like MailCommand, ClockCommand,
462 ...) on single click.
463
464 EnableAddressBar=1
465 Enable address bar functionality in taskbar.
466
467 ShowAddressBar=1
468 Show address bar in task bar.
469
470 MultiByte=1
471 Overrides automatic multiple byte detection.
472
473 ConfirmLogout=1
474 Confirm logout.
475
476 ShapesProtectClientWindow=1
477 Don't cut client windows by shapes set trough frame corner pixmap.
478
479 DoubleBuffer=1
480 Use double buffering when redrawing the display.
481
482 XRRDisable=1
483 Disable use of new XRANDR API for dual head (nvidia workaround).
484
485 PreferFreetypeFonts=1
486 Favour Xft fonts over core X11 fonts where possible.
487
488 MailBoxPath=""
489 Mailbox path (use \$MAIL instead).
490
491 Path to a mbox file. Remote mail boxes are accessed by specifying
492 an URL using the Common Internet Scheme Syntax (RFC 1738):
493
494 `scheme://[user[:password]@]server[:port][/path]`.
495
496 Supported schemes are "pop3", "imap" and "file". When the scheme
497 is omitted file:// is prepended silently. IMAP subfolders can be
498 accessed by using the path component. Reserved characters like
499 slash ("/"), at ("@") and colon (":") can be specified using escape
500 sequences with a hexadecimal encoding like %2f for the slash or %40
501 for the at sign. For example:
502
503 file:///var/spool/mail/captnmark
504 pop3://markus:%2f%40%3a@maol.ch/
505 imap://mathias@localhost/INBOX.Maillisten.icewm-user
506
507 NetworkStatusDevice="eth0 wlan0"
508 Network device for which to show status.
509
510 TimeFormat="%X"
511 Clock Time format (strftime format string).
512
513 TimeFormatAlt=""
514 Alternate Clock Time format (e.g., for blinking effects).
515
516 DateFormat="%c"
517 Clock Date format for tooltip (strftime format string).
518
519 XRRPrimaryScreenName=""
520 Screen/output name of the primary screen.
521
522 AcpiIgnoreBatteries=""
523 List of battery names (directories) in /proc/acpi/battery to
524 ignore. Useful when more slots are built-in, but only one battery
525 is used.
526
527 TaskBarCPUSamples=20 [2-1000]
528 The width of the CPU Monitor applet in pixels.
529
530 TaskBarMEMSamples=20 [2-1000]
531 The width of the Memory Monitor applet in pixels.
532
533 TaskBarNetSamples=20 [2-1000]
534 The width of the Net Monitor applet in pixels.
535
536 TaskbarButtonWidthDivisor=3 [1-25]
537 Default number of tasks in taskbar.
538
539 TaskBarWidthPercentage=100 [0-100]
540 Task bar width as percentage of the screen width.
541
542 TaskBarJustify="left"
543 Taskbar justify left, right or center.
544
545 TaskBarApmGraphWidth=10 [1-1000]
546 Width of battery Monitor.
547
548 TaskBarGraphHeight=20 [16-1000]
549 Height of taskbar monitoring applets.
550
551 XineramaPrimaryScreen=0 [0-63]
552 Primary screen for xinerama (taskbar, ...).
553
554 TaskbuttonIconOffset=0 # [0-16]
555 Width of taskbutton side icons.
556
557 TrayIconMaxWidth=32 # [16-128]
558 Maximum scaled width of tray icons.
559
560 TrayIconMaxHeight=24 # [16-128]
561 Maximum scaled height of tray icons.
562
563 TrayDrawBevel=0 # 0/1
564 Surround the tray with plastic border.
565
566 KeyboardLayouts=""
567 A comma-separated list of keyboard layouts. A layout may be
568 enclosed in double quotes. Each layout is a name with optional
569 arguments, which is to be parsed by the "setxkbmap" program. To
570 support changing keyboard layouts, the "setxkbmap" program must be
571 installed. The first in the list is the default layout. Programs
572 may have their own keyboard layout defined in the winoptions file.
573 The first two letters of a layout are used to locate an icon image
574 file.
575
576 MENUS
577 AutoReloadMenus=1
578 Reload menu files automatically.
579
580 ShowProgramsMenu=0
581 Show programs submenu.
582
583 ShowSettingsMenu=1
584 Show settings submenu.
585
586 ShowFocusModeMenu=1
587 Show focus mode submenu.
588
589 ShowThemesMenu=1
590 Show themes submenu.
591
592 ShowLogoutMenu=1
593 Show logout menu.
594
595 ShowHelp=1
596 Show the help menu item.
597
598 ShowLogoutSubMenu=1
599 Show logout submenu.
600
601 ShowAbout=1
602 Show the about menu item.
603
604 ShowRun=1
605 Show the run menu item.
606
607 ShowWindowList=1
608 Show the window menu item.
609
610 MenuMaximalWidth=0 [0-16384]
611 Maximal width of popup menus, 2/3 of the screen's width if set to
612 zero.
613
614 NestedThemeMenuMinNumber=25 [0-1234]
615 Minimal number of themes after which the Themes menu becomes nested
616 (0=disabled).
617
618 TIMINGS
619 DelayFuzziness=10 (0-100)
620 Delay fuzziness, to allow merging of multiple timer timeouts into
621 one (notebook power saving).
622
623 ClickMotionDistance=4 [0-32]
624 Pointer motion distance before click gets interpreted as drag.
625
626 ClickMotionDelay=200 [0-2000]
627 Delay before click gets interpreted as drag.
628
629 MultiClickTime=400 [0-5000]
630 Multiple click time.
631
632 MenuActivateDelay=40 [0-5000]
633 Delay before activating menu items.
634
635 SubmenuMenuActivateDelay=300 [0-5000]
636 Delay before activating menu submenus.
637
638 ToolTipDelay=1000 [0-5000]
639 Delay before tooltip window is displayed.
640
641 ToolTipTime=0 [0-60000]
642 Time before tooltip window is hidden (0 means never.
643
644 AutoHideDelay=300 [0-5000]
645 Delay before task bar is hidden.
646
647 AutoShowDelay=500 [0-5000]
648 Delay before task bar is shown.
649
650 AutoRaiseDelay=400 [0-5000]
651 Delay before windows are auto raised if "AutoRaise=1".
652
653 PointerFocusDelay=200 [0-1000]
654 Delay for pointer focus switching.
655
656 EdgeSwitchDelay=600 [0-5000]
657 Screen edge workspace switching delay.
658
659 ScrollBarStartDelay=500 [0-5000]
660 Initial scroll bar autoscroll delay.
661
662 ScrollBarDelay=30 [0-5000]
663 Scroll bar autoscroll delay.
664
665 AutoScrollStartDelay=500 [0-5000]
666 Auto scroll start delay.
667
668 AutoScrollDelay=60 [0-5000]
669 Auto scroll delay.
670
671 WorkspaceStatusTime=2500 [0-2500]
672 Time before workspace status window is hidden.
673
674 MailCheckDelay=30 [0-86400]
675 Delay between new-mail checks. (seconds).
676
677 TaskBarCPUDelay=500 [10-3600000]
678 Delay between CPU Monitor samples in ms.
679
680 TaskBarMEMDelay=500 [10-3600000]
681 Delay between Memory Monitor samples in ms.
682
683 TaskBarNetDelay=500 [10-3600000]
684 Delay between Net Monitor samples in ms.
685
686 FocusRequestFlashTime=0 [0-86400]
687 Number of seconds the taskbar app will blink when requesting focus
688 (0 = forever).
689
690 FocusRequestFlashInterval=250 [0-30000]
691 Taskbar blink interval (ms) when requesting focus (0 = blinking
692 disabled).
693
694 BatteryPollingPeriod=10 [2-3600]
695 Delay between power status updates (seconds).
696
697 PingTimeout=3 [0-86400]
698 Timeout in seconds for applications to respond to the _NET_WM_PING
699 protocol.
700
701 BUTTONS AND KEYS
702 UseRootButtons=255 [0-255]
703 Bitmask of root window button click to use in window manager.
704
705 ButtonRaiseMask=1 [0-255]
706 Bitmask of buttons that raise the window when pressed.
707
708 DesktopWinMenuButton=0 [0-20]
709 Desktop mouse-button click to show the window list menu.
710
711 DesktopWinListButton=2 # [0-20]
712 Desktop mouse-button click to show the window list
713
714 DesktopMenuButton=3 [0-20]
715 Desktop mouse-button click to show the root menu.
716
717 TitleBarMaximizeButton=1 [0-5]
718 Title bar mouse-button double click to maximize the window to full
719 screen with the frame border visible. Press Shift to maximize only
720 in the vertical direction. Press Alt+Shift to maximize only in the
721 horizontal direction.
722
723 TitleBarRollupButton=2 [0-5]
724 Title bar mouse-button double click to rollup the window. Press
725 Shift to maximize in the horizontal direction.
726
727 WORKSPACES
728 WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
729 Create four workspaces with names 1 , 2 , 3 and 4 .
730
731 PATHS
732 IconPath="/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps"
733 Icon search path (colon separated). Also, the icons/ subdirectory
734 in IceWM resource folders are searched first.
735
736 IconThemes="*:-HighContrast"
737 List of icon themes (colon separated), acting as additional filter
738 of icon subdirectories in any of the IconPath folders. Expressions
739 can be wildcards, also special wildcards (starting with -) can
740 exclude matched themes from selection.
741
742 MailBoxPath=""
743 Mailbox path (use \$MAIL instead).
744
745 PROGRAMS
746 MailCommand="xterm -name mutt -e mutt"
747 Command to run on mailbox.
748
749 MailClassHint="mutt.XTerm"
750 WM_CLASS to allow runonce for MailCommand.
751
752 NewMailCommand=""
753 Command to run when new mail arrives.
754
755 LockCommand=""
756 Command to lock display/screensaver.
757
758 ClockCommand="xclock -name icewm -title Clock"
759 Command to run on clock.
760
761 ClockClassHint="icewm.XClock"
762 WM_CLASS to allow runonce for ClockCommand.
763
764 RunCommand=""
765 Command to select and run a program.
766
767 OpenCommand=""
768 Open command.
769
770 TerminalCommand="xterm"
771 Terminal emulator must accept -e option.
772
773 LogoutCommand=""
774 Command to start logout.
775
776 LogoutCancelCommand=""
777 Command to cancel logout.
778
779 ShutdownCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
780 poweroff; } ||:""
781 Command to shutdown the system.
782
783 RebootCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
784 reboot; } ||:""
785 Command to reboot the system.
786
787 SuspendCommand="test -e /run/systemd/system && systemctl suspend"
788 Command to send the system to standby mode
789
790 CPUStatusCommand="xterm -name top -title Process\ Status -e top"
791 Command to run on CPU status.
792
793 CPUStatusClassHint="top.XTerm"
794 WM_CLASS to allow runonce for CPUStatusCommand.
795
796 CPUStatusCombine=1 0/1
797 Combine all CPUs to one.
798
799 NetStatusCommand="xterm -name netstat -title 'Network Status' -e
800 netstat -c"
801 Command to run on Net status.
802
803 NetStatusClassHint="netstat.XTerm"
804 WM_CLASS to allow runonce for NetStatusCommand.
805
806 AddressBarCommand=""
807 Command to run for address bar entries.
808
809 WINDOW MENUS
810 WinMenuItems="rmsnxfhualyticw"
811 Items supported in menu window (rmsnxfhualytickw)
812
813 RolloverButtonsSupported=0
814 Does it support the 'O' title bar button images (for mouse
815 rollover).
816
817 ShowMenuButtonIcon=1 # 0/1
818 Show application icon over menu button
819
820 THEME SETTINGS
821 The following sections show settings that can be set in theme files.
822 They can also be set in the preferences file, but themes will override
823 the values set there. To override the theme values, the settings
824 should be set in prefoverrides file: see icewm-prefoverrides(5).
825 Default values are shown following the equal sign.
826
827 THEME DESCRIPTION
828
829 ThemeAuthor=""
830 Theme author, e-mail address, credits.
831
832 ThemeDescription=""
833 Description of the theme, credits.
834
835 Look="nice"
836 Choose a theme look from one of: "win95", "motif", "warp3",
837 "warp4", "nice", "metal2", "gtk2", and some others.
838
839 Gradients=""
840 List of gradient pixmaps in the current theme.
841
842 THEME BORDERS, ICONS, MARGINS AND BUTTONS
843
844 BorderSizeX=6 [0-128]
845 Horizontal window border.
846
847 BorderSizeY=6 [0-128]
848 Vertical window border.
849
850 DlgBorderSizeX=2 [0-128]
851 Horizontal dialog window border.
852
853 DlgBorderSizeY=2 [0-128]
854 Vertical dialog window border.
855
856 CornerSizeX=24 [0-64]
857 Resize corner width.
858
859 CornerSizeY=24 [0-64]
860 Resize corner height.
861
862 TitleBarHeight=20 [0-128]
863 Title bar height.
864
865 TitleBarJustify=0 [0-100]
866 Justification of the window title.
867
868 TitleBarHorzOffset=0 [-128-128]
869 Horizontal offset for the window title text.
870
871 TitleBarVertOffset=0 [-128-128]
872 Vertical offset for the window title text.
873
874 MenuButtonIconVertOffset=0 [-128-128]
875 Vertical offset for the menu button icon.
876
877 ScrollBarX=16 [0-64]
878 Scrollbar width.
879
880 ScrollBarY=16 [0-64]
881 Scrollbar (button) height.
882
883 MenuIconSize=16 [8-128]
884 Menu icon size.
885
886 SmallIconSize=16 [8-128]
887 Dimension of the small icons.
888
889 LargeIconSize=32 [8-128]
890 Dimension of the large icons.
891
892 HugeIconSize=48 [8-128]
893 Dimension of the large icons.
894
895 QuickSwitchHorzMargin=3 [0-64]
896 Horizontal margin of the quickswitch window.
897
898 QuickSwitchVertMargin=3 [0-64]
899 Vertical margin of the quickswitch window.
900
901 QuickSwitchIconMargin=4 [0-64]
902 Vertical margin in the quickswitch window.
903
904 QuickSwitchIconBorder=2 [0-64]
905 Distance between the active icon and it's border.
906
907 QuickSwitchSeparatorSize=6 [0-64]
908 Height of the separator between (all reachable) icons and text, 0
909 to avoid it.
910
911 TitleButtonsLeft="s"
912 Titlebar buttons from left to right (x=close, m=max, i=min, h=hide,
913 r=rollup, s=sysmenu, d=depth).
914
915 TitleButtonsRight="xmir"
916 Titlebar buttons from right to left (x=close, m=max, i=min, h=hide,
917 r=rollup, s=sysmenu, d=depth).
918
919 TitleButtonsSupported="xmis"
920 Titlebar buttons supported by theme (x,m,i,r,h,s,d).
921
922 TitleBarCentered=0 # 0/1
923 Draw window title centered (obsoleted by TitleBarJustify).
924
925 TitleBarJoinLeft=0 # 0/1
926 Join title*S and title*T.
927
928 TitleBarJoinRight=0 # 0/1
929 Join title*T and title*B.
930
931 THEME FONTS
932
933 TitleFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
934 TitleFontNameXft="sans-serif:size=12"
935 Name of the title bar font.
936
937 MenuFontName="-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"
938 MenuFontNameXft="sans-serif:size=10:bold"
939 Name of the menu font.
940
941 StatusFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
942 StatusFontNameXft="monospace:size=12:bold"
943 Name of the status display font.
944
945 QuickSwitchFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
946 QuickSwitchFontNameXft="monospace:size=12:bold"
947 Name of the font for Alt+Tab switcher window.
948
949 NormalButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
950 NormalButtonFontNameXft="sans-serif:size=12"
951 Name of the normal button font.
952
953 ActiveButtonFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
954 ActiveButtonFontNameXft="sans-serif:size=12:bold"
955 Name of the active button font.
956
957 NormalTaskBarFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
958 NormalTaskBarFontNameXft="sans-serif:size=12"
959 Name of the normal task bar item font.
960
961 ActiveTaskBarFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
962 ActiveTaskBarFontNameXft="sans-serif:size=12:bold"
963 Name of the active task bar item font.
964
965 ToolButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
966 ToolButtonFontNameXft="sans-serif:size=12"
967 Name of the tool button font (fallback: NormalButtonFontName).
968
969 NormalWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
970 NormalWorkspaceFontNameXft="sans-serif:size=12"
971 Name of the normal workspace button font (fallback:
972 NormalButtonFontName).
973
974 ActiveWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
975 ActiveWorkspaceFontNameXft="sans-serif:size=12"
976 Name of the active workspace button font (fallback:
977 ActiveButtonFontName).
978
979 MinimizedWindowFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
980 MinimizedWindowFontNameXft="sans-serif:size=12"
981 Name of the mini-window font.
982
983 ListBoxFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
984 ListBoxFontNameXft="sans-serif:size=12"
985 Name of the window list font.
986
987 ToolTipFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
988 ToolTipFontNameXft="sans-serif:size=12"
989 Name of the tool tip font.
990
991 ClockFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
992 ClockFontNameXft="monospace:size=12"
993 Name of the task bar clock font.
994
995 TempFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
996 TempFontNameXft="monospace:size=12"
997 Name of the task bar temperature font.
998
999 ApmFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1000 ApmFontNameXft="monospace:size=12"
1001 Name of the task bar battery font.
1002
1003 InputFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1004 InputFontNameXft="monospace:size=12"
1005 Name of the input field font.
1006
1007 LabelFontName="-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"
1008 LabelFontNameXft="sans-serif:size=12"
1009 Name of the label font.
1010
1011 THEME COLORS
1012
1013 ColorDialog = "rgb:C0/C0/C0"
1014 Background of dialog windows.
1015
1016 ColorNormalBorder = "rgb:C0/C0/C0"
1017 Border of inactive windows.
1018
1019 ColorActiveBorder = "rgb:C0/C0/C0"
1020 Border of active windows.
1021
1022 ColorNormalButton = "rgb:C0/C0/C0"
1023 Background of regular buttons.
1024
1025 ColorNormalButtonText = "rgb:00/00/00"
1026 Text color of regular buttons.
1027
1028 ColorActiveButton = "rgb:E0/E0/E0"
1029 Background of pressed buttons.
1030
1031 ColorActiveButtonText = "rgb:00/00/00"
1032 Text color of pressed buttons.
1033
1034 ColorNormalTitleButton = "rgb:C0/C0/C0"
1035 Background of titlebar buttons.
1036
1037 ColorNormalTitleButtonText = "rgb:00/00/00"
1038 Text color of titlebar buttons.
1039
1040 ColorToolButton = ""
1041 Background of toolbar buttons, ColorNormalButton is used if empty.
1042
1043 ColorToolButtonText = ""
1044 Text color of toolbar buttons, ColorNormalButtonText is used if
1045 empty.
1046
1047 ColorNormalWorkspaceButton = ""
1048 Background of workspace buttons, ColorNormalButton is used if
1049 empty.
1050
1051 ColorNormalWorkspaceButtonText = ""
1052 Text color of workspace buttons, ColorNormalButtonText is used if
1053 empty.
1054
1055 ColorActiveWorkspaceButton = ""
1056 Background of the active workspace button, ColorActiveButton is
1057 used if empty.
1058
1059 ColorActiveWorkspaceButtonText = ""
1060 Text color of the active workspace button, ColorActiveButtonText is
1061 used if empty.
1062
1063 ColorNormalTitleBar = "rgb:80/80/80"
1064 Background of the titlebar of regular windows.
1065
1066 ColorNormalTitleBarText = "rgb:00/00/00"
1067 Text color of the titlebar of regular windows.
1068
1069 ColorNormalTitleBarShadow = ""
1070 Text shadow of the titlebar of regular windows.
1071
1072 ColorActiveTitleBar = "rgb:00/00/A0"
1073 Background of the titlebar of active windows.
1074
1075 ColorActiveTitleBarText = "rgb:FF/FF/FF"
1076 Text color of the titlebar of active windows.
1077
1078 ColorActiveTitleBarShadow = ""
1079 Text shadow of the titlebar of active windows.
1080
1081 ColorNormalMinimizedWindow = "rgb:C0/C0/C0"
1082 Background for mini icons of regular windows.
1083
1084 ColorNormalMinimizedWindowText = "rgb:00/00/00"
1085 Text color for mini icons of regular windows.
1086
1087 ColorActiveMinimizedWindow = "rgb:E0/E0/E0"
1088 Background for mini icons of active windows.
1089
1090 ColorActiveMinimizedWindowText = "rgb:00/00/00"
1091 Text color for mini icons of active windows.
1092
1093 ColorNormalMenu = "rgb:C0/C0/C0"
1094 Background of pop-up menus.
1095
1096 ColorNormalMenuItemText = "rgb:00/00/00"
1097 Text color of regular menu items.
1098
1099 ColorActiveMenuItem = "rgb:A0/A0/A0"
1100 Background of selected menu item, leave empty to force
1101 transparency.
1102
1103 ColorActiveMenuItemText = "rgb:00/00/00"
1104 Text color of selected menu items.
1105
1106 ColorDisabledMenuItemText = "rgb:80/80/80"
1107 Text color of disabled menu items.
1108
1109 ColorDisabledMenuItemShadow = ""
1110 Shadow of regular menu items.
1111
1112 ColorMoveSizeStatus = "rgb:C0/C0/C0"
1113 Background of move/resize status window.
1114
1115 ColorMoveSizeStatusText = "rgb:00/00/00"
1116 Text color of move/resize status window.
1117
1118 ColorQuickSwitch = "rgb:C0/C0/C0"
1119 Background of the quick switch window.
1120
1121 ColorQuickSwitchText = "rgb:00/00/00"
1122 Text color in the quick switch window.
1123
1124 ColorQuickSwitchActive = ""
1125 Rectangle around the active icon in the quick switch window.
1126
1127 ColorDefaultTaskBar = "rgb:C0/C0/C0"
1128 Background of the taskbar.
1129
1130 ColorNormalTaskBarApp = "rgb:C0/C0/C0"
1131 Background for task buttons of regular windows.
1132
1133 ColorNormalTaskBarAppText = "rgb:00/00/00"
1134 Text color for task buttons of regular windows.
1135
1136 ColorActiveTaskBarApp = "rgb:E0/E0/E0"
1137 Background for task buttons of the active window.
1138
1139 ColorActiveTaskBarAppText = "rgb:00/00/00"
1140 Text color for task buttons of the active window.
1141
1142 ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"
1143 Background for task buttons of minimized windows.
1144
1145 ColorMinimizedTaskBarAppText = "rgb:00/00/00"
1146 Text color for task buttons of minimized windows.
1147
1148 ColorInvisibleTaskBarApp = "rgb:80/80/80"
1149 Background for task buttons of windows on other workspaces.
1150
1151 ColorInvisibleTaskBarAppText = "rgb:00/00/00"
1152 Text color for task buttons of windows on other workspaces.
1153
1154 ColorScrollBar = "rgb:A0/A0/A0"
1155 Scrollbar background (sliding area).
1156
1157 ColorScrollBarSlider = "rgb:C0/C0/C0"
1158 Background of the slider button in scrollbars.
1159
1160 ColorScrollBarButton = "rgb:C0/C0/C0"
1161 Background of the arrow buttons in scrollbars.
1162
1163 ColorScrollBarArrow = "rgb:C0/C0/C0"
1164 Background of the arrow buttons in scrollbars (obsolete).
1165
1166 ColorScrollBarButtonArrow = "rgb:00/00/00"
1167 Color of active arrows on scrollbar buttons.
1168
1169 ColorScrollBarInactiveArrow = "rgb:80/80/80"
1170 Color of inactive arrows on scrollbar buttons.
1171
1172 ColorListBox = "rgb:C0/C0/C0"
1173 Background of listboxes.
1174
1175 ColorListBoxText = "rgb:00/00/00"
1176 Text color in listboxes.
1177
1178 ColorListBoxSelection = "rgb:80/80/80"
1179 Background of selected listbox items.
1180
1181 ColorListBoxSelectionText = "rgb:00/00/00"
1182 Text color of selected listbox items.
1183
1184 ColorToolTip = "rgb:E0/E0/00"
1185 Background of tooltips.
1186
1187 ColorToolTipText = "rgb:00/00/00"
1188 Text color of tooltips.
1189
1190 ColorLabel = "rgb:C0/C0/C0"
1191 Background of labels, leave empty to force transparency.
1192
1193 ColorLabelText = "rgb:00/00/00"
1194 Text color of labels.
1195
1196 ColorInput = "rgb:FF/FF/FF"
1197 Background of text entry fields (e.g., the addressbar).
1198
1199 ColorInputText = "rgb:00/00/00"
1200 Text color of text entry fields (e.g., the addressbar).
1201
1202 ColorInputSelection = "rgb:80/80/80"
1203 Background of selected text in an entry field.
1204
1205 ColorInputSelectionText = "rgb:00/00/00"
1206 Selected text in an entry field.
1207
1208 ColorClock = "rgb:00/00/00"
1209 Background of non-LCD clock, leave empty to force transparency.
1210
1211 ColorClockText = "rgb:00/FF/00"
1212 Background of non-LCD monitor.
1213
1214 ColorApm = "rgb:00/00/00"
1215 Background of battery monitor, leave empty to force transparency.
1216
1217 ColorApmText = "rgb:00/FF/00"
1218 Text color of battery monitor.
1219
1220 ColorApmBattery = "rgb:FF/FF/00"
1221 Color of battery monitor when discharging.
1222
1223 ColorApmLine = "rgb:00/FF/00"
1224 Color of battery monitor when charging.
1225
1226 ColorApmGraphBg = "rgb:00/00/00"
1227 Background color for graph mode.
1228
1229 ColorCPUStatusUser = "rgb:00/FF/00"
1230 User load on the CPU monitor.
1231
1232 ColorCPUStatusSystem = "rgb:FF/00/00"
1233 System load on the CPU monitor.
1234
1235 ColorCPUStatusInterrupts = "rgb:FF/FF/00"
1236 Interrupts on the CPU monitor.
1237
1238 ColorCPUStatusIoWait = "rgb:60/00/60"
1239 IO Wait on the CPU monitor.
1240
1241 ColorCPUStatusSoftIrq = "rgb:00/FF/FF"
1242 Soft Interrupts on the CPU monitor.
1243
1244 ColorCPUStatusNice = "rgb:00/00/FF"
1245 Nice load on the CPU monitor.
1246
1247 ColorCPUStatusIdle = "rgb:00/00/00"
1248 Idle (non) load on the CPU monitor, leave empty to force
1249 transparency.
1250
1251 ColorCPUStatusSteal = "rgb:FF/8A/91"
1252 Involuntary Wait on the CPU monitor.
1253
1254 ColorCPUStatusTemp = "rgb:60/60/C0"
1255 Temperature of the CPU.
1256
1257 ColorMEMStatusUser = "rgb:40/40/80"
1258 User program usage in the memory monitor.
1259
1260 ColorMEMStatusBuffers = "rgb:60/60/C0"
1261 OS buffers usage in the memory monitor.
1262
1263 ColorMEMStatusCached = "rgb:80/80/FF"
1264 OS cached usage in the memory monitor.
1265
1266 ColorMEMStatusFree = "rgb:00/00/00"
1267 Free memory in the memory monitor.
1268
1269 ColorNetSend = "rgb:FF/FF/00"
1270 Outgoing load on the network monitor.
1271
1272 ColorNetReceive = "rgb:FF/00/FF"
1273 Incoming load on the network monitor.
1274
1275 ColorNetIdle = "rgb:00/00/00"
1276 Idle (non) load on the network monitor, leave empty to force
1277 transparency.
1278
1279 DesktopBackgroundColor=""
1280 Desktop background color(s).
1281
1282 DesktopTransparencyColor=""
1283 Color(s) to announce for semitransparent windows.
1284
1285 DESKTOP BACKGROUND
1286
1287 The following preferences are read by icewmbg(1):
1288
1289 DesktopBackgroundCenter=0 0/1
1290 Display desktop background centered and not tiled.
1291
1292 DesktopBackgroundScaled=0 0/1
1293 Resize desktop background to full screen.
1294
1295 DesktopBackgroundColor=""
1296 Desktop background color(s).
1297
1298 DesktopBackgroundImage=""
1299 Desktop background image(s).
1300
1301 SupportSemitransparency=1 0/1
1302 Support for semitransparent terminals like Eterm or gnome-terminal.
1303
1304 DesktopTransparencyColor=""
1305 Color(s) to announce for semitransparent windows.
1306
1307 DesktopTransparencyImage=""
1308 Image(s) to announce for semitransparent windows.
1309
1310 DesktopBackgroundMultihead=0 0/1
1311 Paint the background image over all multihead monitors combined.
1312
1314 Alpha=1
1315 Splash="IceWM.jpg"
1316 LimitSize=0
1317 LimitPosition=0
1318 LimitByDockLayer=1
1319 QuickSwitchToAllWorkspaces=1
1320 QuickSwitchHugeIcon=1
1321 QuickSwitchFillSelection=1
1322 TaskBarMailboxStatusBeepOnNewMail=1
1323 TaskBarMailboxStatusCountMessages=1
1324 TaskBarShowMEMStatus=0
1325 TaskBarShowCollapseButton=1
1326 TaskBarWorkspacesLimit="8"
1327 ShowProgramsMenu=1
1328 ShowAddressBar=0
1329 ToolTipDelay=200
1330 ToolTipTime=5000
1331 AutoHideDelay=900
1332 AutoShowDelay=100
1333 EdgeResistance=3
1334 KeySysWinMenu=""
1335 KeySysWinListMenu="Shift+Ctrl+Esc"
1336
1337 The above example shows how to tell icewm to not bind a specific key:
1338 KeySysWinMenu in this case.
1339
1341 Locations for the preferences file are as follows:
1342
1343 $ICEWM_PRIVCFG/preferences
1344 $XDG_CONFIG_HOME/icewm/preferences
1345 $HOME/.icewm/preferences
1346 /etc/icewm/preferences
1347 /usr/share/icewm/preferences
1348
1349 The locations are searched in the order listed; the first file found is
1350 read and the remainder ignored.
1351
1353 icewm(1), icewm-prefoverride(5).
1354
1356 Brian Bidulock <mailto:bidulock@openss7.org>.
1357
1359 IceWM is licensed under the GNU Library General Public License. See
1360 the COPYING file in the distribution.
1361
1362
1363
1364icewm 2.3.4 2021-05-10 ICEWM-PREFERENCES(5)