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