1ICEWM-PREFERENCES(5) Standards, Environments and Macros ICEWM-PREFERENCES(5)
2
6 icewm-preferences - icewm preferences configuration file
7
9 $ICEWM_PRIVCFG/preferences
10 $XDG_CONFIG_HOME/icewm/preferences
11 $HOME/.icewm/preferences
12 /etc/icewm/preferences
13 /usr/share/icewm/preferences
14
16 Contains general settings like paths, colors and fonts, but also
17 options to control the icewm focus behaviour and the applets which are
18 started in the task bar. The icewm installation will provide a default
19 preferences file, which can be copied to the icewm user configuration
20 directory and modified.
21
23 FOCUS AND BEHAVIOR
24 The following preferences affect focus and general behavior of
25 icewm(1):
26 ClickToFocus=1
28 Focus windows by clicking in them.
29 FocusOnAppRaise=0
31 Focus windows when applications request that they be raised.
32 RequestFocusOnAppRaise=1
34 Request focus (flashing in taskbar) when application requests
35 raise.
36 RaiseOnFocus=1
38 Raise windows when focused.
39 FocusOnClickClient=1
41 Focus window when client area clicked.
42 RaiseOnClickClient=1
44 Raise window when client area clicked.
45 RaiseOnClickTitleBar=1
47 Raise window when title bar is clicked.
48 RaiseOnClickButton=1
50 Raise window when frame button is clicked.
51 RaiseOnClickFrame=1
53 Raise window when frame border is clicked.
54 LowerOnClickWhenRaised=0
56 Lower the active window when clicked again.
57 PassFirstClickToClient=1
59 Pass focusing click on client area to client.
60 FocusChangesWorkspace=0
62 Change to the workspace of newly focused windows.
63 FocusCurrentWorkspace=0
65 Move newly focused windows to current workspace.
66 FocusOnMap=1
68 Focus normal window when initially mapped.
69 FocusOnMapTransient=0
71 Focus dialog window when initially mapped.
72 FocusOnMapTransientActive=1
74 Focus dialog window when initially mapped only if parent frame
75 focused.
76 MapInactiveOnTop=1
78 Put new windows on top even if not focusing them.
79 PointerColormap=1
81 Colormap focus follows pointer.
82 DontRotateMenuPointer=1
84 Don't rotate the cursor for popup menus.
85 LimitSize=1
87 Limit size of windows to screen.
88 LimitPosition=1
90 Limit position of windows to screen.
91 LimitByDockLayer=0
93 Let the Dock layer limit the workspace (incompatible with GNOME
94 Panel).
95 ConsiderHBorder=0
97 Consider border frames when maximizing horizontally.
98 ConsiderVBorder=0
100 Consider border frames when maximizing vertically.
101 ConsiderSizeHintsMaximized=1
103 Consider XSizeHints if frame is maximized.
104 CenterMaximizedWindows=0
106 Center maximized windows which can't fit the screen (like
107 terminals).
108 HideBordersMaximized=0
110 Hide window borders if window is maximized.
111 SizeMaximized=0
113 Maximized windows can be resized.
114 ShowMoveSizeStatus=1
116 Show position status window during move/resize.
117 ShowWorkspaceStatus=1
119 Show name of current workspace while switching.
120 MinimizeToDesktop=0
122 Display mini-icons on desktop for minimized windows.
123 MiniIconsPlaceHorizontal=0
125 Place the mini-icons horizontal instead of vertical.
126 MiniIconsRightToLeft=0
128 Place new mini-icons from right to left.
129 MiniIconsBottomToTop=0
131 Place new mini-icons from bottom to top.
132 StrongPointerFocus=0
134 Always maintain focus under mouse window (makes some keyboard
135 support non-functional or unreliable.
136 OpaqueMove=1
138 Opaque window move.
139 OpaqueResize=1
141 Opaque window resize.
142 ManualPlacement=0
144 Windows initially placed manually by user.
145 SmartPlacement=1
147 Smart window placement (minimal overlap).
148 HideTitleBarWhenMaximized=0
150 Hide title bar when maximized.
151 CenterLarge=0
153 Center large windows.
154 CenterTransientsOnOwner=1
156 Center dialogs on owner window.
157 MenuMouseTracking=0
159 Menus track mouse even with no mouse buttons held.
160 AutoRaise=0
162 Auto raise windows after delay.
163 DelayPointerFocus=1
165 Delay pointer focusing when mouse moves.
166 Win95Keys=1
168 Support win95 keyboard keys (Penguin/Meta/Win_L,R shows menu).
169 ModSuperIsCtrlAlt=1
171 Treat Super/Win modifier as Ctrl+Alt.
172 UseMouseWheel=0
174 Support mouse wheel.
175 ShowPopupsAbovePointer=0
177 Show popup menus above mouse pointer.
178 ReplayMenuCancelClick=0
180 Send the clicks outside menus to target window.
181 ClientWindowMouseActions=1
183 Allow mouse actions on client windows (buggy with some programs).
184 GrabRootWindow=1
186 Manage root window (EXPERIMENTAL - normally enabled!).
187 SnapMove=1
189 Snap to nearest screen edge/window when moving windows.
190 SnapDistance=8 [0-64]
192 Distance in pixels before windows snap together.
193 ArrangeWindowsOnScreenSizeChange=1
195 Automatically arrange windows when screen size changes.
196 AllowFullscreen=1
198 Allow to switch a window to fullscreen.
199 FullscreenUseAllMonitors=0
201 Span over all available screens if window goes into fullscreen.
202 MsgBoxDefaultAction=0 [0-1]
204 Preselect to Cancel (0) or the OK (1) button in message boxes.
205 NetWorkAreaBehaviour=0 [0-2]
207 NET_WORKAREA behaviour: 0 (single/multi-monitor with STRUT
208 information, like metacity), 1 (always full desktop), 2 (single
209 monitor with STRUT, multi-monitor without STRUT).
210 Quick Switch List
212 QuickSwitch=1
214 Alt+Tab window switching.
215 QuickSwitchToMinimized=1
217 Alt+Tab to minimized windows.
218 QuickSwitchToHidden=1
220 Alt+Tab to hidden windows.
221 QuickSwitchToUrgent=1
223 Priorize Alt+Tab to urgent windows.
224 QuickSwitchToAllWorkspaces=0
226 Alt+Tab to windows on other workspaces.
227 QuickSwitchGroupWorkspaces=1
229 Alt+Tab: group windows on current workspace.
230 QuickSwitchAllIcons=1
232 Show all reachable icons when quick switching.
233 QuickSwitchTextFirst=0
235 Show the window title above (all reachable) icons.
236 QuickSwitchSmallWindow=0
238 Attempt to create a small QuickSwitch window (1/3 instead of 3/5 of
239 QuickSwitchMaxWidth=0
241 Go through all window titles and choose width of the longest one.
242 QuickSwitchVertical=1
244 Place the icons and titles vertical instead of horizontal.
245 QuickSwitchHugeIcon=0
247 Show the huge (48x48) of the window icon for the active window.
248 QuickSwitchFillSelection=0
250 Fill the rectangle highlighting the current icon.
251 Edge Workspace Switching
253 EdgeSwitch=0
255 Workspace switches by moving mouse to left/right screen edge.
256 HorizontalEdgeSwitch=0
258 Workspace switches by moving mouse to left/right screen edge.
259 VerticalEdgeSwitch=0
261 Workspace switches by moving mouse to top/bottom screen edge.
262 ContinuousEdgeSwitch=1
264 Workspace switches continuously when moving mouse to screen edge.
265 EdgeResistance=32 [0-10000]
267 Resistance in pixels when trying to move windows off the screen
268 (10000 = infinite).
269 TASK BAR
271 The following preferences affect the icewm(1) task bar:
272 ShowTaskBar=1
274 Show task bar.
275 TaskBarAtTop=0
277 Task bar at top of the screen.
278 TaskBarKeepBelow=0
280 Keep the task bar below regular windows.
281 TaskBarAutoHide=0
283 Auto hide task bar after delay.
284 TaskBarFullscreenAutoShow=1
286 Auto show task bar when fullscreen window active.
287 TaskBarShowClock=1
289 Show clock on task bar.
290 TaskBarShowAPMStatus=0
292 Show APM/ACPI/Battery/Power status monitor on task bar.
293 TaskBarShowAPMAuto=1
295 Enable TaskBarShowAPMStatus if a battery is present.
296 TaskBarShowAPMTime=1
298 Show APM status on task bar in time-format.
299 TaskBarShowAPMGraph=1
301 Show APM status in graph mode.
302 TaskBarShowMailboxStatus=1
304 Show mailbox status on task bar.
305 TaskBarMailboxStatusBeepOnNewMail=0
307 Beep when new mail arrives.
308 TaskBarMailboxStatusCountMessages=0
310 Count messages in mailbox.
311 TaskBarShowWorkspaces=1
313 Show workspace switching buttons on task bar.
314 TaskBarShowWindows=1
316 Show windows on the taskbar.
317 TaskBarShowShowDesktopButton=1
319 Show 'show desktop' button on taskbar.
320 ShowEllipsis=1
322 Show Ellipsis in taskbar items.
323 TaskBarShowTray=1
325 Show windows in the tray.
326 TaskBarEnableSystemTray=1
328 Enable the system tray in the taskbar.
329 TrayShowAllWindows=1
331 Show windows from all workspaces on tray.
332 TaskBarShowTransientWindows=1
334 Show transient (dialogs, ...) windows on task bar.
335 TaskBarShowAllWindows=0
337 Show windows from all workspaces on task bar.
338 TaskBarShowWindowIcons=1
340 Show icons of windows on the task bar.
341 TaskBarShowStartMenu=1
343 Show 'Start' menu on task bar.
344 TaskBarShowWindowListMenu=1
346 Show 'window list' menu on task bar.
347 TaskBarShowCPUStatus=1
349 Show CPU status on task bar (Linux & Solaris).
350 CPUStatusShowRamUsage=1
352 Show RAM usage in CPU status tool tip.
353 CPUStatusShowSwapUsage=1
355 Show swap usage in CPU status tool tip.
356 CPUStatusShowAcpiTemp=1
358 Show ACPI temperature in CPU status tool tip.
359 CPUStatusShowAcpiTempInGraph=0
361 Show ACPI temperature in CPU status bar.
362 CPUStatusShowCpuFreq=1
364 Show CPU frequency in CPU status tool tip.
365 TaskBarShowMEMStatus=1
367 Show memory usage status on task bar (Linux only).
368 TaskBarShowNetStatus=1
370 Show network status on task bar (Linux only).
371 TaskBarShowCollapseButton=0
373 Show a button to collapse the taskbar.
374 TaskBarDoubleHeight=0
376 Use double-height task bar.
377 TaskBarWorkspacesLeft=1
379 Place workspace pager on left, not right.
380 TaskBarWorkspacesTop=0
382 Place workspace pager on top row when using dual-height taskbar.
383 TaskBarWorkspacesLimit=""
385 Limit the number of taskbar workspaces buttons which are shown on
386 the workspaces pane of the taskbar. If the numeric value has a "p"
387 suffix then the limitation is in pixels. A "%" suffix limits by
388 percentage of desktop width. By default a "B" suffix is assumed for
389 number of buttons.
390 TaskBarUseMouseWheel=1
392 Enable mouse wheel cycling over workspaces and task buttons in
393 taskbar.
394 TaskBarClockLeds=0 # 0/1
396 Task bar clock/APM uses nice pixmapped LCD display (but then it
397 doesn't display correctly in many languages anymore, e.g. for
398 Japanese and Korean it works only when a real font is used and not
399 the LEDs.
400 PagerShowPreview=1
402 Show a mini desktop preview on each workspace button.
403 PagerShowWindowIcons=1
405 Draw window icons inside large enough preview windows on pager (if
406 PagerShowPreview=1).
407 PagerShowMinimized=1
409 Draw even minimized windows as unfilled rectangles (if
410 PagerShowPreview=1).
411 PagerShowBorders=1
413 Draw border around workspace buttons (if PagerShowPreview=1).
414 PagerShowNumbers=1
416 Show number of workspace on workspace button (if
417 PagerShowPreview=1).
418 TaskBarLaunchOnSingleClick=1
420 Execute taskbar applet commands (like MailCommand,
421 ClockCommand, ...) on single click.
422 EnableAddressBar=1
424 Enable address bar functionality in taskbar.
425 ShowAddressBar=1
427 Show address bar in task bar.
428 MultiByte=1
430 Overrides automatic multiple byte detection.
431 ConfirmLogout=1
433 Confirm logout.
434 ShapesProtectClientWindow=1
436 Don't cut client windows by shapes set trough frame corner pixmap.
437 DoubleBuffer=1
439 Use double buffering when redrawing the display.
440 XRRDisable=1
442 Disable use of new XRANDR API for dual head (nvidia workaround).
443 PreferFreetypeFonts=1
445 Favor Xft fonts over core X11 fonts where possible.
446 MailBoxPath=""
448 Mailbox path (use \$MAIL instead).
449 Path to a mbox file. Remote mail boxes are accessed by specifying
451 an URL using the Common Internet Scheme Syntax (RFC 1738):
452 `scheme://[user[:password]@]server[:port][/path]`.
454 Supported schemes are "pop3", "imap" and "file". When the scheme
456 is omitted file:// is prepended silently. IMAP subfolders can be
457 accessed by using the path component. Reserved characters like
458 slash ("/"), at ("@") and colon (":") can be specified using escape
459 sequences with a hexadecimal encoding like %2f for the slash or %40
460 for the at sign. For example:
461 file:///var/spool/mail/captnmark
463 pop3://markus:%2f%40%3a@maol.ch/
464 imap://mathias@localhost/INBOX.Maillisten.icewm-user
465 NetworkStatusDevice="eth0 wlan0"
467 Network device for which to show status.
468 TimeFormat="%X"
470 Clock Time format (strftime format string).
471 TimeFormatAlt=""
473 Alternate Clock Time format (e.g. for blinking effects).
474 DateFormat="%c"
476 Clock Date format for tooltip (strftime format string).
477 XRRPrimaryScreenName=""
479 Screen/output name of the primary screen.
480 AcpiIgnoreBatteries=""
482 List of battery names (directories) in /proc/acpi/battery to
483 ignore. Useful when more slots are built-in, but only one battery
484 is used.
485 TaskBarCPUSamples=20 [2-1000]
487 Width of CPU Monitor.
488 TaskBarMEMSamples=20 [2-1000]
490 Width of Memory Monitor.
491 TaskBarNetSamples=20 [2-1000]
493 Width of Net Monitor.
494 TaskbarButtonWidthDivisor=3 [1-25]
496 Default number of tasks in taskbar.
497 TaskBarWidthPercentage=100 [0-100]
499 Task bar width as percentage of the screen width.
500 TaskBarJustify="left"
502 Taskbar justify left, right or center.
503 TaskBarApmGraphWidth=10 [1-1000]
505 Width of APM Monitor.
506 TaskBarGraphHeight=20 [16-1000]
508 Height of taskbar monitoring applets.
509 XineramaPrimaryScreen=0 [0-63]
511 Primary screen for xinerama (taskbar, ...).
512 TaskbuttonIconOffset=0 # [0-16]
514 Width of taskbutton side icons.
515 TrayIconMaxWidth=32 # [16-128]
517 Maximum scaled width of tray icons.
518 TrayIconMaxHeight=24 # [16-128]
520 Maximum scaled height of tray icons.
521 TrayDrawBevel=0 # 0/1
523 Surround the tray with plastic border.
524 MENUS
526 AutoReloadMenus=1
527 Reload menu files automatically.
528 ShowProgramsMenu=0
530 Show programs submenu.
531 ShowSettingsMenu=1
533 Show settings submenu.
534 ShowFocusModeMenu=1
536 Show focus mode submenu.
537 ShowThemesMenu=1
539 Show themes submenu.
540 ShowLogoutMenu=1
542 Show logout menu.
543 ShowHelp=1
545 Show the help menu item.
546 ShowLogoutSubMenu=1
548 Show logout submenu.
549 ShowAbout=1
551 Show the about menu item.
552 ShowRun=1
554 Show the run menu item.
555 ShowWindowList=1
557 Show the window menu item.
558 MenuMaximalWidth=0 [0-16384]
560 Maximal width of popup menus, 2/3 of the screen's width if set to
561 zero.
562 NestedThemeMenuMinNumber=25 [0-1234]
564 Minimal number of themes after which the Themes menu becomes nested
565 (0=disabled).
566 TIMINGS
568 DelayFuzziness=10 (0-100)
569 Delay fuzziness, to allow merging of multiple timer timeouts into
570 one (notebook power saving).
571 ClickMotionDistance=4 [0-32]
573 Pointer motion distance before click gets interpreted as drag.
574 ClickMotionDelay=200 [0-2000]
576 Delay before click gets interpreted as drag.
577 MultiClickTime=400 [0-5000]
579 Multiple click time.
580 MenuActivateDelay=40 [0-5000]
582 Delay before activating menu items.
583 SubmenuMenuActivateDelay=300 [0-5000]
585 Delay before activating menu submenus.
586 ToolTipDelay=1000 [0-5000]
588 Delay before tooltip window is displayed.
589 ToolTipTime=0 [0-60000]
591 Time before tooltip window is hidden (0 means never.
592 AutoHideDelay=300 [0-5000]
594 Delay before task bar is hidden.
595 AutoShowDelay=500 [0-5000]
597 Delay before task bar is shown.
598 AutoRaiseDelay=400 [0-5000]
600 Delay before windows are auto raised.
601 PointerFocusDelay=200 [0-1000]
603 Delay for pointer focus switching.
604 EdgeSwitchDelay=600 [0-5000]
606 Screen edge workspace switching delay.
607 ScrollBarStartDelay=500 [0-5000]
609 Initial scroll bar autoscroll delay.
610 ScrollBarDelay=30 [0-5000]
612 Scroll bar autoscroll delay.
613 AutoScrollStartDelay=500 [0-5000]
615 Auto scroll start delay.
616 AutoScrollDelay=60 [0-5000]
618 Auto scroll delay.
619 WorkspaceStatusTime=2500 [0-2500]
621 Time before workspace status window is hidden.
622 MailCheckDelay=30 [0-86400]
624 Delay between new-mail checks. (seconds).
625 TaskBarCPUDelay=500 [10-3600000]
627 Delay between CPU Monitor samples in ms.
628 TaskBarMEMDelay=500 [10-3600000]
630 Delay between Memory Monitor samples in ms.
631 TaskBarNetDelay=500 [10-3600000]
633 Delay between Net Monitor samples in ms.
634 FocusRequestFlashTime=0 [0-86400]
636 Number of seconds the taskbar app will blink when requesting focus
637 (0 = forever).
638 FocusRequestFlashInterval=250 [0-30000]
640 Taskbar blink interval (ms) when requesting focus (0 = blinking
641 disabled).
642 BatteryPollingPeriod=10 [2-3600]
644 Delay between power status updates (seconds).
645 BUTTONS AND KEYS
647 UseRootButtons=255 [0-255]
648 Bitmask of root window button click to use in window manager.
649 ButtonRaiseMask=1 [0-255]
651 Bitmask of buttons that raise the window when pressed.
652 DesktopWinMenuButton=0 [0-20]
654 Desktop mouse-button click to show the window list menu.
655 DesktopWinListButton=2 # [0-20]
657 Desktop mouse-button click to show the window list
658 DesktopMenuButton=3 [0-20]
660 Desktop mouse-button click to show the root menu.
661 TitleBarMaximizeButton=1 [0-5]
663 TitleBar mouse-button double click to maximize the window.
664 TitleBarRollupButton=2 [0-5]
666 TitleBar mouse-button double click to rollup the window.
667 WORKSPACES
669 WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
670 Create four workspaces with names 1 , 2 , 3 and 4 .
671 PATHS
673 IconPath="/usr/share/icons/hicolor:/usr/share/icons:/usr/share/pixmaps"
674 Icon search path (colon separated).
675 MailBoxPath=""
677 Mailbox path (use \$MAIL instead).
678 PROGRAMS
680 MailCommand="xterm -name mutt -e mutt"
681 Command to run on mailbox.
682 MailClassHint="mutt.XTerm"
684 WM_CLASS to allow runonce for MailCommand.
685 NewMailCommand=""
687 Command to run when new mail arrives.
688 LockCommand=""
690 Command to lock display/screensaver.
691 ClockCommand="xclock -name icewm -title Clock"
693 Command to run on clock.
694 ClockClassHint="icewm.XClock"
696 WM_CLASS to allow runonce for ClockCommand.
697 RunCommand=""
699 Command to select and run a program.
700 OpenCommand=""
702 Open command.
703 TerminalCommand="xterm"
705 Terminal emulator must accept -e option.
706 LogoutCommand=""
708 Command to start logout.
709 LogoutCancelCommand=""
711 Command to cancel logout.
712 ShutdownCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
714 poweroff; } ||:""
715 Command to shutdown the system.
716 RebootCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
718 reboot; } ||:""
719 Command to reboot the system.
720 SuspendCommand="test -e /run/systemd/system && systemctl suspend"
722 Command to send the system to standby mode
723 CPUStatusCommand="xterm -name top -title Process\ Status -e top"
725 Command to run on CPU status.
726 CPUStatusClassHint="top.XTerm"
728 WM_CLASS to allow runonce for CPUStatusCommand.
729 CPUStatusCombine=1 0/1
731 Combine all CPUs to one.
732 NetStatusCommand="xterm -name netstat -title 'Network Status' -e
734 netstat -c"
735 Command to run on Net status.
736 NetStatusClassHint="netstat.XTerm"
738 WM_CLASS to allow runonce for NetStatusCommand.
739 AddressBarCommand=""
741 Command to run for address bar entries.
742 WINDOW MENUS
744 WinMenuItems="rmsnxfhualyticw"
745 Items supported in menu window (rmsnxfhualytickw)
746 RolloverButtonsSupported=0
748 Does it support the 'O' title bar button images (for mouse
749 rollover).
750 ShowMenuButtonIcon=1 # 0/1
752 Show application icon over menu button
753 THEME SETTINGS
755 This section shows settings that can be set in theme files. They can
756 also be set in the preferences file, but themes will override the
757 values set there. To override the theme values, the settings should be
758 set in prefoverrides file: see icewm-prefoverrides(5). Default values
759 are shown following the equal sign.
760 Description
762 ThemeAuthor=""
764 Theme author, e-mail address, credits.
765 ThemeDescription=""
767 Description of the theme, credits.
768 Look="nice"
770 Choose a theme look from one of: "win95", "motif", "warp3",
771 "warp4", "nice", "pixmap", "metal", "gtk", "flat".
772 Gradients=""
774 List of gradient pixmaps in the current theme.
775 Borders, Icons, Margins and Buttons
777 BorderSizeX=6 [0-128]
779 Horizontal window border.
780 BorderSizeY=6 [0-128]
782 Vertical window border.
783 DlgBorderSizeX=2 [0-128]
785 Horizontal dialog window border.
786 DlgBorderSizeY=2 [0-128]
788 Vertical dialog window border.
789 CornerSizeX=24 [0-64]
791 Resize corner width.
792 CornerSizeY=24 [0-64]
794 Resize corner height.
795 TitleBarHeight=20 [0-128]
797 Title bar height.
798 TitleBarJustify=0 [0-100]
800 Justification of the window title.
801 TitleBarHorzOffset=0 [-128-128]
803 Horizontal offset for the window title text.
804 TitleBarVertOffset=0 [-128-128]
806 Vertical offset for the window title text.
807 ScrollBarX=16 [0-64]
809 Scrollbar width.
810 ScrollBarY=16 [0-64]
812 Scrollbar (button) height.
813 MenuIconSize=16 [8-128]
815 Menu icon size.
816 SmallIconSize=16 [8-128]
818 Dimension of the small icons.
819 LargeIconSize=32 [8-128]
821 Dimension of the large icons.
822 HugeIconSize=48 [8-128]
824 Dimension of the large icons.
825 QuickSwitchHorzMargin=3 [0-64]
827 Horizontal margin of the quickswitch window.
828 QuickSwitchVertMargin=3 [0-64]
830 Vertical margin of the quickswitch window.
831 QuickSwitchIconMargin=4 [0-64]
833 Vertical margin in the quickswitch window.
834 QuickSwitchIconBorder=2 [0-64]
836 Distance between the active icon and it's border.
837 QuickSwitchSeparatorSize=6 [0-64]
839 Height of the separator between (all reachable) icons and text, 0
840 to avoid it.
841 TitleButtonsLeft="s"
843 Titlebar buttons from left to right (x=close, m=max, i=min, h=hide,
844 r=rollup, s=sysmenu, d=depth).
845 TitleButtonsRight="xmir"
847 Titlebar buttons from right to left (x=close, m=max, i=min, h=hide,
848 r=rollup, s=sysmenu, d=depth).
849 TitleButtonsSupported="xmis"
851 Titlebar buttons supported by theme (x,m,i,r,h,s,d).
852 TitleBarCentered=0 # 0/1
854 Draw window title centered (obsoleted by TitleBarJustify).
855 TitleBarJoinLeft=0 # 0/1
857 Join title*S and title*T.
858 TitleBarJoinRight=0 # 0/1
860 Join title*T and title*B.
861 Fonts
863 TitleFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
865 TitleFontNameXft="sans-serif:size=12"
866 Name of the title bar font.
867 MenuFontName="-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"
869 MenuFontNameXft="sans-serif:size=10:bold"
870 Name of the menu font.
871 StatusFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
873 StatusFontNameXft="monospace:size=12:bold"
874 Name of the status display font.
875 QuickSwitchFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
877 QuickSwitchFontNameXft="monospace:size=12:bold"
878 Name of the font for Alt+Tab switcher window.
879 NormalButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
881 NormalButtonFontNameXft="sans-serif:size=12"
882 Name of the normal button font.
883 ActiveButtonFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
885 ActiveButtonFontNameXft="sans-serif:size=12:bold"
886 Name of the active button font.
887 NormalTaskBarFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
889 NormalTaskBarFontNameXft="sans-serif:size=12"
890 Name of the normal task bar item font.
891 ActiveTaskBarFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
893 ActiveTaskBarFontNameXft="sans-serif:size=12:bold"
894 Name of the active task bar item font.
895 ToolButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
897 ToolButtonFontNameXft="sans-serif:size=12"
898 Name of the tool button font (fallback: NormalButtonFontName).
899 NormalWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
901 NormalWorkspaceFontNameXft="sans-serif:size=12"
902 Name of the normal workspace button font (fallback:
903 NormalButtonFontName).
904 ActiveWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
906 ActiveWorkspaceFontNameXft="sans-serif:size=12"
907 Name of the active workspace button font (fallback:
908 ActiveButtonFontName).
909 MinimizedWindowFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
911 MinimizedWindowFontNameXft="sans-serif:size=12"
912 Name of the mini-window font.
913 ListBoxFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
915 ListBoxFontNameXft="sans-serif:size=12"
916 Name of the window list font.
917 ToolTipFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
919 ToolTipFontNameXft="sans-serif:size=12"
920 Name of the tool tip font.
921 ClockFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
923 ClockFontNameXft="monospace:size=12"
924 Name of the task bar clock font.
925 TempFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
927 TempFontNameXft="monospace:size=12"
928 Name of the task bar temperature font.
929 ApmFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
931 ApmFontNameXft="monospace:size=12"
932 Name of the task bar battery font.
933 InputFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
935 InputFontNameXft="monospace:size=12"
936 Name of the input field font.
937 LabelFontName="-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"
939 LabelFontNameXft="sans-serif:size=12"
940 Name of the label font.
941 Colors
943 ColorDialog = "rgb:C0/C0/C0"
945 Background of dialog windows.
946 ColorNormalBorder = "rgb:C0/C0/C0"
948 Border of inactive windows.
949 ColorActiveBorder = "rgb:C0/C0/C0"
951 Border of active windows.
952 ColorNormalButton = "rgb:C0/C0/C0"
954 Background of regular buttons.
955 ColorNormalButtonText = "rgb:00/00/00"
957 Textcolor of regular buttons.
958 ColorActiveButton = "rgb:E0/E0/E0"
960 Background of pressed buttons.
961 ColorActiveButtonText = "rgb:00/00/00"
963 Textcolor of pressed buttons.
964 ColorNormalTitleButton = "rgb:C0/C0/C0"
966 Background of titlebar buttons.
967 ColorNormalTitleButtonText = "rgb:00/00/00"
969 Textcolor of titlebar buttons.
970 ColorToolButton = ""
972 Background of toolbar buttons, ColorNormalButton is used if empty.
973 ColorToolButtonText = ""
975 Textcolor of toolbar buttons, ColorNormalButtonText is used if
976 empty.
977 ColorNormalWorkspaceButton = ""
979 Background of workspace buttons, ColorNormalButton is used if
980 empty.
981 ColorNormalWorkspaceButtonText = ""
983 Textcolor of workspace buttons, ColorNormalButtonText is used if
984 empty.
985 ColorActiveWorkspaceButton = ""
987 Background of the active workspace button, ColorActiveButton is
988 used if empty.
989 ColorActiveWorkspaceButtonText = ""
991 Textcolor of the active workspace button, ColorActiveButtonText is
992 used if empty.
993 ColorNormalTitleBar = "rgb:80/80/80"
995 Background of the titlebar of regular windows.
996 ColorNormalTitleBarText = "rgb:00/00/00"
998 Textcolor of the titlebar of regular windows.
999 ColorNormalTitleBarShadow = ""
1001 Textshadow of the titlebar of regular windows.
1002 ColorActiveTitleBar = "rgb:00/00/A0"
1004 Background of the titlebar of active windows.
1005 ColorActiveTitleBarText = "rgb:FF/FF/FF"
1007 Textcolor of the titlebar of active windows.
1008 ColorActiveTitleBarShadow = ""
1010 Textshadow of the titlebar of active windows.
1011 ColorNormalMinimizedWindow = "rgb:C0/C0/C0"
1013 Background for mini icons of regular windows.
1014 ColorNormalMinimizedWindowText = "rgb:00/00/00"
1016 Textcolor for mini icons of regular windows.
1017 ColorActiveMinimizedWindow = "rgb:E0/E0/E0"
1019 Background for mini icons of active windows.
1020 ColorActiveMinimizedWindowText = "rgb:00/00/00"
1022 Textcolor for mini icons of active windows.
1023 ColorNormalMenu = "rgb:C0/C0/C0"
1025 Background of pop-up menus.
1026 ColorNormalMenuItemText = "rgb:00/00/00"
1028 Textcolor of regular menu items.
1029 ColorActiveMenuItem = "rgb:A0/A0/A0"
1031 Background of selected menu item, leave empty to force
1032 transparency.
1033 ColorActiveMenuItemText = "rgb:00/00/00"
1035 Textcolor of selected menu items.
1036 ColorDisabledMenuItemText = "rgb:80/80/80"
1038 Textcolor of disabled menu items.
1039 ColorDisabledMenuItemShadow = ""
1041 Shadow of regular menu items.
1042 ColorMoveSizeStatus = "rgb:C0/C0/C0"
1044 Background of move/resize status window.
1045 ColorMoveSizeStatusText = "rgb:00/00/00"
1047 Textcolor of move/resize status window.
1048 ColorQuickSwitch = "rgb:C0/C0/C0"
1050 Background of the quick switch window.
1051 ColorQuickSwitchText = "rgb:00/00/00"
1053 Textcolor in the quick switch window.
1054 ColorQuickSwitchActive = ""
1056 Rectangle around the active icon in the quick switch window.
1057 ColorDefaultTaskBar = "rgb:C0/C0/C0"
1059 Background of the taskbar.
1060 ColorNormalTaskBarApp = "rgb:C0/C0/C0"
1062 Background for task buttons of regular windows.
1063 ColorNormalTaskBarAppText = "rgb:00/00/00"
1065 Textcolor for task buttons of regular windows.
1066 ColorActiveTaskBarApp = "rgb:E0/E0/E0"
1068 Background for task buttons of the active window.
1069 ColorActiveTaskBarAppText = "rgb:00/00/00"
1071 Textcolor for task buttons of the active window.
1072 ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"
1074 Background for task buttons of minimized windows.
1075 ColorMinimizedTaskBarAppText = "rgb:00/00/00"
1077 Textcolor for task buttons of minimized windows.
1078 ColorInvisibleTaskBarApp = "rgb:80/80/80"
1080 Background for task buttons of windows on other workspaces.
1081 ColorInvisibleTaskBarAppText = "rgb:00/00/00"
1083 Textcolor for task buttons of windows on other workspaces.
1084 ColorScrollBar = "rgb:A0/A0/A0"
1086 Scrollbar background (sliding area).
1087 ColorScrollBarSlider = "rgb:C0/C0/C0"
1089 Background of the slider button in scrollbars.
1090 ColorScrollBarButton = "rgb:C0/C0/C0"
1092 Background of the arrow buttons in scrollbars.
1093 ColorScrollBarArrow = "rgb:C0/C0/C0"
1095 Background of the arrow buttons in scrollbars (obsolete).
1096 ColorScrollBarButtonArrow = "rgb:00/00/00"
1098 Color of active arrows on scrollbar buttons.
1099 ColorScrollBarInactiveArrow = "rgb:80/80/80"
1101 Color of inactive arrows on scrollbar buttons.
1102 ColorListBox = "rgb:C0/C0/C0"
1104 Background of listboxes.
1105 ColorListBoxText = "rgb:00/00/00"
1107 Textcolor in listboxes.
1108 ColorListBoxSelection = "rgb:80/80/80"
1110 Background of selected listbox items.
1111 ColorListBoxSelectionText = "rgb:00/00/00"
1113 Textcolor of selected listbox items.
1114 ColorToolTip = "rgb:E0/E0/00"
1116 Background of tooltips.
1117 ColorToolTipText = "rgb:00/00/00"
1119 Textcolor of tooltips.
1120 ColorLabel = "rgb:C0/C0/C0"
1122 Background of labels, leave empty to force transparency.
1123 ColorLabelText = "rgb:00/00/00"
1125 Textcolor of labels.
1126 ColorInput = "rgb:FF/FF/FF"
1128 Background of text entry fields (e.g. the addressbar).
1129 ColorInputText = "rgb:00/00/00"
1131 Textcolor of text entry fields (e.g. the addressbar).
1132 ColorInputSelection = "rgb:80/80/80"
1134 Background of selected text in an entry field.
1135 ColorInputSelectionText = "rgb:00/00/00"
1137 Selected text in an entry field.
1138 ColorClock = "rgb:00/00/00"
1140 Background of non-LCD clock, leave empty to force transparency.
1141 ColorClockText = "rgb:00/FF/00"
1143 Background of non-LCD monitor.
1144 ColorApm = "rgb:00/00/00"
1146 Background of APM monitor, leave empty to force transparency.
1147 ColorApmText = "rgb:00/FF/00"
1149 Textcolor of APM monitor.
1150 ColorApmBattery = "rgb:FF/FF/00"
1152 Color of APM monitor in battary mode.
1153 ColorApmLine = "rgb:00/FF/00"
1155 Color of APM monitor in line mode.
1156 ColorApmGraphBg = "rgb:00/00/00"
1158 Background color for graph mode.
1159 ColorCPUStatusUser = "rgb:00/FF/00"
1161 User load on the CPU monitor.
1162 ColorCPUStatusSystem = "rgb:FF/00/00"
1164 System load on the CPU monitor.
1165 ColorCPUStatusInterrupts = "rgb:FF/FF/00"
1167 Interrupts on the CPU monitor.
1168 ColorCPUStatusIoWait = "rgb:60/00/60"
1170 IO Wait on the CPU monitor.
1171 ColorCPUStatusSoftIrq = "rgb:00/FF/FF"
1173 Soft Interrupts on the CPU monitor.
1174 ColorCPUStatusNice = "rgb:00/00/FF"
1176 Nice load on the CPU monitor.
1177 ColorCPUStatusIdle = "rgb:00/00/00"
1179 Idle (non) load on the CPU monitor, leave empty to force
1180 transparency.
1181 ColorCPUStatusSteal = "rgb:FF/8A/91"
1183 Involuntary Wait on the CPU monitor.
1184 ColorCPUStatusTemp = "rgb:60/60/C0"
1186 Temperature of the CPU.
1187 ColorMEMStatusUser = "rgb:40/40/80"
1189 User program usage in the memory monitor.
1190 ColorMEMStatusBuffers = "rgb:60/60/C0"
1192 OS buffers usage in the memory monitor.
1193 ColorMEMStatusCached = "rgb:80/80/FF"
1195 OS cached usage in the memory monitor.
1196 ColorMEMStatusFree = "rgb:00/00/00"
1198 Free memory in the memory monitor.
1199 ColorNetSend = "rgb:FF/FF/00"
1201 Outgoing load on the network monitor.
1202 ColorNetReceive = "rgb:FF/00/FF"
1204 Incoming load on the network monitor.
1205 ColorNetIdle = "rgb:00/00/00"
1207 Idle (non) load on the network monitor, leave empty to force
1208 transparency.
1209 DesktopBackgroundColor=""
1211 Desktop background color(s).
1212 DesktopTransparencyColor=""
1214 Color(s) to announce for semitransparent windows.
1215 Desktop Background
1217 The following preferences are read by icewmbg(1):
1219 DesktopBackgroundCenter=0 0/1
1221 Display desktop background centered and not tiled.
1222 DesktopBackgroundScaled=0 0/1
1224 Resize desktop background to full screen.
1225 DesktopBackgroundColor=""
1227 Desktop background color(s).
1228 DesktopBackgroundImage=""
1230 Desktop background image(s).
1231 SupportSemitransparency=1 0/1
1233 Support for semitransparent terminals like Eterm or gnome-terminal.
1234 DesktopTransparencyColor=""
1236 Color(s) to announce for semitransparent windows.
1237 DesktopTransparencyImage=""
1239 Image(s) to announce for semitransparent windows.
1240 DesktopBackgroundMultihead=0 0/1
1242 Paint the background image over all multihead monitors combined.
1243
1245 Alpha=1
1246 Splash="IceWM.jpg"
1247 LimitSize=0
1248 LimitPosition=0
1249 LimitByDockLayer=1
1250 QuickSwitchToAllWorkspaces=1
1251 QuickSwitchHugeIcon=1
1252 QuickSwitchFillSelection=1
1253 TaskBarMailboxStatusBeepOnNewMail=1
1254 TaskBarMailboxStatusCountMessages=1
1255 TaskBarShowMEMStatus=0
1256 TaskBarShowCollapseButton=1
1257 TaskBarWorkspacesLimit="8"
1258 ShowProgramsMenu=1
1259 ShowAddressBar=0
1260 ToolTipDelay=200
1261 ToolTipTime=5000
1262 AutoHideDelay=900
1263 AutoShowDelay=100
1264 EdgeResistance=3
1265 KeySysWinMenu=""
1266 KeySysWinListMenu="Shift+Ctrl+Esc"
1267 The above example shows how to tell icewm to not bind a specific key:
1269 KeySysWinMenu in this case.
1270
1272 Locations for the preferences file are as follows:
1273 $ICEWM_PRIVCFG/preferences
1275 $XDG_CONFIG_HOME/icewm/preferences
1276 $HOME/.icewm/preferences
1277 /etc/icewm/preferences
1278 /usr/share/icewm/preferences
1279 The locations are searched in the order listed; the first file found is
1281 read and the remainder ignored.
1282
1284 icewm(1), icewm-prefoverride(5).
1285
1287 Brian Bidulock <mailto:bidulock@openss7.org>.
1288
1290 IceWM is licensed under the GNU Library General Public License. See
1291 the COPYING file in the distribution.
1292icewm 1.6.1 2019-11-25 ICEWM-PREFERENCES(5)