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