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 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 modules
41 ClickToFocus=1
43 Focus windows by clicking in them.
44 FocusOnAppRaise=0
46 Focus windows when applications request that they be raised.
47 RequestFocusOnAppRaise=1
49 Request focus (flashing in taskbar) when application requests
50 raise.
51 RaiseOnFocus=1
53 Raise windows when focused.
54 FocusOnClickClient=1
56 Focus window when client area clicked.
57 RaiseOnClickClient=1
59 Raise window when client area clicked.
60 RaiseOnClickTitleBar=1
62 Raise window when title bar is clicked.
63 RaiseOnClickButton=1
65 Raise window when frame button is clicked.
66 RaiseOnClickFrame=1
68 Raise window when frame border is clicked.
69 LowerOnClickWhenRaised=0
71 Lower the active window when clicked again.
72 PassFirstClickToClient=1
74 Pass focusing click on client area to client.
75 FocusChangesWorkspace=0
77 Change to the workspace of newly focused windows.
78 FocusCurrentWorkspace=0
80 Move newly focused windows to current workspace.
81 FocusOnMap=1
83 Focus normal window when initially mapped.
84 FocusOnMapTransient=0
86 Focus dialog window when initially mapped.
87 FocusOnMapTransientActive=1
89 Focus dialog window when initially mapped only if parent frame
90 focused.
91 MapInactiveOnTop=1
93 Put new windows on top even if not focusing them.
94 PointerColormap=1
96 Colormap focus follows pointer.
97 DontRotateMenuPointer=1
99 Don't rotate the cursor for popup menus.
100 LimitSize=1
102 Limit size of windows to screen.
103 LimitPosition=1
105 Limit position of windows to screen.
106 LimitByDockLayer=0
108 Let the Dock layer limit the workspace (incompatible with GNOME
109 Panel).
110 ConsiderHBorder=0
112 Consider border frames when maximizing horizontally.
113 ConsiderVBorder=0
115 Consider border frames when maximizing vertically.
116 ConsiderSizeHintsMaximized=1
118 Consider XSizeHints if frame is maximized.
119 CenterMaximizedWindows=0
121 Center maximized windows which can't fit the screen (like
122 terminals).
123 HideBordersMaximized=0
125 Hide window borders if window is maximized.
126 SizeMaximized=0
128 Maximized windows can be resized.
129 ShowMoveSizeStatus=1
131 Show position status window during move/resize.
132 ShowWorkspaceStatus=1
134 Show name of current workspace while switching.
135 MinimizeToDesktop=0
137 Display mini-icons on desktop for minimized windows.
138 MiniIconsPlaceHorizontal=0
140 Place the mini-icons horizontal instead of vertical.
141 MiniIconsRightToLeft=0
143 Place new mini-icons from right to left.
144 MiniIconsBottomToTop=0
146 Place new mini-icons from bottom to top.
147 StrongPointerFocus=0
149 Always maintain focus under mouse window (makes some keyboard
150 support non-functional or unreliable.
151 OpaqueMove=1
153 Opaque window move.
154 OpaqueResize=1
156 Opaque window resize.
157 ManualPlacement=0
159 Windows initially placed manually by user.
160 SmartPlacement=1
162 Smart window placement (minimal overlap).
163 HideTitleBarWhenMaximized=0
165 Hide title bar when maximized.
166 CenterLarge=0
168 Center large windows.
169 CenterTransientsOnOwner=1
171 Center dialogs on owner window.
172 MenuMouseTracking=0
174 Menus track mouse even with no mouse buttons held.
175 AutoRaise=0
177 Raise windows when the mouse pointer enters, after a delay of
178 AutoRaiseDelay milliseconds. Note that "RaiseOnFocus=1" may
179 interfere.
180 DelayPointerFocus=1
182 Delay pointer focusing when mouse moves.
183 Win95Keys=1
185 Support win95 keyboard keys (Penguin/Meta/Win_L,R shows menu).
186 ModSuperIsCtrlAlt=1
188 Treat Super/Win modifier as Ctrl+Alt.
189 UseMouseWheel=0
191 Support mouse wheel. When pressing Ctrl+Alt rotating the mouse
192 wheel on the root window will cycle the focus over the windows.
193 ShowPopupsAbovePointer=0
195 Show popup menus above mouse pointer.
196 ReplayMenuCancelClick=0
198 Send the clicks outside menus to target window.
199 ClientWindowMouseActions=1
201 Allow mouse actions on client windows (buggy with some programs).
202 GrabRootWindow=1
204 Manage root window (EXPERIMENTAL - normally enabled!).
205 SnapMove=1
207 Snap to nearest screen edge/window when moving windows.
208 SnapDistance=8 [0-64]
210 Distance in pixels before windows snap together.
211 ArrangeWindowsOnScreenSizeChange=1
213 Automatically arrange windows when screen size changes.
214 AllowFullscreen=1
216 Allow to switch a window to fullscreen.
217 FullscreenUseAllMonitors=0
219 Span over all available screens if window goes into fullscreen.
220 MsgBoxDefaultAction=0 [0-1]
222 Preselect to Cancel (0) or the OK (1) button in message boxes.
223 NetWorkAreaBehaviour=0 [0-2]
225 NET_WORKAREA behaviour: 0 (single/multi-monitor with STRUT
226 information, like metacity), 1 (always full desktop), 2 (single
227 monitor with STRUT, multi-monitor without STRUT).
228 Quick Switch List
230 QuickSwitch=1
232 Alt+Tab window switching.
233 QuickSwitchToMinimized=1
235 Alt+Tab to minimized windows.
236 QuickSwitchToHidden=1
238 Alt+Tab to hidden windows.
239 QuickSwitchToUrgent=1
241 Prioritize Alt+Tab to urgent windows.
242 QuickSwitchToAllWorkspaces=0
244 Alt+Tab to windows on other workspaces.
245 QuickSwitchGroupWorkspaces=1
247 Alt+Tab: group windows on current workspace.
248 QuickSwitchAllIcons=1
250 Show all reachable icons when quick switching.
251 QuickSwitchTextFirst=0
253 Show the window title above (all reachable) icons.
254 QuickSwitchSmallWindow=0
256 Attempt to create a small QuickSwitch window (1/3 instead of 3/5 of
257 QuickSwitchMaxWidth=0
259 Go through all window titles and choose width of the longest one.
260 QuickSwitchVertical=1
262 Place the icons and titles vertical instead of horizontal.
263 QuickSwitchHugeIcon=0
265 Show the huge (48x48) of the window icon for the active window.
266 QuickSwitchFillSelection=0
268 Fill the rectangle highlighting the current icon.
269 Edge Workspace Switching
271 EdgeSwitch=0
273 Workspace switches by moving mouse to left/right screen edge.
274 HorizontalEdgeSwitch=0
276 Workspace switches by moving mouse to left/right screen edge.
277 VerticalEdgeSwitch=0
279 Workspace switches by moving mouse to top/bottom screen edge.
280 ContinuousEdgeSwitch=1
282 Workspace switches continuously when moving mouse to screen edge.
283 EdgeResistance=32 [0-10000]
285 Resistance in pixels when trying to move windows off the screen
286 (10000 = infinite).
287 TASK BAR
289 The following preferences affect the icewm(1) task bar:
290 ShowTaskBar=1
292 Show task bar.
293 TaskBarAtTop=0
295 Task bar at top of the screen.
296 TaskBarKeepBelow=0
298 Keep the task bar below regular windows.
299 TaskBarAutoHide=0
301 Auto hide task bar after delay.
302 TaskBarFullscreenAutoShow=1
304 Auto show task bar when fullscreen window active.
305 TaskBarShowClock=1
307 Show clock on task bar.
308 TaskBarShowAPMStatus=0
310 Show APM/ACPI/Battery/Power status monitor on task bar.
311 TaskBarShowAPMAuto=1
313 Enable TaskBarShowAPMStatus if a battery is present.
314 TaskBarShowAPMTime=1
316 Show APM status on task bar in time-format.
317 TaskBarShowAPMGraph=1
319 Show APM status in graph mode.
320 TaskBarShowMailboxStatus=1
322 Show mailbox status on task bar.
323 TaskBarMailboxStatusBeepOnNewMail=0
325 Beep when new mail arrives.
326 TaskBarMailboxStatusCountMessages=0
328 Count messages in mailbox.
329 TaskBarShowWorkspaces=1
331 Show workspace switching buttons on task bar.
332 TaskBarShowWindows=1
334 Show windows on the taskbar.
335 TaskBarShowShowDesktopButton=1
337 Show 'show desktop' button on taskbar.
338 ShowEllipsis=1
340 Show Ellipsis in taskbar items.
341 TaskBarShowTray=1
343 Show windows in the tray.
344 TaskBarEnableSystemTray=1
346 Enable the system tray in the taskbar.
347 TrayShowAllWindows=1
349 Show windows from all workspaces on tray.
350 TaskBarShowTransientWindows=1
352 Show transient (dialogs, ...) windows on task bar.
353 TaskBarShowAllWindows=0
355 Show windows from all workspaces on task bar.
356 TaskBarShowWindowIcons=1
358 Show icons of windows on the task bar.
359 TaskBarShowStartMenu=1
361 Show 'Start' menu on task bar.
362 TaskBarShowWindowListMenu=1
364 Show 'window list' menu on task bar.
365 TaskBarShowCPUStatus=1
367 Show CPU status on task bar (Linux & Solaris).
368 CPUStatusShowRamUsage=1
370 Show RAM usage in CPU status tool tip.
371 CPUStatusShowSwapUsage=1
373 Show swap usage in CPU status tool tip.
374 CPUStatusShowAcpiTemp=1
376 Show ACPI temperature in CPU status tool tip.
377 CPUStatusShowAcpiTempInGraph=0
379 Show ACPI temperature in CPU status bar.
380 CPUStatusShowCpuFreq=1
382 Show CPU frequency in CPU status tool tip.
383 TaskBarShowMEMStatus=1
385 Show memory usage status on task bar (Linux only).
386 TaskBarShowNetStatus=1
388 Show network status on task bar (Linux only).
389 TaskBarShowCollapseButton=0
391 Show a button to collapse the taskbar.
392 TaskBarDoubleHeight=0
394 Use double-height task bar.
395 TaskBarWorkspacesLeft=1
397 Place workspace pager on left, not right.
398 TaskBarWorkspacesTop=0
400 Place workspace pager on top row when using dual-height taskbar.
401 TaskBarWorkspacesLimit=""
403 Limit the number of taskbar workspaces buttons which are shown on
404 the workspaces pane of the taskbar. If the numeric value has a "p"
405 suffix then the limitation is in pixels. A "%" suffix limits by
406 percentage of desktop width. By default a "B" suffix is assumed for
407 number of buttons.
408 TaskBarUseMouseWheel=1
410 Enable mouse wheel cycling over workspaces and task buttons in
411 taskbar.
412 TaskBarClockLeds=0 # 0/1
414 Task bar clock/APM uses nice pixmap LCD display (but then it
415 doesn't display correctly in many languages anymore, e.g., for
416 Japanese and Korean it works only when a real font is used and not
417 the LCD pixmaps.
418 PagerShowPreview=1
420 Show a mini desktop preview on each workspace button.
421 PagerShowWindowIcons=1
423 Draw window icons inside large enough preview windows on pager (if
424 PagerShowPreview=1).
425 PagerShowMinimized=1
427 Draw even minimized windows as unfilled rectangles (if
428 PagerShowPreview=1).
429 PagerShowBorders=1
431 Draw border around workspace buttons (if PagerShowPreview=1).
432 PagerShowNumbers=1
434 Show number of workspace on workspace button (if
435 PagerShowPreview=1).
436 TaskBarLaunchOnSingleClick=1
438 Execute taskbar applet commands (like MailCommand, ClockCommand,
439 ...) on single click.
440 EnableAddressBar=1
442 Enable address bar functionality in taskbar.
443 ShowAddressBar=1
445 Show address bar in task bar.
446 MultiByte=1
448 Overrides automatic multiple byte detection.
449 ConfirmLogout=1
451 Confirm logout.
452 ShapesProtectClientWindow=1
454 Don't cut client windows by shapes set trough frame corner pixmap.
455 DoubleBuffer=1
457 Use double buffering when redrawing the display.
458 XRRDisable=1
460 Disable use of new XRANDR API for dual head (nvidia workaround).
461 PreferFreetypeFonts=1
463 Favour Xft fonts over core X11 fonts where possible.
464 MailBoxPath=""
466 Mailbox path (use \$MAIL instead).
467 Path to a mbox file. Remote mail boxes are accessed by specifying
469 an URL using the Common Internet Scheme Syntax (RFC 1738):
470 `scheme://[user[:password]@]server[:port][/path]`.
472 Supported schemes are "pop3", "imap" and "file". When the scheme
474 is omitted file:// is prepended silently. IMAP subfolders can be
475 accessed by using the path component. Reserved characters like
476 slash ("/"), at ("@") and colon (":") can be specified using escape
477 sequences with a hexadecimal encoding like %2f for the slash or %40
478 for the at sign. For example:
479 file:///var/spool/mail/captnmark
481 pop3://markus:%2f%40%3a@maol.ch/
482 imap://mathias@localhost/INBOX.Maillisten.icewm-user
483 NetworkStatusDevice="eth0 wlan0"
485 Network device for which to show status.
486 TimeFormat="%X"
488 Clock Time format (strftime format string).
489 TimeFormatAlt=""
491 Alternate Clock Time format (e.g., for blinking effects).
492 DateFormat="%c"
494 Clock Date format for tooltip (strftime format string).
495 XRRPrimaryScreenName=""
497 Screen/output name of the primary screen.
498 AcpiIgnoreBatteries=""
500 List of battery names (directories) in /proc/acpi/battery to
501 ignore. Useful when more slots are built-in, but only one battery
502 is used.
503 TaskBarCPUSamples=20 [2-1000]
505 Width of CPU Monitor.
506 TaskBarMEMSamples=20 [2-1000]
508 Width of Memory Monitor.
509 TaskBarNetSamples=20 [2-1000]
511 Width of Net Monitor.
512 TaskbarButtonWidthDivisor=3 [1-25]
514 Default number of tasks in taskbar.
515 TaskBarWidthPercentage=100 [0-100]
517 Task bar width as percentage of the screen width.
518 TaskBarJustify="left"
520 Taskbar justify left, right or center.
521 TaskBarApmGraphWidth=10 [1-1000]
523 Width of APM Monitor.
524 TaskBarGraphHeight=20 [16-1000]
526 Height of taskbar monitoring applets.
527 XineramaPrimaryScreen=0 [0-63]
529 Primary screen for xinerama (taskbar, ...).
530 TaskbuttonIconOffset=0 # [0-16]
532 Width of taskbutton side icons.
533 TrayIconMaxWidth=32 # [16-128]
535 Maximum scaled width of tray icons.
536 TrayIconMaxHeight=24 # [16-128]
538 Maximum scaled height of tray icons.
539 TrayDrawBevel=0 # 0/1
541 Surround the tray with plastic border.
542 MENUS
544 AutoReloadMenus=1
545 Reload menu files automatically.
546 ShowProgramsMenu=0
548 Show programs submenu.
549 ShowSettingsMenu=1
551 Show settings submenu.
552 ShowFocusModeMenu=1
554 Show focus mode submenu.
555 ShowThemesMenu=1
557 Show themes submenu.
558 ShowLogoutMenu=1
560 Show logout menu.
561 ShowHelp=1
563 Show the help menu item.
564 ShowLogoutSubMenu=1
566 Show logout submenu.
567 ShowAbout=1
569 Show the about menu item.
570 ShowRun=1
572 Show the run menu item.
573 ShowWindowList=1
575 Show the window menu item.
576 MenuMaximalWidth=0 [0-16384]
578 Maximal width of popup menus, 2/3 of the screen's width if set to
579 zero.
580 NestedThemeMenuMinNumber=25 [0-1234]
582 Minimal number of themes after which the Themes menu becomes nested
583 (0=disabled).
584 TIMINGS
586 DelayFuzziness=10 (0-100)
587 Delay fuzziness, to allow merging of multiple timer timeouts into
588 one (notebook power saving).
589 ClickMotionDistance=4 [0-32]
591 Pointer motion distance before click gets interpreted as drag.
592 ClickMotionDelay=200 [0-2000]
594 Delay before click gets interpreted as drag.
595 MultiClickTime=400 [0-5000]
597 Multiple click time.
598 MenuActivateDelay=40 [0-5000]
600 Delay before activating menu items.
601 SubmenuMenuActivateDelay=300 [0-5000]
603 Delay before activating menu submenus.
604 ToolTipDelay=1000 [0-5000]
606 Delay before tooltip window is displayed.
607 ToolTipTime=0 [0-60000]
609 Time before tooltip window is hidden (0 means never.
610 AutoHideDelay=300 [0-5000]
612 Delay before task bar is hidden.
613 AutoShowDelay=500 [0-5000]
615 Delay before task bar is shown.
616 AutoRaiseDelay=400 [0-5000]
618 Delay before windows are auto raised if "AutoRaise=1".
619 PointerFocusDelay=200 [0-1000]
621 Delay for pointer focus switching.
622 EdgeSwitchDelay=600 [0-5000]
624 Screen edge workspace switching delay.
625 ScrollBarStartDelay=500 [0-5000]
627 Initial scroll bar autoscroll delay.
628 ScrollBarDelay=30 [0-5000]
630 Scroll bar autoscroll delay.
631 AutoScrollStartDelay=500 [0-5000]
633 Auto scroll start delay.
634 AutoScrollDelay=60 [0-5000]
636 Auto scroll delay.
637 WorkspaceStatusTime=2500 [0-2500]
639 Time before workspace status window is hidden.
640 MailCheckDelay=30 [0-86400]
642 Delay between new-mail checks. (seconds).
643 TaskBarCPUDelay=500 [10-3600000]
645 Delay between CPU Monitor samples in ms.
646 TaskBarMEMDelay=500 [10-3600000]
648 Delay between Memory Monitor samples in ms.
649 TaskBarNetDelay=500 [10-3600000]
651 Delay between Net Monitor samples in ms.
652 FocusRequestFlashTime=0 [0-86400]
654 Number of seconds the taskbar app will blink when requesting focus
655 (0 = forever).
656 FocusRequestFlashInterval=250 [0-30000]
658 Taskbar blink interval (ms) when requesting focus (0 = blinking
659 disabled).
660 BatteryPollingPeriod=10 [2-3600]
662 Delay between power status updates (seconds).
663 BUTTONS AND KEYS
665 UseRootButtons=255 [0-255]
666 Bitmask of root window button click to use in window manager.
667 ButtonRaiseMask=1 [0-255]
669 Bitmask of buttons that raise the window when pressed.
670 DesktopWinMenuButton=0 [0-20]
672 Desktop mouse-button click to show the window list menu.
673 DesktopWinListButton=2 # [0-20]
675 Desktop mouse-button click to show the window list
676 DesktopMenuButton=3 [0-20]
678 Desktop mouse-button click to show the root menu.
679 TitleBarMaximizeButton=1 [0-5]
681 Title bar mouse-button double click to maximize the window to full
682 screen with the frame border visible. Press Shift to maximize only
683 in the vertical direction. Press Alt+Shift to maximize only in the
684 horizontal direction.
685 TitleBarRollupButton=2 [0-5]
687 Title bar mouse-button double click to rollup the window. Press
688 Shift to maximize in the horizontal direction.
689 WORKSPACES
691 WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
692 Create four workspaces with names 1 , 2 , 3 and 4 .
693 PATHS
695 IconPath="/usr/share/icons/hicolor:/usr/share/icons:/usr/share/pixmaps"
696 Icon search path (colon separated).
697 MailBoxPath=""
699 Mailbox path (use \$MAIL instead).
700 PROGRAMS
702 MailCommand="xterm -name mutt -e mutt"
703 Command to run on mailbox.
704 MailClassHint="mutt.XTerm"
706 WM_CLASS to allow runonce for MailCommand.
707 NewMailCommand=""
709 Command to run when new mail arrives.
710 LockCommand=""
712 Command to lock display/screensaver.
713 ClockCommand="xclock -name icewm -title Clock"
715 Command to run on clock.
716 ClockClassHint="icewm.XClock"
718 WM_CLASS to allow runonce for ClockCommand.
719 RunCommand=""
721 Command to select and run a program.
722 OpenCommand=""
724 Open command.
725 TerminalCommand="xterm"
727 Terminal emulator must accept -e option.
728 LogoutCommand=""
730 Command to start logout.
731 LogoutCancelCommand=""
733 Command to cancel logout.
734 ShutdownCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
736 poweroff; } ||:""
737 Command to shutdown the system.
738 RebootCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
740 reboot; } ||:""
741 Command to reboot the system.
742 SuspendCommand="test -e /run/systemd/system && systemctl suspend"
744 Command to send the system to standby mode
745 CPUStatusCommand="xterm -name top -title Process\ Status -e top"
747 Command to run on CPU status.
748 CPUStatusClassHint="top.XTerm"
750 WM_CLASS to allow runonce for CPUStatusCommand.
751 CPUStatusCombine=1 0/1
753 Combine all CPUs to one.
754 NetStatusCommand="xterm -name netstat -title 'Network Status' -e
756 netstat -c"
757 Command to run on Net status.
758 NetStatusClassHint="netstat.XTerm"
760 WM_CLASS to allow runonce for NetStatusCommand.
761 AddressBarCommand=""
763 Command to run for address bar entries.
764 WINDOW MENUS
766 WinMenuItems="rmsnxfhualyticw"
767 Items supported in menu window (rmsnxfhualytickw)
768 RolloverButtonsSupported=0
770 Does it support the 'O' title bar button images (for mouse
771 rollover).
772 ShowMenuButtonIcon=1 # 0/1
774 Show application icon over menu button
775 THEME SETTINGS
777 This section shows settings that can be set in theme files. They can
778 also be set in the preferences file, but themes will override the
779 values set there. To override the theme values, the settings should be
780 set in prefoverrides file: see icewm-prefoverrides(5). Default values
781 are shown following the equal sign.
782 Description
784 ThemeAuthor=""
786 Theme author, e-mail address, credits.
787 ThemeDescription=""
789 Description of the theme, credits.
790 Look="nice"
792 Choose a theme look from one of: "win95", "motif", "warp3",
793 "warp4", "nice", "pixmap", "metal", "gtk", "flat".
794 Gradients=""
796 List of gradient pixmaps in the current theme.
797 Borders, Icons, Margins and Buttons
799 BorderSizeX=6 [0-128]
801 Horizontal window border.
802 BorderSizeY=6 [0-128]
804 Vertical window border.
805 DlgBorderSizeX=2 [0-128]
807 Horizontal dialog window border.
808 DlgBorderSizeY=2 [0-128]
810 Vertical dialog window border.
811 CornerSizeX=24 [0-64]
813 Resize corner width.
814 CornerSizeY=24 [0-64]
816 Resize corner height.
817 TitleBarHeight=20 [0-128]
819 Title bar height.
820 TitleBarJustify=0 [0-100]
822 Justification of the window title.
823 TitleBarHorzOffset=0 [-128-128]
825 Horizontal offset for the window title text.
826 TitleBarVertOffset=0 [-128-128]
828 Vertical offset for the window title text.
829 ScrollBarX=16 [0-64]
831 Scrollbar width.
832 ScrollBarY=16 [0-64]
834 Scrollbar (button) height.
835 MenuIconSize=16 [8-128]
837 Menu icon size.
838 SmallIconSize=16 [8-128]
840 Dimension of the small icons.
841 LargeIconSize=32 [8-128]
843 Dimension of the large icons.
844 HugeIconSize=48 [8-128]
846 Dimension of the large icons.
847 QuickSwitchHorzMargin=3 [0-64]
849 Horizontal margin of the quickswitch window.
850 QuickSwitchVertMargin=3 [0-64]
852 Vertical margin of the quickswitch window.
853 QuickSwitchIconMargin=4 [0-64]
855 Vertical margin in the quickswitch window.
856 QuickSwitchIconBorder=2 [0-64]
858 Distance between the active icon and it's border.
859 QuickSwitchSeparatorSize=6 [0-64]
861 Height of the separator between (all reachable) icons and text, 0
862 to avoid it.
863 TitleButtonsLeft="s"
865 Titlebar buttons from left to right (x=close, m=max, i=min, h=hide,
866 r=rollup, s=sysmenu, d=depth).
867 TitleButtonsRight="xmir"
869 Titlebar buttons from right to left (x=close, m=max, i=min, h=hide,
870 r=rollup, s=sysmenu, d=depth).
871 TitleButtonsSupported="xmis"
873 Titlebar buttons supported by theme (x,m,i,r,h,s,d).
874 TitleBarCentered=0 # 0/1
876 Draw window title centered (obsoleted by TitleBarJustify).
877 TitleBarJoinLeft=0 # 0/1
879 Join title*S and title*T.
880 TitleBarJoinRight=0 # 0/1
882 Join title*T and title*B.
883 Fonts
885 TitleFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
887 TitleFontNameXft="sans-serif:size=12"
888 Name of the title bar font.
889 MenuFontName="-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"
891 MenuFontNameXft="sans-serif:size=10:bold"
892 Name of the menu font.
893 StatusFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
895 StatusFontNameXft="monospace:size=12:bold"
896 Name of the status display font.
897 QuickSwitchFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
899 QuickSwitchFontNameXft="monospace:size=12:bold"
900 Name of the font for Alt+Tab switcher window.
901 NormalButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
903 NormalButtonFontNameXft="sans-serif:size=12"
904 Name of the normal button font.
905 ActiveButtonFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
907 ActiveButtonFontNameXft="sans-serif:size=12:bold"
908 Name of the active button font.
909 NormalTaskBarFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
911 NormalTaskBarFontNameXft="sans-serif:size=12"
912 Name of the normal task bar item font.
913 ActiveTaskBarFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
915 ActiveTaskBarFontNameXft="sans-serif:size=12:bold"
916 Name of the active task bar item font.
917 ToolButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
919 ToolButtonFontNameXft="sans-serif:size=12"
920 Name of the tool button font (fallback: NormalButtonFontName).
921 NormalWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
923 NormalWorkspaceFontNameXft="sans-serif:size=12"
924 Name of the normal workspace button font (fallback:
925 NormalButtonFontName).
926 ActiveWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
928 ActiveWorkspaceFontNameXft="sans-serif:size=12"
929 Name of the active workspace button font (fallback:
930 ActiveButtonFontName).
931 MinimizedWindowFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
933 MinimizedWindowFontNameXft="sans-serif:size=12"
934 Name of the mini-window font.
935 ListBoxFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
937 ListBoxFontNameXft="sans-serif:size=12"
938 Name of the window list font.
939 ToolTipFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
941 ToolTipFontNameXft="sans-serif:size=12"
942 Name of the tool tip font.
943 ClockFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
945 ClockFontNameXft="monospace:size=12"
946 Name of the task bar clock font.
947 TempFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
949 TempFontNameXft="monospace:size=12"
950 Name of the task bar temperature font.
951 ApmFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
953 ApmFontNameXft="monospace:size=12"
954 Name of the task bar battery font.
955 InputFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
957 InputFontNameXft="monospace:size=12"
958 Name of the input field font.
959 LabelFontName="-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"
961 LabelFontNameXft="sans-serif:size=12"
962 Name of the label font.
963 Colors
965 ColorDialog = "rgb:C0/C0/C0"
967 Background of dialog windows.
968 ColorNormalBorder = "rgb:C0/C0/C0"
970 Border of inactive windows.
971 ColorActiveBorder = "rgb:C0/C0/C0"
973 Border of active windows.
974 ColorNormalButton = "rgb:C0/C0/C0"
976 Background of regular buttons.
977 ColorNormalButtonText = "rgb:00/00/00"
979 Text color of regular buttons.
980 ColorActiveButton = "rgb:E0/E0/E0"
982 Background of pressed buttons.
983 ColorActiveButtonText = "rgb:00/00/00"
985 Text color of pressed buttons.
986 ColorNormalTitleButton = "rgb:C0/C0/C0"
988 Background of titlebar buttons.
989 ColorNormalTitleButtonText = "rgb:00/00/00"
991 Text color of titlebar buttons.
992 ColorToolButton = ""
994 Background of toolbar buttons, ColorNormalButton is used if empty.
995 ColorToolButtonText = ""
997 Text color of toolbar buttons, ColorNormalButtonText is used if
998 empty.
999 ColorNormalWorkspaceButton = ""
1001 Background of workspace buttons, ColorNormalButton is used if
1002 empty.
1003 ColorNormalWorkspaceButtonText = ""
1005 Text color of workspace buttons, ColorNormalButtonText is used if
1006 empty.
1007 ColorActiveWorkspaceButton = ""
1009 Background of the active workspace button, ColorActiveButton is
1010 used if empty.
1011 ColorActiveWorkspaceButtonText = ""
1013 Text color of the active workspace button, ColorActiveButtonText is
1014 used if empty.
1015 ColorNormalTitleBar = "rgb:80/80/80"
1017 Background of the titlebar of regular windows.
1018 ColorNormalTitleBarText = "rgb:00/00/00"
1020 Text color of the titlebar of regular windows.
1021 ColorNormalTitleBarShadow = ""
1023 Text shadow of the titlebar of regular windows.
1024 ColorActiveTitleBar = "rgb:00/00/A0"
1026 Background of the titlebar of active windows.
1027 ColorActiveTitleBarText = "rgb:FF/FF/FF"
1029 Text color of the titlebar of active windows.
1030 ColorActiveTitleBarShadow = ""
1032 Text shadow of the titlebar of active windows.
1033 ColorNormalMinimizedWindow = "rgb:C0/C0/C0"
1035 Background for mini icons of regular windows.
1036 ColorNormalMinimizedWindowText = "rgb:00/00/00"
1038 Text color for mini icons of regular windows.
1039 ColorActiveMinimizedWindow = "rgb:E0/E0/E0"
1041 Background for mini icons of active windows.
1042 ColorActiveMinimizedWindowText = "rgb:00/00/00"
1044 Text color for mini icons of active windows.
1045 ColorNormalMenu = "rgb:C0/C0/C0"
1047 Background of pop-up menus.
1048 ColorNormalMenuItemText = "rgb:00/00/00"
1050 Text color of regular menu items.
1051 ColorActiveMenuItem = "rgb:A0/A0/A0"
1053 Background of selected menu item, leave empty to force
1054 transparency.
1055 ColorActiveMenuItemText = "rgb:00/00/00"
1057 Text color of selected menu items.
1058 ColorDisabledMenuItemText = "rgb:80/80/80"
1060 Text color of disabled menu items.
1061 ColorDisabledMenuItemShadow = ""
1063 Shadow of regular menu items.
1064 ColorMoveSizeStatus = "rgb:C0/C0/C0"
1066 Background of move/resize status window.
1067 ColorMoveSizeStatusText = "rgb:00/00/00"
1069 Text color of move/resize status window.
1070 ColorQuickSwitch = "rgb:C0/C0/C0"
1072 Background of the quick switch window.
1073 ColorQuickSwitchText = "rgb:00/00/00"
1075 Text color in the quick switch window.
1076 ColorQuickSwitchActive = ""
1078 Rectangle around the active icon in the quick switch window.
1079 ColorDefaultTaskBar = "rgb:C0/C0/C0"
1081 Background of the taskbar.
1082 ColorNormalTaskBarApp = "rgb:C0/C0/C0"
1084 Background for task buttons of regular windows.
1085 ColorNormalTaskBarAppText = "rgb:00/00/00"
1087 Text color for task buttons of regular windows.
1088 ColorActiveTaskBarApp = "rgb:E0/E0/E0"
1090 Background for task buttons of the active window.
1091 ColorActiveTaskBarAppText = "rgb:00/00/00"
1093 Text color for task buttons of the active window.
1094 ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"
1096 Background for task buttons of minimized windows.
1097 ColorMinimizedTaskBarAppText = "rgb:00/00/00"
1099 Text color for task buttons of minimized windows.
1100 ColorInvisibleTaskBarApp = "rgb:80/80/80"
1102 Background for task buttons of windows on other workspaces.
1103 ColorInvisibleTaskBarAppText = "rgb:00/00/00"
1105 Text color for task buttons of windows on other workspaces.
1106 ColorScrollBar = "rgb:A0/A0/A0"
1108 Scrollbar background (sliding area).
1109 ColorScrollBarSlider = "rgb:C0/C0/C0"
1111 Background of the slider button in scrollbars.
1112 ColorScrollBarButton = "rgb:C0/C0/C0"
1114 Background of the arrow buttons in scrollbars.
1115 ColorScrollBarArrow = "rgb:C0/C0/C0"
1117 Background of the arrow buttons in scrollbars (obsolete).
1118 ColorScrollBarButtonArrow = "rgb:00/00/00"
1120 Color of active arrows on scrollbar buttons.
1121 ColorScrollBarInactiveArrow = "rgb:80/80/80"
1123 Color of inactive arrows on scrollbar buttons.
1124 ColorListBox = "rgb:C0/C0/C0"
1126 Background of listboxes.
1127 ColorListBoxText = "rgb:00/00/00"
1129 Text color in listboxes.
1130 ColorListBoxSelection = "rgb:80/80/80"
1132 Background of selected listbox items.
1133 ColorListBoxSelectionText = "rgb:00/00/00"
1135 Text color of selected listbox items.
1136 ColorToolTip = "rgb:E0/E0/00"
1138 Background of tooltips.
1139 ColorToolTipText = "rgb:00/00/00"
1141 Text color of tooltips.
1142 ColorLabel = "rgb:C0/C0/C0"
1144 Background of labels, leave empty to force transparency.
1145 ColorLabelText = "rgb:00/00/00"
1147 Text color of labels.
1148 ColorInput = "rgb:FF/FF/FF"
1150 Background of text entry fields (e.g., the addressbar).
1151 ColorInputText = "rgb:00/00/00"
1153 Text color of text entry fields (e.g., the addressbar).
1154 ColorInputSelection = "rgb:80/80/80"
1156 Background of selected text in an entry field.
1157 ColorInputSelectionText = "rgb:00/00/00"
1159 Selected text in an entry field.
1160 ColorClock = "rgb:00/00/00"
1162 Background of non-LCD clock, leave empty to force transparency.
1163 ColorClockText = "rgb:00/FF/00"
1165 Background of non-LCD monitor.
1166 ColorApm = "rgb:00/00/00"
1168 Background of APM monitor, leave empty to force transparency.
1169 ColorApmText = "rgb:00/FF/00"
1171 Text color of APM monitor.
1172 ColorApmBattery = "rgb:FF/FF/00"
1174 Color of APM monitor in battery mode.
1175 ColorApmLine = "rgb:00/FF/00"
1177 Color of APM monitor in line mode.
1178 ColorApmGraphBg = "rgb:00/00/00"
1180 Background color for graph mode.
1181 ColorCPUStatusUser = "rgb:00/FF/00"
1183 User load on the CPU monitor.
1184 ColorCPUStatusSystem = "rgb:FF/00/00"
1186 System load on the CPU monitor.
1187 ColorCPUStatusInterrupts = "rgb:FF/FF/00"
1189 Interrupts on the CPU monitor.
1190 ColorCPUStatusIoWait = "rgb:60/00/60"
1192 IO Wait on the CPU monitor.
1193 ColorCPUStatusSoftIrq = "rgb:00/FF/FF"
1195 Soft Interrupts on the CPU monitor.
1196 ColorCPUStatusNice = "rgb:00/00/FF"
1198 Nice load on the CPU monitor.
1199 ColorCPUStatusIdle = "rgb:00/00/00"
1201 Idle (non) load on the CPU monitor, leave empty to force
1202 transparency.
1203 ColorCPUStatusSteal = "rgb:FF/8A/91"
1205 Involuntary Wait on the CPU monitor.
1206 ColorCPUStatusTemp = "rgb:60/60/C0"
1208 Temperature of the CPU.
1209 ColorMEMStatusUser = "rgb:40/40/80"
1211 User program usage in the memory monitor.
1212 ColorMEMStatusBuffers = "rgb:60/60/C0"
1214 OS buffers usage in the memory monitor.
1215 ColorMEMStatusCached = "rgb:80/80/FF"
1217 OS cached usage in the memory monitor.
1218 ColorMEMStatusFree = "rgb:00/00/00"
1220 Free memory in the memory monitor.
1221 ColorNetSend = "rgb:FF/FF/00"
1223 Outgoing load on the network monitor.
1224 ColorNetReceive = "rgb:FF/00/FF"
1226 Incoming load on the network monitor.
1227 ColorNetIdle = "rgb:00/00/00"
1229 Idle (non) load on the network monitor, leave empty to force
1230 transparency.
1231 DesktopBackgroundColor=""
1233 Desktop background color(s).
1234 DesktopTransparencyColor=""
1236 Color(s) to announce for semitransparent windows.
1237 Desktop Background
1239 The following preferences are read by icewmbg(1):
1241 DesktopBackgroundCenter=0 0/1
1243 Display desktop background centered and not tiled.
1244 DesktopBackgroundScaled=0 0/1
1246 Resize desktop background to full screen.
1247 DesktopBackgroundColor=""
1249 Desktop background color(s).
1250 DesktopBackgroundImage=""
1252 Desktop background image(s).
1253 SupportSemitransparency=1 0/1
1255 Support for semitransparent terminals like Eterm or gnome-terminal.
1256 DesktopTransparencyColor=""
1258 Color(s) to announce for semitransparent windows.
1259 DesktopTransparencyImage=""
1261 Image(s) to announce for semitransparent windows.
1262 DesktopBackgroundMultihead=0 0/1
1264 Paint the background image over all multihead monitors combined.
1265
1267 Alpha=1
1268 Splash="IceWM.jpg"
1269 LimitSize=0
1270 LimitPosition=0
1271 LimitByDockLayer=1
1272 QuickSwitchToAllWorkspaces=1
1273 QuickSwitchHugeIcon=1
1274 QuickSwitchFillSelection=1
1275 TaskBarMailboxStatusBeepOnNewMail=1
1276 TaskBarMailboxStatusCountMessages=1
1277 TaskBarShowMEMStatus=0
1278 TaskBarShowCollapseButton=1
1279 TaskBarWorkspacesLimit="8"
1280 ShowProgramsMenu=1
1281 ShowAddressBar=0
1282 ToolTipDelay=200
1283 ToolTipTime=5000
1284 AutoHideDelay=900
1285 AutoShowDelay=100
1286 EdgeResistance=3
1287 KeySysWinMenu=""
1288 KeySysWinListMenu="Shift+Ctrl+Esc"
1289 The above example shows how to tell icewm to not bind a specific key:
1291 KeySysWinMenu in this case.
1292
1294 Locations for the preferences file are as follows:
1295 $ICEWM_PRIVCFG/preferences
1297 $XDG_CONFIG_HOME/icewm/preferences
1298 $HOME/.icewm/preferences
1299 /etc/icewm/preferences
1300 /usr/share/icewm/preferences
1301 The locations are searched in the order listed; the first file found is
1303 read and the remainder ignored.
1304
1306 icewm(1), icewm-prefoverride(5).
1307
1309 Brian Bidulock <mailto:bidulock@openss7.org>.
1310
1312 IceWM is licensed under the GNU Library General Public License. See
1313 the COPYING file in the distribution.
1314icewm 1.6.5 2020-03-17 ICEWM-PREFERENCES(5)