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 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 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 Splash=""
37 Splash image on startup (IceWM.jpg)
38 Trace=""
40 Enable tracing for the given list of modules. Modules which are
41 traceable include conf, font, icon, prog, systray.
42 ClickToFocus=1
44 Focus windows by clicking in them.
45 FocusOnAppRaise=0
47 Focus windows when applications request that they be raised.
48 RequestFocusOnAppRaise=1
50 Request focus (flashing in taskbar) when application requests
51 raise.
52 RaiseOnFocus=1
54 Raise windows when focused.
55 FocusOnClickClient=1
57 Focus window when client area clicked.
58 RaiseOnClickClient=1
60 Raise window when client area clicked.
61 RaiseOnClickTitleBar=1
63 Raise window when title bar is clicked.
64 RaiseOnClickButton=1
66 Raise window when frame button is clicked.
67 RaiseOnClickFrame=1
69 Raise window when frame border is clicked.
70 LowerOnClickWhenRaised=0
72 Lower the active window when clicked again.
73 PassFirstClickToClient=1
75 Pass focusing click on client area to client.
76 FocusChangesWorkspace=0
78 Change to the workspace of newly focused windows.
79 FocusCurrentWorkspace=0
81 Move newly focused windows to current workspace.
82 FocusOnMap=1
84 Focus normal window when initially mapped.
85 FocusOnMapTransient=0
87 Focus dialog window when initially mapped.
88 FocusOnMapTransientActive=1
90 Focus dialog window when initially mapped only if parent frame
91 focused.
92 MapInactiveOnTop=1
94 Put new windows on top even if not focusing them.
95 PointerColormap=1
97 Colormap focus follows pointer.
98 DontRotateMenuPointer=1
100 Don't rotate the cursor for popup menus.
101 LimitSize=1
103 Limit size of windows to screen.
104 LimitPosition=1
106 Limit position of windows to screen.
107 LimitByDockLayer=0
109 Let the Dock layer limit the workspace (incompatible with GNOME
110 Panel).
111 ConsiderHBorder=0
113 Consider border frames when maximizing horizontally.
114 ConsiderVBorder=0
116 Consider border frames when maximizing vertically.
117 ConsiderSizeHintsMaximized=1
119 Consider XSizeHints if frame is maximized. Turning this off allows
120 the titlebar to cover the width of the screen.
121 CenterMaximizedWindows=0
123 Center maximized windows which can't fit the screen (like
124 terminals).
125 HideBordersMaximized=0
127 Hide window borders if window is maximized.
128 SizeMaximized=0
130 Maximized windows can be resized.
131 ShowMoveSizeStatus=1
133 Show position status window during move/resize.
134 ShowWorkspaceStatus=1
136 Show name of current workspace while switching.
137 MinimizeToDesktop=0
139 Display mini-icons on desktop for minimized windows.
140 MiniIconsPlaceHorizontal=0
142 Place the mini-icons horizontal instead of vertical.
143 MiniIconsRightToLeft=0
145 Place new mini-icons from right to left.
146 MiniIconsBottomToTop=0
148 Place new mini-icons from bottom to top.
149 StrongPointerFocus=0
151 Always maintain focus under mouse window (makes some keyboard
152 support non-functional or unreliable.
153 OpaqueMove=1
155 Opaque window move.
156 OpaqueResize=1
158 Opaque window resize.
159 ManualPlacement=0
161 Windows initially placed manually by user.
162 SmartPlacement=1
164 Smart window placement (minimal overlap).
165 HideTitleBarWhenMaximized=0
167 Hide title bar when maximized.
168 CenterLarge=0
170 Center large windows.
171 CenterTransientsOnOwner=1
173 Center dialogs on owner window.
174 MenuMouseTracking=0
176 Menus track mouse even with no mouse buttons held.
177 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 DelayPointerFocus=1
184 Delay pointer focusing when mouse moves.
185 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 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 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 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 ShowPopupsAbovePointer=0
207 Show popup menus above mouse pointer.
208 ReplayMenuCancelClick=0
210 Send the clicks outside menus to target window.
211 ClientWindowMouseActions=1
213 Allow mouse actions on client windows (buggy with some programs).
214 GrabRootWindow=1
216 Manage root window (EXPERIMENTAL - normally enabled!).
217 SnapMove=1
219 Snap to nearest screen edge/window when moving windows.
220 SnapDistance=8 [0-64]
222 Distance in pixels before windows snap together.
223 ArrangeWindowsOnScreenSizeChange=1
225 Automatically arrange windows when screen size changes.
226 AllowFullscreen=1
228 Allow to switch a window to fullscreen.
229 FullscreenUseAllMonitors=0
231 Span over all available screens if window goes into fullscreen.
232 MsgBoxDefaultAction=0 [0-1]
234 Preselect to Cancel (0) or the OK (1) button in message boxes.
235 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 QUICK SWITCH
242 QuickSwitch=1
243 Enable Alt+Tab window switching.
244 QuickSwitchToMinimized=1
246 Enable Alt+Tab to minimized windows.
247 QuickSwitchToHidden=1
249 Enable Alt+Tab to hidden windows.
250 QuickSwitchToUrgent=1
252 Prioritize Alt+Tab to urgent windows.
253 QuickSwitchToAllWorkspaces=0
255 Include windows from all workspaces in Alt+Tab.
256 QuickSwitchGroupWorkspaces=1
258 Group windows by workspace together in Alt+Tab.
259 QuickSwitchRaiseCandidate=0
261 Raise a selected window while Alt+Tabbing in the QuickSwitch.
262 QuickSwitchAllIcons=1
264 Show all reachable icons when quick switching.
265 QuickSwitchTextFirst=0
267 Show the window title above (all reachable) icons.
268 QuickSwitchSmallWindow=0
270 Create a smaller QuickSwitch window of 1/3 screen width.
271 QuickSwitchMaxWidth=0
273 Go trough all window titles and choose width of the longest one.
274 QuickSwitchVertical=1
276 Place the icons and titles vertical instead of horizontal.
277 QuickSwitchHugeIcon=0
279 Show the huge (48x48) of the window icon for the active window.
280 QuickSwitchFillSelection=0
282 Fill the rectangle highlighting the current icon.
283 EDGE SWITCHING
285 EdgeSwitch=0
286 Workspace switches by moving mouse to left/right screen edge.
287 HorizontalEdgeSwitch=0
289 Workspace switches by moving mouse to left/right screen edge.
290 VerticalEdgeSwitch=0
292 Workspace switches by moving mouse to top/bottom screen edge.
293 ContinuousEdgeSwitch=1
295 Workspace switches continuously when moving mouse to screen edge.
296 EdgeResistance=32 [0-10000]
298 Resistance in pixels when trying to move windows off the screen
299 (10000 = infinite).
300 TASK BAR
302 The following preferences affect the icewm(1) task bar:
303 ShowTaskBar=1
305 Show task bar.
306 TaskBarAtTop=0
308 Task bar at top of the screen.
309 TaskBarKeepBelow=0
311 Keep the task bar below regular windows.
312 TaskBarAutoHide=0
314 Auto hide task bar after delay.
315 TaskBarFullscreenAutoShow=1
317 Auto show task bar when fullscreen window active.
318 TaskBarShowClock=1
320 Show clock on task bar.
321 TaskBarShowAPMStatus=0
323 Show battery status monitor on task bar.
324 TaskBarShowAPMAuto=1
326 Enable TaskBarShowAPMStatus if a battery is present.
327 TaskBarShowAPMTime=1
329 Show battery status on task bar in time-format
330 TaskBarShowAPMGraph=1
332 Show battery status in graph mode.
333 TaskBarShowMailboxStatus=1
335 Show mailbox status on task bar.
336 TaskBarMailboxStatusBeepOnNewMail=0
338 Beep when new mail arrives.
339 TaskBarMailboxStatusCountMessages=0
341 Count messages in mailbox.
342 TaskBarShowWorkspaces=1
344 Show workspace switching buttons on task bar.
345 TaskBarShowWindows=1
347 Show windows on the taskbar.
348 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 ShowEllipsis=1
354 Show Ellipsis in taskbar items.
355 TaskBarShowTray=1
357 Show windows in the tray.
358 TaskBarEnableSystemTray=1
360 Enable the system tray in the taskbar.
361 TrayShowAllWindows=1
363 Show windows from all workspaces on tray.
364 TaskBarShowTransientWindows=1
366 Show transient (dialogs, ...) windows on task bar.
367 TaskBarShowAllWindows=0
369 Show windows from all workspaces on task bar.
370 TaskBarShowWindowIcons=1
372 Show icons of windows on the task bar.
373 TaskBarShowStartMenu=1
375 Show 'Start' menu on task bar.
376 TaskBarShowWindowListMenu=1
378 Show 'window list' menu on task bar.
379 TaskBarShowCPUStatus=1
381 Show CPU status on task bar (Linux & Solaris).
382 CPUStatusShowRamUsage=1
384 Show RAM usage in CPU status tool tip.
385 CPUStatusShowSwapUsage=1
387 Show swap usage in CPU status tool tip.
388 CPUStatusShowAcpiTemp=1
390 Show ACPI temperature in CPU status tool tip.
391 CPUStatusShowAcpiTempInGraph=0
393 Show ACPI temperature in CPU status bar.
394 CPUStatusShowCpuFreq=1
396 Show CPU frequency in CPU status tool tip.
397 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 TaskBarShowMEMStatus=1
404 Show memory usage status on task bar (Linux only).
405 TaskBarShowNetStatus=1
407 Show network status on task bar (Linux only).
408 TaskBarShowCollapseButton=0
410 Show a button to collapse the taskbar.
411 TaskBarDoubleHeight=0
413 Use double-height task bar.
414 TaskBarWorkspacesLeft=1
416 Place workspace pager on left, not right.
417 TaskBarWorkspacesTop=0
419 Place workspace pager on top row when using dual-height taskbar.
420 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 TaskBarUseMouseWheel=1
429 Enable mouse wheel cycling over workspaces and task buttons in
430 taskbar.
431 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 PagerShowPreview=1
439 Show a mini desktop preview on each workspace button.
440 PagerShowWindowIcons=1
442 Draw window icons inside large enough preview windows on pager (if
443 PagerShowPreview=1).
444 PagerShowMinimized=1
446 Draw even minimized windows as unfilled rectangles (if
447 PagerShowPreview=1).
448 PagerShowBorders=1
450 Draw border around workspace buttons (if PagerShowPreview=1).
451 PagerShowLabels=1
453 Show workspace name label on workspace button (if
454 PagerShowPreview=1)
455 PagerShowNumbers=1
457 Show number of workspace on workspace button (if
458 PagerShowPreview=1).
459 TaskBarLaunchOnSingleClick=1
461 Execute taskbar applet commands (like MailCommand, ClockCommand,
462 ...) on single click.
463 EnableAddressBar=1
465 Enable address bar functionality in taskbar.
466 ShowAddressBar=1
468 Show address bar in task bar.
469 MultiByte=1
471 Overrides automatic multiple byte detection.
472 ConfirmLogout=1
474 Confirm logout.
475 ShapesProtectClientWindow=1
477 Don't cut client windows by shapes set trough frame corner pixmap.
478 DoubleBuffer=1
480 Use double buffering when redrawing the display.
481 XRRDisable=1
483 Disable use of new XRANDR API for dual head (nvidia workaround).
484 PreferFreetypeFonts=1
486 Favour Xft fonts over core X11 fonts where possible.
487 MailBoxPath=""
489 A colon separated list of paths of your mailboxes. If this is
490 empty, $MAILPATH or $MAIL is used instead.
491 Path to a mbox file. Remote mail boxes are accessed by specifying
493 an URL using the Common Internet Scheme Syntax (RFC 1738):
494 `scheme://[user[:password]@]server[:port][/path]`.
496 Supported schemes are "pop3", "imap" and "file". When the scheme
498 is omitted file:// is prepended silently. IMAP subfolders can be
499 accessed by using the path component. Reserved characters like
500 slash ("/"), at ("@") and colon (":") can be specified using escape
501 sequences with a hexadecimal encoding like %2f for the slash or %40
502 for the at sign. For example:
503 file:///var/spool/mail/captnmark
505 pop3://markus:%2f%40%3a@maol.ch/
506 imap://mathias@localhost/INBOX.Maillisten.icewm-user
507 NetworkStatusDevice="eth0 wlan0"
509 Network device for which to show status.
510 TimeFormat="%X"
512 The clock time format. See the strftime manpage for the meaning of
513 all the percent options. It is possible to define multiple clocks
514 for different time zones in a single TimeFormat. A new clock is
515 defined by the beginning of the string, and by each time zone
516 specification which starts with "TZ=...", followed by a space. For
517 example, TimeFormat="%X TZ=Asia/Aden %T TZ=Asia/Baku %T" defines 3
518 clocks.
519 TimeFormatAlt=""
521 Alternate Clock Time format shown every other second.
522 DateFormat="%c"
524 Clock Date format for tooltip (strftime format string).
525 DockApps="right high desktop"
527 Support DockApps (right, left, center, down, high, above, below,
528 desktop, or empty to disable). Control with Ctrl+Mouse.
529 XRRPrimaryScreenName=""
531 Screen/output name of the primary screen.
532 AcpiIgnoreBatteries=""
534 List of battery names (directories) in /proc/acpi/battery to
535 ignore. Useful when more slots are built-in, but only one battery
536 is used.
537 TaskBarCPUSamples=20 [2-1000]
539 The width of the CPU Monitor applet in pixels.
540 TaskBarMEMSamples=20 [2-1000]
542 The width of the Memory Monitor applet in pixels.
543 TaskBarNetSamples=20 [2-1000]
545 The width of the Net Monitor applet in pixels.
546 TaskbarButtonWidthDivisor=3 [1-25]
548 Default number of tasks in taskbar.
549 TaskBarWidthPercentage=100 [0-100]
551 Task bar width as percentage of the screen width.
552 TaskBarJustify="left"
554 Taskbar justify left, right or center.
555 TaskBarApmGraphWidth=10 [1-1000]
557 Width of battery Monitor.
558 TaskBarGraphHeight=20 [16-1000]
560 Height of taskbar monitoring applets.
561 XineramaPrimaryScreen=0 [0-63]
563 Primary screen for xinerama (taskbar, ...).
564 TaskbuttonIconOffset=0 # [0-16]
566 Width of taskbutton side icons.
567 TrayIconMaxWidth=32 # [16-128]
569 Maximum scaled width of tray icons.
570 TrayIconMaxHeight=24 # [16-128]
572 Maximum scaled height of tray icons.
573 TrayDrawBevel=0 # 0/1
575 Surround the tray with plastic border.
576 KeyboardLayouts=""
578 A comma-separated list of keyboard layouts. A layout may be
579 enclosed in double quotes. Each layout is a name with optional
580 arguments, which is to be parsed by the "setxkbmap" program. To
581 support changing keyboard layouts, the "setxkbmap" program must be
582 installed. The first in the list is the default layout. Programs
583 may have their own keyboard layout defined in the winoptions file.
584 The first two letters of a layout are used to locate an icon image
585 file.
586 MENUS
588 AutoReloadMenus=1
589 Reload menu files automatically.
590 ShowProgramsMenu=0
592 Show programs submenu.
593 ShowSettingsMenu=1
595 Show settings submenu.
596 ShowFocusModeMenu=1
598 Show focus mode submenu.
599 ShowThemesMenu=1
601 Show themes submenu.
602 ShowLogoutMenu=1
604 Show logout menu.
605 ShowHelp=1
607 Show the help menu item.
608 ShowLogoutSubMenu=1
610 Show logout submenu.
611 ShowAbout=1
613 Show the about menu item.
614 ShowRun=1
616 Show the run menu item.
617 ShowWindowList=1
619 Show the window menu item.
620 MenuMaximalWidth=0 [0-16384]
622 Maximal width of popup menus, 2/3 of the screen's width if set to
623 zero.
624 NestedThemeMenuMinNumber=25 [0-1234]
626 Minimal number of themes after which the Themes menu becomes nested
627 (0=disabled).
628 TIMINGS
630 DelayFuzziness=10 (0-100)
631 Delay fuzziness, to allow merging of multiple timer timeouts into
632 one (notebook power saving).
633 ClickMotionDistance=4 [0-32]
635 Pointer motion distance before click gets interpreted as drag.
636 ClickMotionDelay=200 [0-2000]
638 Delay before click gets interpreted as drag.
639 MultiClickTime=400 [0-5000]
641 Multiple click time.
642 MenuActivateDelay=40 [0-5000]
644 Delay before activating menu items.
645 SubmenuMenuActivateDelay=300 [0-5000]
647 Delay before activating menu submenus.
648 ToolTipDelay=1000 [0-5000]
650 Delay before tooltip window is displayed.
651 ToolTipTime=0 [0-60000]
653 Time before tooltip window is hidden (0 means never.
654 AutoHideDelay=300 [0-5000]
656 Delay before task bar is hidden.
657 AutoShowDelay=500 [0-5000]
659 Delay before task bar is shown.
660 AutoRaiseDelay=400 [0-5000]
662 Delay before windows are auto raised if "AutoRaise=1".
663 PointerFocusDelay=200 [0-1000]
665 Delay for pointer focus switching.
666 EdgeSwitchDelay=600 [0-5000]
668 Screen edge workspace switching delay.
669 ScrollBarStartDelay=500 [0-5000]
671 Initial scroll bar autoscroll delay.
672 ScrollBarDelay=30 [0-5000]
674 Scroll bar autoscroll delay.
675 AutoScrollStartDelay=500 [0-5000]
677 Auto scroll start delay.
678 AutoScrollDelay=60 [0-5000]
680 Auto scroll delay.
681 WorkspaceStatusTime=2500 [0-2500]
683 Time before workspace status window is hidden.
684 MailCheckDelay=30 [0-86400]
686 Delay between new-mail checks. (seconds).
687 TaskBarCPUDelay=500 [10-3600000]
689 Delay between CPU Monitor samples in ms.
690 TaskBarMEMDelay=500 [10-3600000]
692 Delay between Memory Monitor samples in ms.
693 TaskBarNetDelay=500 [10-3600000]
695 Delay between Net Monitor samples in ms.
696 FocusRequestFlashTime=0 [0-86400]
698 Number of seconds the taskbar app will blink when requesting focus
699 (0 = forever).
700 FocusRequestFlashInterval=250 [0-30000]
702 Taskbar blink interval (ms) when requesting focus (0 = blinking
703 disabled).
704 BatteryPollingPeriod=10 [2-3600]
706 Delay between power status updates (seconds).
707 PingTimeout=3 [0-86400]
709 Timeout in seconds for applications to respond to the _NET_WM_PING
710 protocol.
711 BUTTONS AND KEYS
713 UseRootButtons=255 [0-255]
714 Bitmask of root window button click to use in window manager.
715 ButtonRaiseMask=1 [0-255]
717 Bitmask of buttons that raise the window when pressed.
718 DesktopWinMenuButton=0 [0-20]
720 Desktop mouse-button click to show the window list menu.
721 DesktopWinListButton=2 # [0-20]
723 Desktop mouse-button click to show the window list
724 DesktopMenuButton=3 [0-20]
726 Desktop mouse-button click to show the root menu.
727 TitleBarMaximizeButton=1 [0-5]
729 Title bar mouse-button double click to maximize the window to full
730 screen with the frame border visible. Press Shift to maximize only
731 in the vertical direction. Press Alt+Shift to maximize only in the
732 horizontal direction.
733 TitleBarRollupButton=2 [0-5]
735 Title bar mouse-button double click to rollup the window. Press
736 Shift to maximize in the horizontal direction.
737 WORKSPACES
739 WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
740 Create four workspaces with names 1 , 2 , 3 and 4 .
741 PATHS
743 IconPath="/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps"
744 Icon search path (colon separated). Also, the icons/ subdirectory
745 in IceWM resource folders are searched first.
746 IconThemes="*:-HighContrast"
748 List of icon themes (colon separated), acting as additional filter
749 of icon subdirectories in any of the IconPath folders. Expressions
750 can be wildcards, also special wildcards (starting with -) can
751 exclude matched themes from selection.
752 MailBoxPath=""
754 A colon separated list of paths of your mailboxes. If this is
755 empty, $MAILPATH or $MAIL is used instead.
756 PROGRAMS
758 MailCommand="xterm -name mutt -e mutt"
759 Command to run on mailbox.
760 MailClassHint="mutt.XTerm"
762 WM_CLASS to allow runonce for MailCommand.
763 NewMailCommand=""
765 Command to run when new mail arrives.
766 LockCommand=""
768 Command to lock display/screensaver.
769 ClockCommand="xclock -name icewm -title Clock"
771 Command to run on clock.
772 ClockClassHint="icewm.XClock"
774 WM_CLASS to allow runonce for ClockCommand.
775 RunCommand=""
777 Command to select and run a program.
778 OpenCommand=""
780 Open command.
781 TerminalCommand="xterm"
783 Terminal emulator must accept -e option.
784 LogoutCommand=""
786 Command to start logout.
787 LogoutCancelCommand=""
789 Command to cancel logout.
790 ShutdownCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
792 poweroff; } ||:""
793 Command to shutdown the system.
794 RebootCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
796 reboot; } ||:""
797 Command to reboot the system.
798 SuspendCommand="test -e /run/systemd/system && systemctl suspend"
800 Command to send the system to standby mode
801 CPUStatusCommand="xterm -name top -title Process\ Status -e top"
803 Command to run on CPU status.
804 CPUStatusClassHint="top.XTerm"
806 WM_CLASS to allow runonce for CPUStatusCommand.
807 CPUStatusCombine=1 0/1
809 Combine all CPUs to one.
810 NetStatusCommand="xterm -name netstat -title 'Network Status' -e
812 netstat -c"
813 Command to run on Net status.
814 NetStatusClassHint="netstat.XTerm"
816 WM_CLASS to allow runonce for NetStatusCommand.
817 AddressBarCommand=""
819 Command to run for address bar entries.
820 WINDOW MENUS
822 WinMenuItems="rmsnxfhualyticw"
823 Items supported in menu window (rmsnxfhualytickw)
824 RolloverButtonsSupported=0
826 Does it support the 'O' title bar button images (for mouse
827 rollover).
828 ShowMenuButtonIcon=1 # 0/1
830 Show application icon over menu button
831 THEME SETTINGS
833 The following sections show settings that can be set in theme files.
834 They can also be set in the preferences file, but themes will override
835 the values set there. To override the theme values, the settings
836 should be set in prefoverrides file: see icewm-prefoverrides(5).
837 Default values are shown following the equal sign.
838 THEME DESCRIPTION
840 ThemeAuthor=""
842 Theme author, e-mail address, credits.
843 ThemeDescription=""
845 Description of the theme, credits.
846 Look="nice"
848 Choose a theme look from one of: "win95", "motif", "warp3",
849 "warp4", "nice", "metal2", "gtk2", and some others.
850 Gradients=""
852 List of gradient pixmaps in the current theme.
853 THEME BORDERS, ICONS, MARGINS AND BUTTONS
855 BorderSizeX=6 [0-128]
857 Horizontal window border.
858 BorderSizeY=6 [0-128]
860 Vertical window border.
861 DlgBorderSizeX=2 [0-128]
863 Horizontal dialog window border.
864 DlgBorderSizeY=2 [0-128]
866 Vertical dialog window border.
867 CornerSizeX=24 [0-64]
869 Resize corner width.
870 CornerSizeY=24 [0-64]
872 Resize corner height.
873 TitleBarHeight=20 [0-128]
875 Title bar height.
876 TitleBarJustify=0 [0-100]
878 Justification of the window title.
879 TitleBarHorzOffset=0 [-128-128]
881 Horizontal offset for the window title text.
882 TitleBarVertOffset=0 [-128-128]
884 Vertical offset for the window title text.
885 MenuButtonIconVertOffset=0 [-128-128]
887 Vertical offset for the menu button icon.
888 ScrollBarX=16 [0-64]
890 Scrollbar width.
891 ScrollBarY=16 [0-64]
893 Scrollbar (button) height.
894 MenuIconSize=16 [8-128]
896 Menu icon size.
897 SmallIconSize=16 [8-128]
899 Dimension of the small icons.
900 LargeIconSize=32 [8-128]
902 Dimension of the large icons.
903 HugeIconSize=48 [8-128]
905 Dimension of the large icons.
906 QuickSwitchHorzMargin=3 [0-64]
908 Horizontal margin of the quickswitch window.
909 QuickSwitchVertMargin=3 [0-64]
911 Vertical margin of the quickswitch window.
912 QuickSwitchIconMargin=4 [0-64]
914 Vertical margin in the quickswitch window.
915 QuickSwitchIconBorder=2 [0-64]
917 Distance between the active icon and it's border.
918 QuickSwitchSeparatorSize=6 [0-64]
920 Height of the separator between (all reachable) icons and text, 0
921 to avoid it.
922 TitleButtonsLeft="s"
924 Titlebar buttons from left to right (x=close, m=max, i=min, h=hide,
925 r=rollup, s=sysmenu, d=depth).
926 TitleButtonsRight="xmir"
928 Titlebar buttons from right to left (x=close, m=max, i=min, h=hide,
929 r=rollup, s=sysmenu, d=depth).
930 TitleButtonsSupported="xmis"
932 Titlebar buttons supported by theme (x,m,i,r,h,s,d).
933 TitleBarCentered=0 # 0/1
935 Draw window title centered (obsoleted by TitleBarJustify).
936 TitleBarJoinLeft=0 # 0/1
938 Join title*S and title*T.
939 TitleBarJoinRight=0 # 0/1
941 Join title*T and title*B.
942 THEME FONTS
944 TitleFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
946 TitleFontNameXft="sans-serif:size=12"
947 Name of the title bar font.
948 MenuFontName="-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"
950 MenuFontNameXft="sans-serif:size=10:bold"
951 Name of the menu font.
952 StatusFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
954 StatusFontNameXft="monospace:size=12:bold"
955 Name of the status display font.
956 QuickSwitchFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
958 QuickSwitchFontNameXft="monospace:size=12:bold"
959 Name of the font for Alt+Tab switcher window.
960 NormalButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
962 NormalButtonFontNameXft="sans-serif:size=12"
963 Name of the normal button font.
964 ActiveButtonFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
966 ActiveButtonFontNameXft="sans-serif:size=12:bold"
967 Name of the active button font.
968 NormalTaskBarFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
970 NormalTaskBarFontNameXft="sans-serif:size=12"
971 Name of the normal task bar item font.
972 ActiveTaskBarFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
974 ActiveTaskBarFontNameXft="sans-serif:size=12:bold"
975 Name of the active task bar item font.
976 ToolButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
978 ToolButtonFontNameXft="sans-serif:size=12"
979 Name of the tool button font (fallback: NormalButtonFontName).
980 NormalWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
982 NormalWorkspaceFontNameXft="sans-serif:size=12"
983 Name of the normal workspace button font (fallback:
984 NormalButtonFontName).
985 ActiveWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
987 ActiveWorkspaceFontNameXft="sans-serif:size=12"
988 Name of the active workspace button font (fallback:
989 ActiveButtonFontName).
990 MinimizedWindowFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
992 MinimizedWindowFontNameXft="sans-serif:size=12"
993 Name of the mini-window font.
994 ListBoxFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
996 ListBoxFontNameXft="sans-serif:size=12"
997 Name of the window list font.
998 ToolTipFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
1000 ToolTipFontNameXft="sans-serif:size=12"
1001 Name of the tool tip font.
1002 ClockFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1004 ClockFontNameXft="monospace:size=12"
1005 Name of the task bar clock font.
1006 TempFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1008 TempFontNameXft="monospace:size=12"
1009 Name of the task bar temperature font.
1010 ApmFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1012 ApmFontNameXft="monospace:size=12"
1013 Name of the task bar battery font.
1014 InputFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1016 InputFontNameXft="monospace:size=12"
1017 Name of the input field font.
1018 LabelFontName="-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"
1020 LabelFontNameXft="sans-serif:size=12"
1021 Name of the label font.
1022 THEME COLORS
1024 ColorDialog = "rgb:C0/C0/C0"
1026 Background of dialog windows.
1027 ColorNormalBorder = "rgb:C0/C0/C0"
1029 Border of inactive windows.
1030 ColorActiveBorder = "rgb:C0/C0/C0"
1032 Border of active windows.
1033 ColorNormalButton = "rgb:C0/C0/C0"
1035 Background of regular buttons.
1036 ColorNormalButtonText = "rgb:00/00/00"
1038 Text color of regular buttons.
1039 ColorActiveButton = "rgb:E0/E0/E0"
1041 Background of pressed buttons.
1042 ColorActiveButtonText = "rgb:00/00/00"
1044 Text color of pressed buttons.
1045 ColorNormalTitleButton = "rgb:C0/C0/C0"
1047 Background of titlebar buttons.
1048 ColorNormalTitleButtonText = "rgb:00/00/00"
1050 Text color of titlebar buttons.
1051 ColorToolButton = ""
1053 Background of toolbar buttons, ColorNormalButton is used if empty.
1054 ColorToolButtonText = ""
1056 Text color of toolbar buttons, ColorNormalButtonText is used if
1057 empty.
1058 ColorNormalWorkspaceButton = ""
1060 Background of workspace buttons, ColorNormalButton is used if
1061 empty.
1062 ColorNormalWorkspaceButtonText = ""
1064 Text color of workspace buttons, ColorNormalButtonText is used if
1065 empty.
1066 ColorActiveWorkspaceButton = ""
1068 Background of the active workspace button, ColorActiveButton is
1069 used if empty.
1070 ColorActiveWorkspaceButtonText = ""
1072 Text color of the active workspace button, ColorActiveButtonText is
1073 used if empty.
1074 ColorNormalTitleBar = "rgb:80/80/80"
1076 Background of the titlebar of regular windows.
1077 ColorNormalTitleBarText = "rgb:00/00/00"
1079 Text color of the titlebar of regular windows.
1080 ColorNormalTitleBarShadow = ""
1082 Text shadow of the titlebar of regular windows.
1083 ColorActiveTitleBar = "rgb:00/00/A0"
1085 Background of the titlebar of active windows.
1086 ColorActiveTitleBarText = "rgb:FF/FF/FF"
1088 Text color of the titlebar of active windows.
1089 ColorActiveTitleBarShadow = ""
1091 Text shadow of the titlebar of active windows.
1092 ColorNormalMinimizedWindow = "rgb:C0/C0/C0"
1094 Background for mini icons of regular windows.
1095 ColorNormalMinimizedWindowText = "rgb:00/00/00"
1097 Text color for mini icons of regular windows.
1098 ColorActiveMinimizedWindow = "rgb:E0/E0/E0"
1100 Background for mini icons of active windows.
1101 ColorActiveMinimizedWindowText = "rgb:00/00/00"
1103 Text color for mini icons of active windows.
1104 ColorNormalMenu = "rgb:C0/C0/C0"
1106 Background of pop-up menus.
1107 ColorNormalMenuItemText = "rgb:00/00/00"
1109 Text color of regular menu items.
1110 ColorActiveMenuItem = "rgb:A0/A0/A0"
1112 Background of selected menu item, leave empty to force
1113 transparency.
1114 ColorActiveMenuItemText = "rgb:00/00/00"
1116 Text color of selected menu items.
1117 ColorDisabledMenuItemText = "rgb:80/80/80"
1119 Text color of disabled menu items.
1120 ColorDisabledMenuItemShadow = ""
1122 Shadow of regular menu items.
1123 ColorMoveSizeStatus = "rgb:C0/C0/C0"
1125 Background of move/resize status window.
1126 ColorMoveSizeStatusText = "rgb:00/00/00"
1128 Text color of move/resize status window.
1129 ColorQuickSwitch = "rgb:C0/C0/C0"
1131 Background of the quick switch window.
1132 ColorQuickSwitchText = "rgb:00/00/00"
1134 Text color in the quick switch window.
1135 ColorQuickSwitchActive = ""
1137 Rectangle around the active icon in the quick switch window.
1138 ColorDefaultTaskBar = "rgb:C0/C0/C0"
1140 Background of the taskbar.
1141 ColorNormalTaskBarApp = "rgb:C0/C0/C0"
1143 Background for task buttons of regular windows.
1144 ColorNormalTaskBarAppText = "rgb:00/00/00"
1146 Text color for task buttons of regular windows.
1147 ColorActiveTaskBarApp = "rgb:E0/E0/E0"
1149 Background for task buttons of the active window.
1150 ColorActiveTaskBarAppText = "rgb:00/00/00"
1152 Text color for task buttons of the active window.
1153 ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"
1155 Background for task buttons of minimized windows.
1156 ColorMinimizedTaskBarAppText = "rgb:00/00/00"
1158 Text color for task buttons of minimized windows.
1159 ColorInvisibleTaskBarApp = "rgb:80/80/80"
1161 Background for task buttons of windows on other workspaces.
1162 ColorInvisibleTaskBarAppText = "rgb:00/00/00"
1164 Text color for task buttons of windows on other workspaces.
1165 ColorScrollBar = "rgb:A0/A0/A0"
1167 Scrollbar background (sliding area).
1168 ColorScrollBarSlider = "rgb:C0/C0/C0"
1170 Background of the slider button in scrollbars.
1171 ColorScrollBarButton = "rgb:C0/C0/C0"
1173 Background of the arrow buttons in scrollbars.
1174 ColorScrollBarArrow = "rgb:C0/C0/C0"
1176 Background of the arrow buttons in scrollbars (obsolete).
1177 ColorScrollBarButtonArrow = "rgb:00/00/00"
1179 Color of active arrows on scrollbar buttons.
1180 ColorScrollBarInactiveArrow = "rgb:80/80/80"
1182 Color of inactive arrows on scrollbar buttons.
1183 ColorListBox = "rgb:C0/C0/C0"
1185 Background of listboxes.
1186 ColorListBoxText = "rgb:00/00/00"
1188 Text color in listboxes.
1189 ColorListBoxSelection = "rgb:80/80/80"
1191 Background of selected listbox items.
1192 ColorListBoxSelectionText = "rgb:00/00/00"
1194 Text color of selected listbox items.
1195 ColorToolTip = "rgb:E0/E0/00"
1197 Background of tooltips.
1198 ColorToolTipText = "rgb:00/00/00"
1200 Text color of tooltips.
1201 ColorLabel = "rgb:C0/C0/C0"
1203 Background of labels, leave empty to force transparency.
1204 ColorLabelText = "rgb:00/00/00"
1206 Text color of labels.
1207 ColorInput = "rgb:FF/FF/FF"
1209 Background of text entry fields (e.g., the addressbar).
1210 ColorInputText = "rgb:00/00/00"
1212 Text color of text entry fields (e.g., the addressbar).
1213 ColorInputSelection = "rgb:80/80/80"
1215 Background of selected text in an entry field.
1216 ColorInputSelectionText = "rgb:00/00/00"
1218 Selected text in an entry field.
1219 ColorClock = "rgb:00/00/00"
1221 Background of non-LCD clock, leave empty to force transparency.
1222 ColorClockText = "rgb:00/FF/00"
1224 Text color of non-LCD clock.
1225 ColorKeyboardLayoutText = ""
1227 Color of keyboard layout indicator.
1228 ColorApm = "rgb:00/00/00"
1230 Background of battery monitor, leave empty to force transparency.
1231 ColorApmText = "rgb:00/FF/00"
1233 Text color of battery monitor.
1234 ColorApmBattery = "rgb:FF/FF/00"
1236 Color of battery monitor when discharging.
1237 ColorApmLine = "rgb:00/FF/00"
1239 Color of battery monitor when charging.
1240 ColorApmGraphBg = "rgb:00/00/00"
1242 Background color for graph mode.
1243 ColorCPUStatusUser = "rgb:00/FF/00"
1245 User load on the CPU monitor.
1246 ColorCPUStatusSystem = "rgb:FF/00/00"
1248 System load on the CPU monitor.
1249 ColorCPUStatusInterrupts = "rgb:FF/FF/00"
1251 Interrupts on the CPU monitor.
1252 ColorCPUStatusIoWait = "rgb:60/00/60"
1254 IO Wait on the CPU monitor.
1255 ColorCPUStatusSoftIrq = "rgb:00/FF/FF"
1257 Soft Interrupts on the CPU monitor.
1258 ColorCPUStatusNice = "rgb:00/00/FF"
1260 Nice load on the CPU monitor.
1261 ColorCPUStatusIdle = "rgb:00/00/00"
1263 Idle (non) load on the CPU monitor, leave empty to force
1264 transparency.
1265 ColorCPUStatusSteal = "rgb:FF/8A/91"
1267 Involuntary Wait on the CPU monitor.
1268 ColorCPUStatusTemp = "rgb:60/60/C0"
1270 Temperature of the CPU.
1271 ColorMEMStatusUser = "rgb:40/40/80"
1273 User program usage in the memory monitor.
1274 ColorMEMStatusBuffers = "rgb:60/60/C0"
1276 OS buffers usage in the memory monitor.
1277 ColorMEMStatusCached = "rgb:80/80/FF"
1279 OS cached usage in the memory monitor.
1280 ColorMEMStatusFree = "rgb:00/00/00"
1282 Free memory in the memory monitor.
1283 ColorNetSend = "rgb:FF/FF/00"
1285 Outgoing load on the network monitor.
1286 ColorNetReceive = "rgb:FF/00/FF"
1288 Incoming load on the network monitor.
1289 ColorNetIdle = "rgb:00/00/00"
1291 Idle (non) load on the network monitor, leave empty to force
1292 transparency.
1293 DesktopBackgroundColor=""
1295 Desktop background color(s).
1296 DesktopTransparencyColor=""
1298 Color(s) to announce for semitransparent windows.
1299 DESKTOP BACKGROUND
1301 The following preferences are read by icewmbg(1):
1303 DesktopBackgroundCenter=0 0/1
1305 Display desktop background centered and not tiled.
1306 DesktopBackgroundScaled=0 0/1
1308 Resize desktop background to full screen.
1309 DesktopBackgroundColor=""
1311 Desktop background color(s).
1312 DesktopBackgroundImage=""
1314 Desktop background image(s).
1315 SupportSemitransparency=1 0/1
1317 Support for semitransparent terminals like Eterm or gnome-terminal.
1318 DesktopTransparencyColor=""
1320 Color(s) to announce for semitransparent windows.
1321 DesktopTransparencyImage=""
1323 Image(s) to announce for semitransparent windows.
1324 DesktopBackgroundMultihead=0 0/1
1326 Paint the background image over all multihead monitors combined.
1327 EXAMPLES
1329 Alpha=1
1330 Splash="IceWM.jpg"
1331 LimitSize=0
1332 LimitPosition=0
1333 LimitByDockLayer=1
1334 QuickSwitchToAllWorkspaces=1
1335 QuickSwitchHugeIcon=1
1336 QuickSwitchFillSelection=1
1337 TaskBarMailboxStatusBeepOnNewMail=1
1338 TaskBarMailboxStatusCountMessages=1
1339 TaskBarShowMEMStatus=0
1340 TaskBarShowCollapseButton=1
1341 TaskBarWorkspacesLimit="8"
1342 ShowProgramsMenu=1
1343 ShowAddressBar=0
1344 ToolTipDelay=200
1345 ToolTipTime=5000
1346 AutoHideDelay=900
1347 AutoShowDelay=100
1348 EdgeResistance=3
1349 KeySysWinMenu=""
1350 KeySysWinListMenu="Shift+Ctrl+Esc"
1351 The above example shows how to tell icewm to not bind a specific key:
1353 KeySysWinMenu in this case.
1354 FILES
1356 Locations for the preferences file are as follows:
1357 $ICEWM_PRIVCFG/preferences
1359 $XDG_CONFIG_HOME/icewm/preferences
1360 $HOME/.icewm/preferences
1361 /etc/icewm/preferences
1362 /usr/share/icewm/preferences
1363 The locations are searched in the order listed; the first file found is
1365 read and the remainder ignored.
1366 SEE ALSO
1368 icewm(1), icewm-prefoverride(5).
1369 AUTHOR
1371 Brian Bidulock <mailto:bidulock@openss7.org>.
1372 LICENSE
1374 IceWM is licensed under the GNU Library General Public License. See
1375 the COPYING file in the distribution.
1376icewm 2.9.7 2022-05-16 ICEWM-PREFERENCES(5)