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 list of modules. Modules which are
41 traceable include conf, 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 win95 keyboard keys (Penguin/Meta/Win_L,R shows menu).
188 ModSuperIsCtrlAlt=1
190 Treat Super/Win modifier as Ctrl+Alt.
191 UseMouseWheel=0
193 Support mouse wheel. When pressing Ctrl+Alt rotating the mouse
194 wheel on the root window will cycle the focus over the windows.
195 TaskBarTaskGrouping=0
197 Group applications with the same class name under a single task
198 button.
199 ShowPopupsAbovePointer=0
201 Show popup menus above mouse pointer.
202 ReplayMenuCancelClick=0
204 Send the clicks outside menus to target window.
205 ClientWindowMouseActions=1
207 Allow mouse actions on client windows (buggy with some programs).
208 GrabRootWindow=1
210 Manage root window (EXPERIMENTAL - normally enabled!).
211 SnapMove=1
213 Snap to nearest screen edge/window when moving windows.
214 SnapDistance=8 [0-64]
216 Distance in pixels before windows snap together.
217 ArrangeWindowsOnScreenSizeChange=1
219 Automatically arrange windows when screen size changes.
220 AllowFullscreen=1
222 Allow to switch a window to fullscreen.
223 FullscreenUseAllMonitors=0
225 Span over all available screens if window goes into fullscreen.
226 MsgBoxDefaultAction=0 [0-1]
228 Preselect to Cancel (0) or the OK (1) button in message boxes.
229 NetWorkAreaBehaviour=0 [0-2]
231 NET_WORKAREA behaviour: 0 (single/multi-monitor with STRUT
232 information, like metacity), 1 (always full desktop), 2 (single
233 monitor with STRUT, multi-monitor without STRUT).
234 QUICK SWITCH
236 QuickSwitch=1
237 Enable Alt+Tab window switching.
238 QuickSwitchToMinimized=1
240 Enable Alt+Tab to minimized windows.
241 QuickSwitchToHidden=1
243 Enable Alt+Tab to hidden windows.
244 QuickSwitchToUrgent=1
246 Prioritize Alt+Tab to urgent windows.
247 QuickSwitchToAllWorkspaces=0
249 Include windows from all workspaces in Alt+Tab.
250 QuickSwitchGroupWorkspaces=1
252 Group windows by workspace together in Alt+Tab.
253 QuickSwitchRaiseCandidate=0
255 Raise a selected window while Alt+Tabbing in the QuickSwitch.
256 QuickSwitchAllIcons=1
258 Show all reachable icons when quick switching.
259 QuickSwitchTextFirst=0
261 Show the window title above (all reachable) icons.
262 QuickSwitchSmallWindow=0
264 Create a smaller QuickSwitch window of 1/3 screen width.
265 QuickSwitchMaxWidth=0
267 Go trough all window titles and choose width of the longest one.
268 QuickSwitchVertical=1
270 Place the icons and titles vertical instead of horizontal.
271 QuickSwitchHugeIcon=0
273 Show the huge (48x48) of the window icon for the active window.
274 QuickSwitchFillSelection=0
276 Fill the rectangle highlighting the current icon.
277 EDGE SWITCHING
279 EdgeSwitch=0
280 Workspace switches by moving mouse to left/right screen edge.
281 HorizontalEdgeSwitch=0
283 Workspace switches by moving mouse to left/right screen edge.
284 VerticalEdgeSwitch=0
286 Workspace switches by moving mouse to top/bottom screen edge.
287 ContinuousEdgeSwitch=1
289 Workspace switches continuously when moving mouse to screen edge.
290 EdgeResistance=32 [0-10000]
292 Resistance in pixels when trying to move windows off the screen
293 (10000 = infinite).
294 TASK BAR
296 The following preferences affect the icewm(1) task bar:
297 ShowTaskBar=1
299 Show task bar.
300 TaskBarAtTop=0
302 Task bar at top of the screen.
303 TaskBarKeepBelow=0
305 Keep the task bar below regular windows.
306 TaskBarAutoHide=0
308 Auto hide task bar after delay.
309 TaskBarFullscreenAutoShow=1
311 Auto show task bar when fullscreen window active.
312 TaskBarShowClock=1
314 Show clock on task bar.
315 TaskBarShowAPMStatus=0
317 Show battery status monitor on task bar.
318 TaskBarShowAPMAuto=1
320 Enable TaskBarShowAPMStatus if a battery is present.
321 TaskBarShowAPMTime=1
323 Show battery status on task bar in time-format
324 TaskBarShowAPMGraph=1
326 Show battery status in graph mode.
327 TaskBarShowMailboxStatus=1
329 Show mailbox status on task bar.
330 TaskBarMailboxStatusBeepOnNewMail=0
332 Beep when new mail arrives.
333 TaskBarMailboxStatusCountMessages=0
335 Count messages in mailbox.
336 TaskBarShowWorkspaces=1
338 Show workspace switching buttons on task bar.
339 TaskBarShowWindows=1
341 Show windows on the taskbar.
342 TaskBarShowShowDesktopButton=1
344 Show 'show desktop' button on taskbar. If set to 2, it will move
345 the icon to the right side, after the clock.
346 ShowEllipsis=1
348 Show Ellipsis in taskbar items.
349 TaskBarShowTray=1
351 Show windows in the tray.
352 TaskBarEnableSystemTray=1
354 Enable the system tray in the taskbar.
355 TrayShowAllWindows=1
357 Show windows from all workspaces on tray.
358 TaskBarShowTransientWindows=1
360 Show transient (dialogs, ...) windows on task bar.
361 TaskBarShowAllWindows=0
363 Show windows from all workspaces on task bar.
364 TaskBarShowWindowIcons=1
366 Show icons of windows on the task bar.
367 TaskBarShowStartMenu=1
369 Show 'Start' menu on task bar.
370 TaskBarShowWindowListMenu=1
372 Show 'window list' menu on task bar.
373 TaskBarShowCPUStatus=1
375 Show CPU status on task bar (Linux & Solaris).
376 CPUStatusShowRamUsage=1
378 Show RAM usage in CPU status tool tip.
379 CPUStatusShowSwapUsage=1
381 Show swap usage in CPU status tool tip.
382 CPUStatusShowAcpiTemp=1
384 Show ACPI temperature in CPU status tool tip.
385 CPUStatusShowAcpiTempInGraph=0
387 Show ACPI temperature in CPU status bar.
388 CPUStatusShowCpuFreq=1
390 Show CPU frequency in CPU status tool tip.
391 NetStatusShowOnlyRunning=0
393 Show network status only for connected devices, such as an active
394 ethernet link or associated wireless interface. If false, any
395 network interface that has been brought up will be displayed.
396 TaskBarShowMEMStatus=1
398 Show memory usage status on task bar (Linux only).
399 TaskBarShowNetStatus=1
401 Show network status on task bar (Linux only).
402 TaskBarShowCollapseButton=0
404 Show a button to collapse the taskbar.
405 TaskBarDoubleHeight=0
407 Use double-height task bar.
408 TaskBarWorkspacesLeft=1
410 Place workspace pager on left, not right.
411 TaskBarWorkspacesTop=0
413 Place workspace pager on top row when using dual-height taskbar.
414 TaskBarWorkspacesLimit=""
416 Limit the number of taskbar workspaces buttons which are shown on
417 the workspaces pane of the taskbar. If the numeric value has a "p"
418 suffix then the limitation is in pixels. A "%" suffix limits by
419 percentage of desktop width. By default a "B" suffix is assumed for
420 number of buttons.
421 TaskBarUseMouseWheel=1
423 Enable mouse wheel cycling over workspaces and task buttons in
424 taskbar.
425 TaskBarClockLeds=0 # 0/1
427 Task bar clock/battery monitor uses nice pixmap LCD display (but
428 then it doesn't display correctly in many languages anymore, e.g.,
429 for Japanese and Korean it works only when a real font is used and
430 not the LCD pixmaps.
431 PagerShowPreview=1
433 Show a mini desktop preview on each workspace button.
434 PagerShowWindowIcons=1
436 Draw window icons inside large enough preview windows on pager (if
437 PagerShowPreview=1).
438 PagerShowMinimized=1
440 Draw even minimized windows as unfilled rectangles (if
441 PagerShowPreview=1).
442 PagerShowBorders=1
444 Draw border around workspace buttons (if PagerShowPreview=1).
445 PagerShowLabels=1
447 Show workspace name label on workspace button (if
448 PagerShowPreview=1)
449 PagerShowNumbers=1
451 Show number of workspace on workspace button (if
452 PagerShowPreview=1).
453 TaskBarLaunchOnSingleClick=1
455 Execute taskbar applet commands (like MailCommand, ClockCommand,
456 ...) on single click.
457 EnableAddressBar=1
459 Enable address bar functionality in taskbar.
460 ShowAddressBar=1
462 Show address bar in task bar.
463 MultiByte=1
465 Overrides automatic multiple byte detection.
466 ConfirmLogout=1
468 Confirm logout.
469 ShapesProtectClientWindow=1
471 Don't cut client windows by shapes set trough frame corner pixmap.
472 DoubleBuffer=1
474 Use double buffering when redrawing the display.
475 XRRDisable=1
477 Disable use of new XRANDR API for dual head (nvidia workaround).
478 PreferFreetypeFonts=1
480 Favour Xft fonts over core X11 fonts where possible.
481 MailBoxPath=""
483 Mailbox path (use \$MAIL instead).
484 Path to a mbox file. Remote mail boxes are accessed by specifying
486 an URL using the Common Internet Scheme Syntax (RFC 1738):
487 `scheme://[user[:password]@]server[:port][/path]`.
489 Supported schemes are "pop3", "imap" and "file". When the scheme
491 is omitted file:// is prepended silently. IMAP subfolders can be
492 accessed by using the path component. Reserved characters like
493 slash ("/"), at ("@") and colon (":") can be specified using escape
494 sequences with a hexadecimal encoding like %2f for the slash or %40
495 for the at sign. For example:
496 file:///var/spool/mail/captnmark
498 pop3://markus:%2f%40%3a@maol.ch/
499 imap://mathias@localhost/INBOX.Maillisten.icewm-user
500 NetworkStatusDevice="eth0 wlan0"
502 Network device for which to show status.
503 TimeFormat="%X"
505 Clock Time format (strftime format string).
506 TimeFormatAlt=""
508 Alternate Clock Time format (e.g., for blinking effects).
509 DateFormat="%c"
511 Clock Date format for tooltip (strftime format string).
512 XRRPrimaryScreenName=""
514 Screen/output name of the primary screen.
515 AcpiIgnoreBatteries=""
517 List of battery names (directories) in /proc/acpi/battery to
518 ignore. Useful when more slots are built-in, but only one battery
519 is used.
520 TaskBarCPUSamples=20 [2-1000]
522 The width of the CPU Monitor applet in pixels.
523 TaskBarMEMSamples=20 [2-1000]
525 The width of the Memory Monitor applet in pixels.
526 TaskBarNetSamples=20 [2-1000]
528 The width of the Net Monitor applet in pixels.
529 TaskbarButtonWidthDivisor=3 [1-25]
531 Default number of tasks in taskbar.
532 TaskBarWidthPercentage=100 [0-100]
534 Task bar width as percentage of the screen width.
535 TaskBarJustify="left"
537 Taskbar justify left, right or center.
538 TaskBarApmGraphWidth=10 [1-1000]
540 Width of battery Monitor.
541 TaskBarGraphHeight=20 [16-1000]
543 Height of taskbar monitoring applets.
544 XineramaPrimaryScreen=0 [0-63]
546 Primary screen for xinerama (taskbar, ...).
547 TaskbuttonIconOffset=0 # [0-16]
549 Width of taskbutton side icons.
550 TrayIconMaxWidth=32 # [16-128]
552 Maximum scaled width of tray icons.
553 TrayIconMaxHeight=24 # [16-128]
555 Maximum scaled height of tray icons.
556 TrayDrawBevel=0 # 0/1
558 Surround the tray with plastic border.
559 KeyboardLayouts=""
561 A comma-separated list of keyboard layouts. A layout may be
562 enclosed in double quotes. Each layout is a name with optional
563 arguments, which is to be parsed by the "setxkbmap" program. To
564 support changing keyboard layouts, the "setxkbmap" program must be
565 installed. The first in the list is the default layout. Programs
566 may have their own keyboard layout defined in the winoptions file.
567 The first two letters of a layout are used to locate an icon image
568 file.
569 MENUS
571 AutoReloadMenus=1
572 Reload menu files automatically.
573 ShowProgramsMenu=0
575 Show programs submenu.
576 ShowSettingsMenu=1
578 Show settings submenu.
579 ShowFocusModeMenu=1
581 Show focus mode submenu.
582 ShowThemesMenu=1
584 Show themes submenu.
585 ShowLogoutMenu=1
587 Show logout menu.
588 ShowHelp=1
590 Show the help menu item.
591 ShowLogoutSubMenu=1
593 Show logout submenu.
594 ShowAbout=1
596 Show the about menu item.
597 ShowRun=1
599 Show the run menu item.
600 ShowWindowList=1
602 Show the window menu item.
603 MenuMaximalWidth=0 [0-16384]
605 Maximal width of popup menus, 2/3 of the screen's width if set to
606 zero.
607 NestedThemeMenuMinNumber=25 [0-1234]
609 Minimal number of themes after which the Themes menu becomes nested
610 (0=disabled).
611 TIMINGS
613 DelayFuzziness=10 (0-100)
614 Delay fuzziness, to allow merging of multiple timer timeouts into
615 one (notebook power saving).
616 ClickMotionDistance=4 [0-32]
618 Pointer motion distance before click gets interpreted as drag.
619 ClickMotionDelay=200 [0-2000]
621 Delay before click gets interpreted as drag.
622 MultiClickTime=400 [0-5000]
624 Multiple click time.
625 MenuActivateDelay=40 [0-5000]
627 Delay before activating menu items.
628 SubmenuMenuActivateDelay=300 [0-5000]
630 Delay before activating menu submenus.
631 ToolTipDelay=1000 [0-5000]
633 Delay before tooltip window is displayed.
634 ToolTipTime=0 [0-60000]
636 Time before tooltip window is hidden (0 means never.
637 AutoHideDelay=300 [0-5000]
639 Delay before task bar is hidden.
640 AutoShowDelay=500 [0-5000]
642 Delay before task bar is shown.
643 AutoRaiseDelay=400 [0-5000]
645 Delay before windows are auto raised if "AutoRaise=1".
646 PointerFocusDelay=200 [0-1000]
648 Delay for pointer focus switching.
649 EdgeSwitchDelay=600 [0-5000]
651 Screen edge workspace switching delay.
652 ScrollBarStartDelay=500 [0-5000]
654 Initial scroll bar autoscroll delay.
655 ScrollBarDelay=30 [0-5000]
657 Scroll bar autoscroll delay.
658 AutoScrollStartDelay=500 [0-5000]
660 Auto scroll start delay.
661 AutoScrollDelay=60 [0-5000]
663 Auto scroll delay.
664 WorkspaceStatusTime=2500 [0-2500]
666 Time before workspace status window is hidden.
667 MailCheckDelay=30 [0-86400]
669 Delay between new-mail checks. (seconds).
670 TaskBarCPUDelay=500 [10-3600000]
672 Delay between CPU Monitor samples in ms.
673 TaskBarMEMDelay=500 [10-3600000]
675 Delay between Memory Monitor samples in ms.
676 TaskBarNetDelay=500 [10-3600000]
678 Delay between Net Monitor samples in ms.
679 FocusRequestFlashTime=0 [0-86400]
681 Number of seconds the taskbar app will blink when requesting focus
682 (0 = forever).
683 FocusRequestFlashInterval=250 [0-30000]
685 Taskbar blink interval (ms) when requesting focus (0 = blinking
686 disabled).
687 BatteryPollingPeriod=10 [2-3600]
689 Delay between power status updates (seconds).
690 BUTTONS AND KEYS
692 UseRootButtons=255 [0-255]
693 Bitmask of root window button click to use in window manager.
694 ButtonRaiseMask=1 [0-255]
696 Bitmask of buttons that raise the window when pressed.
697 DesktopWinMenuButton=0 [0-20]
699 Desktop mouse-button click to show the window list menu.
700 DesktopWinListButton=2 # [0-20]
702 Desktop mouse-button click to show the window list
703 DesktopMenuButton=3 [0-20]
705 Desktop mouse-button click to show the root menu.
706 TitleBarMaximizeButton=1 [0-5]
708 Title bar mouse-button double click to maximize the window to full
709 screen with the frame border visible. Press Shift to maximize only
710 in the vertical direction. Press Alt+Shift to maximize only in the
711 horizontal direction.
712 TitleBarRollupButton=2 [0-5]
714 Title bar mouse-button double click to rollup the window. Press
715 Shift to maximize in the horizontal direction.
716 WORKSPACES
718 WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
719 Create four workspaces with names 1 , 2 , 3 and 4 .
720 PATHS
722 IconPath="/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps"
723 Icon search path (colon separated). Also, the icons/ subdirectory
724 in IceWM resource folders are searched first.
725 IconThemes="*:-HighContrast"
727 List of icon themes (colon separated), acting as additional filter
728 of icon subdirectories in any of the IconPath folders. Expressions
729 can be wildcards, also special wildcards (starting with -) can
730 exclude matched themes from selection.
731 MailBoxPath=""
733 Mailbox path (use \$MAIL instead).
734 PROGRAMS
736 MailCommand="xterm -name mutt -e mutt"
737 Command to run on mailbox.
738 MailClassHint="mutt.XTerm"
740 WM_CLASS to allow runonce for MailCommand.
741 NewMailCommand=""
743 Command to run when new mail arrives.
744 LockCommand=""
746 Command to lock display/screensaver.
747 ClockCommand="xclock -name icewm -title Clock"
749 Command to run on clock.
750 ClockClassHint="icewm.XClock"
752 WM_CLASS to allow runonce for ClockCommand.
753 RunCommand=""
755 Command to select and run a program.
756 OpenCommand=""
758 Open command.
759 TerminalCommand="xterm"
761 Terminal emulator must accept -e option.
762 LogoutCommand=""
764 Command to start logout.
765 LogoutCancelCommand=""
767 Command to cancel logout.
768 ShutdownCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
770 poweroff; } ||:""
771 Command to shutdown the system.
772 RebootCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
774 reboot; } ||:""
775 Command to reboot the system.
776 SuspendCommand="test -e /run/systemd/system && systemctl suspend"
778 Command to send the system to standby mode
779 CPUStatusCommand="xterm -name top -title Process\ Status -e top"
781 Command to run on CPU status.
782 CPUStatusClassHint="top.XTerm"
784 WM_CLASS to allow runonce for CPUStatusCommand.
785 CPUStatusCombine=1 0/1
787 Combine all CPUs to one.
788 NetStatusCommand="xterm -name netstat -title 'Network Status' -e
790 netstat -c"
791 Command to run on Net status.
792 NetStatusClassHint="netstat.XTerm"
794 WM_CLASS to allow runonce for NetStatusCommand.
795 AddressBarCommand=""
797 Command to run for address bar entries.
798 WINDOW MENUS
800 WinMenuItems="rmsnxfhualyticw"
801 Items supported in menu window (rmsnxfhualytickw)
802 RolloverButtonsSupported=0
804 Does it support the 'O' title bar button images (for mouse
805 rollover).
806 ShowMenuButtonIcon=1 # 0/1
808 Show application icon over menu button
809 THEME SETTINGS
811 The following sections show settings that can be set in theme files.
812 They can also be set in the preferences file, but themes will override
813 the values set there. To override the theme values, the settings
814 should be set in prefoverrides file: see icewm-prefoverrides(5).
815 Default values are shown following the equal sign.
816 THEME DESCRIPTION
818 ThemeAuthor=""
820 Theme author, e-mail address, credits.
821 ThemeDescription=""
823 Description of the theme, credits.
824 Look="nice"
826 Choose a theme look from one of: "win95", "motif", "warp3",
827 "warp4", "nice", "metal2", "gtk2", and some others.
828 Gradients=""
830 List of gradient pixmaps in the current theme.
831 THEME BORDERS, ICONS, MARGINS AND BUTTONS
833 BorderSizeX=6 [0-128]
835 Horizontal window border.
836 BorderSizeY=6 [0-128]
838 Vertical window border.
839 DlgBorderSizeX=2 [0-128]
841 Horizontal dialog window border.
842 DlgBorderSizeY=2 [0-128]
844 Vertical dialog window border.
845 CornerSizeX=24 [0-64]
847 Resize corner width.
848 CornerSizeY=24 [0-64]
850 Resize corner height.
851 TitleBarHeight=20 [0-128]
853 Title bar height.
854 TitleBarJustify=0 [0-100]
856 Justification of the window title.
857 TitleBarHorzOffset=0 [-128-128]
859 Horizontal offset for the window title text.
860 TitleBarVertOffset=0 [-128-128]
862 Vertical offset for the window title text.
863 MenuButtonIconVertOffset=0 [-128-128]
865 Vertical offset for the menu button icon.
866 ScrollBarX=16 [0-64]
868 Scrollbar width.
869 ScrollBarY=16 [0-64]
871 Scrollbar (button) height.
872 MenuIconSize=16 [8-128]
874 Menu icon size.
875 SmallIconSize=16 [8-128]
877 Dimension of the small icons.
878 LargeIconSize=32 [8-128]
880 Dimension of the large icons.
881 HugeIconSize=48 [8-128]
883 Dimension of the large icons.
884 QuickSwitchHorzMargin=3 [0-64]
886 Horizontal margin of the quickswitch window.
887 QuickSwitchVertMargin=3 [0-64]
889 Vertical margin of the quickswitch window.
890 QuickSwitchIconMargin=4 [0-64]
892 Vertical margin in the quickswitch window.
893 QuickSwitchIconBorder=2 [0-64]
895 Distance between the active icon and it's border.
896 QuickSwitchSeparatorSize=6 [0-64]
898 Height of the separator between (all reachable) icons and text, 0
899 to avoid it.
900 TitleButtonsLeft="s"
902 Titlebar buttons from left to right (x=close, m=max, i=min, h=hide,
903 r=rollup, s=sysmenu, d=depth).
904 TitleButtonsRight="xmir"
906 Titlebar buttons from right to left (x=close, m=max, i=min, h=hide,
907 r=rollup, s=sysmenu, d=depth).
908 TitleButtonsSupported="xmis"
910 Titlebar buttons supported by theme (x,m,i,r,h,s,d).
911 TitleBarCentered=0 # 0/1
913 Draw window title centered (obsoleted by TitleBarJustify).
914 TitleBarJoinLeft=0 # 0/1
916 Join title*S and title*T.
917 TitleBarJoinRight=0 # 0/1
919 Join title*T and title*B.
920 THEME FONTS
922 TitleFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
924 TitleFontNameXft="sans-serif:size=12"
925 Name of the title bar font.
926 MenuFontName="-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"
928 MenuFontNameXft="sans-serif:size=10:bold"
929 Name of the menu font.
930 StatusFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
932 StatusFontNameXft="monospace:size=12:bold"
933 Name of the status display font.
934 QuickSwitchFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
936 QuickSwitchFontNameXft="monospace:size=12:bold"
937 Name of the font for Alt+Tab switcher window.
938 NormalButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
940 NormalButtonFontNameXft="sans-serif:size=12"
941 Name of the normal button font.
942 ActiveButtonFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
944 ActiveButtonFontNameXft="sans-serif:size=12:bold"
945 Name of the active button font.
946 NormalTaskBarFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
948 NormalTaskBarFontNameXft="sans-serif:size=12"
949 Name of the normal task bar item font.
950 ActiveTaskBarFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
952 ActiveTaskBarFontNameXft="sans-serif:size=12:bold"
953 Name of the active task bar item font.
954 ToolButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
956 ToolButtonFontNameXft="sans-serif:size=12"
957 Name of the tool button font (fallback: NormalButtonFontName).
958 NormalWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
960 NormalWorkspaceFontNameXft="sans-serif:size=12"
961 Name of the normal workspace button font (fallback:
962 NormalButtonFontName).
963 ActiveWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
965 ActiveWorkspaceFontNameXft="sans-serif:size=12"
966 Name of the active workspace button font (fallback:
967 ActiveButtonFontName).
968 MinimizedWindowFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
970 MinimizedWindowFontNameXft="sans-serif:size=12"
971 Name of the mini-window font.
972 ListBoxFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
974 ListBoxFontNameXft="sans-serif:size=12"
975 Name of the window list font.
976 ToolTipFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
978 ToolTipFontNameXft="sans-serif:size=12"
979 Name of the tool tip font.
980 ClockFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
982 ClockFontNameXft="monospace:size=12"
983 Name of the task bar clock font.
984 TempFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
986 TempFontNameXft="monospace:size=12"
987 Name of the task bar temperature font.
988 ApmFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
990 ApmFontNameXft="monospace:size=12"
991 Name of the task bar battery font.
992 InputFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
994 InputFontNameXft="monospace:size=12"
995 Name of the input field font.
996 LabelFontName="-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"
998 LabelFontNameXft="sans-serif:size=12"
999 Name of the label font.
1000 THEME COLORS
1002 ColorDialog = "rgb:C0/C0/C0"
1004 Background of dialog windows.
1005 ColorNormalBorder = "rgb:C0/C0/C0"
1007 Border of inactive windows.
1008 ColorActiveBorder = "rgb:C0/C0/C0"
1010 Border of active windows.
1011 ColorNormalButton = "rgb:C0/C0/C0"
1013 Background of regular buttons.
1014 ColorNormalButtonText = "rgb:00/00/00"
1016 Text color of regular buttons.
1017 ColorActiveButton = "rgb:E0/E0/E0"
1019 Background of pressed buttons.
1020 ColorActiveButtonText = "rgb:00/00/00"
1022 Text color of pressed buttons.
1023 ColorNormalTitleButton = "rgb:C0/C0/C0"
1025 Background of titlebar buttons.
1026 ColorNormalTitleButtonText = "rgb:00/00/00"
1028 Text color of titlebar buttons.
1029 ColorToolButton = ""
1031 Background of toolbar buttons, ColorNormalButton is used if empty.
1032 ColorToolButtonText = ""
1034 Text color of toolbar buttons, ColorNormalButtonText is used if
1035 empty.
1036 ColorNormalWorkspaceButton = ""
1038 Background of workspace buttons, ColorNormalButton is used if
1039 empty.
1040 ColorNormalWorkspaceButtonText = ""
1042 Text color of workspace buttons, ColorNormalButtonText is used if
1043 empty.
1044 ColorActiveWorkspaceButton = ""
1046 Background of the active workspace button, ColorActiveButton is
1047 used if empty.
1048 ColorActiveWorkspaceButtonText = ""
1050 Text color of the active workspace button, ColorActiveButtonText is
1051 used if empty.
1052 ColorNormalTitleBar = "rgb:80/80/80"
1054 Background of the titlebar of regular windows.
1055 ColorNormalTitleBarText = "rgb:00/00/00"
1057 Text color of the titlebar of regular windows.
1058 ColorNormalTitleBarShadow = ""
1060 Text shadow of the titlebar of regular windows.
1061 ColorActiveTitleBar = "rgb:00/00/A0"
1063 Background of the titlebar of active windows.
1064 ColorActiveTitleBarText = "rgb:FF/FF/FF"
1066 Text color of the titlebar of active windows.
1067 ColorActiveTitleBarShadow = ""
1069 Text shadow of the titlebar of active windows.
1070 ColorNormalMinimizedWindow = "rgb:C0/C0/C0"
1072 Background for mini icons of regular windows.
1073 ColorNormalMinimizedWindowText = "rgb:00/00/00"
1075 Text color for mini icons of regular windows.
1076 ColorActiveMinimizedWindow = "rgb:E0/E0/E0"
1078 Background for mini icons of active windows.
1079 ColorActiveMinimizedWindowText = "rgb:00/00/00"
1081 Text color for mini icons of active windows.
1082 ColorNormalMenu = "rgb:C0/C0/C0"
1084 Background of pop-up menus.
1085 ColorNormalMenuItemText = "rgb:00/00/00"
1087 Text color of regular menu items.
1088 ColorActiveMenuItem = "rgb:A0/A0/A0"
1090 Background of selected menu item, leave empty to force
1091 transparency.
1092 ColorActiveMenuItemText = "rgb:00/00/00"
1094 Text color of selected menu items.
1095 ColorDisabledMenuItemText = "rgb:80/80/80"
1097 Text color of disabled menu items.
1098 ColorDisabledMenuItemShadow = ""
1100 Shadow of regular menu items.
1101 ColorMoveSizeStatus = "rgb:C0/C0/C0"
1103 Background of move/resize status window.
1104 ColorMoveSizeStatusText = "rgb:00/00/00"
1106 Text color of move/resize status window.
1107 ColorQuickSwitch = "rgb:C0/C0/C0"
1109 Background of the quick switch window.
1110 ColorQuickSwitchText = "rgb:00/00/00"
1112 Text color in the quick switch window.
1113 ColorQuickSwitchActive = ""
1115 Rectangle around the active icon in the quick switch window.
1116 ColorDefaultTaskBar = "rgb:C0/C0/C0"
1118 Background of the taskbar.
1119 ColorNormalTaskBarApp = "rgb:C0/C0/C0"
1121 Background for task buttons of regular windows.
1122 ColorNormalTaskBarAppText = "rgb:00/00/00"
1124 Text color for task buttons of regular windows.
1125 ColorActiveTaskBarApp = "rgb:E0/E0/E0"
1127 Background for task buttons of the active window.
1128 ColorActiveTaskBarAppText = "rgb:00/00/00"
1130 Text color for task buttons of the active window.
1131 ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"
1133 Background for task buttons of minimized windows.
1134 ColorMinimizedTaskBarAppText = "rgb:00/00/00"
1136 Text color for task buttons of minimized windows.
1137 ColorInvisibleTaskBarApp = "rgb:80/80/80"
1139 Background for task buttons of windows on other workspaces.
1140 ColorInvisibleTaskBarAppText = "rgb:00/00/00"
1142 Text color for task buttons of windows on other workspaces.
1143 ColorScrollBar = "rgb:A0/A0/A0"
1145 Scrollbar background (sliding area).
1146 ColorScrollBarSlider = "rgb:C0/C0/C0"
1148 Background of the slider button in scrollbars.
1149 ColorScrollBarButton = "rgb:C0/C0/C0"
1151 Background of the arrow buttons in scrollbars.
1152 ColorScrollBarArrow = "rgb:C0/C0/C0"
1154 Background of the arrow buttons in scrollbars (obsolete).
1155 ColorScrollBarButtonArrow = "rgb:00/00/00"
1157 Color of active arrows on scrollbar buttons.
1158 ColorScrollBarInactiveArrow = "rgb:80/80/80"
1160 Color of inactive arrows on scrollbar buttons.
1161 ColorListBox = "rgb:C0/C0/C0"
1163 Background of listboxes.
1164 ColorListBoxText = "rgb:00/00/00"
1166 Text color in listboxes.
1167 ColorListBoxSelection = "rgb:80/80/80"
1169 Background of selected listbox items.
1170 ColorListBoxSelectionText = "rgb:00/00/00"
1172 Text color of selected listbox items.
1173 ColorToolTip = "rgb:E0/E0/00"
1175 Background of tooltips.
1176 ColorToolTipText = "rgb:00/00/00"
1178 Text color of tooltips.
1179 ColorLabel = "rgb:C0/C0/C0"
1181 Background of labels, leave empty to force transparency.
1182 ColorLabelText = "rgb:00/00/00"
1184 Text color of labels.
1185 ColorInput = "rgb:FF/FF/FF"
1187 Background of text entry fields (e.g., the addressbar).
1188 ColorInputText = "rgb:00/00/00"
1190 Text color of text entry fields (e.g., the addressbar).
1191 ColorInputSelection = "rgb:80/80/80"
1193 Background of selected text in an entry field.
1194 ColorInputSelectionText = "rgb:00/00/00"
1196 Selected text in an entry field.
1197 ColorClock = "rgb:00/00/00"
1199 Background of non-LCD clock, leave empty to force transparency.
1200 ColorClockText = "rgb:00/FF/00"
1202 Background of non-LCD monitor.
1203 ColorApm = "rgb:00/00/00"
1205 Background of battery monitor, leave empty to force transparency.
1206 ColorApmText = "rgb:00/FF/00"
1208 Text color of battery monitor.
1209 ColorApmBattery = "rgb:FF/FF/00"
1211 Color of battery monitor when discharging.
1212 ColorApmLine = "rgb:00/FF/00"
1214 Color of battery monitor when charging.
1215 ColorApmGraphBg = "rgb:00/00/00"
1217 Background color for graph mode.
1218 ColorCPUStatusUser = "rgb:00/FF/00"
1220 User load on the CPU monitor.
1221 ColorCPUStatusSystem = "rgb:FF/00/00"
1223 System load on the CPU monitor.
1224 ColorCPUStatusInterrupts = "rgb:FF/FF/00"
1226 Interrupts on the CPU monitor.
1227 ColorCPUStatusIoWait = "rgb:60/00/60"
1229 IO Wait on the CPU monitor.
1230 ColorCPUStatusSoftIrq = "rgb:00/FF/FF"
1232 Soft Interrupts on the CPU monitor.
1233 ColorCPUStatusNice = "rgb:00/00/FF"
1235 Nice load on the CPU monitor.
1236 ColorCPUStatusIdle = "rgb:00/00/00"
1238 Idle (non) load on the CPU monitor, leave empty to force
1239 transparency.
1240 ColorCPUStatusSteal = "rgb:FF/8A/91"
1242 Involuntary Wait on the CPU monitor.
1243 ColorCPUStatusTemp = "rgb:60/60/C0"
1245 Temperature of the CPU.
1246 ColorMEMStatusUser = "rgb:40/40/80"
1248 User program usage in the memory monitor.
1249 ColorMEMStatusBuffers = "rgb:60/60/C0"
1251 OS buffers usage in the memory monitor.
1252 ColorMEMStatusCached = "rgb:80/80/FF"
1254 OS cached usage in the memory monitor.
1255 ColorMEMStatusFree = "rgb:00/00/00"
1257 Free memory in the memory monitor.
1258 ColorNetSend = "rgb:FF/FF/00"
1260 Outgoing load on the network monitor.
1261 ColorNetReceive = "rgb:FF/00/FF"
1263 Incoming load on the network monitor.
1264 ColorNetIdle = "rgb:00/00/00"
1266 Idle (non) load on the network monitor, leave empty to force
1267 transparency.
1268 DesktopBackgroundColor=""
1270 Desktop background color(s).
1271 DesktopTransparencyColor=""
1273 Color(s) to announce for semitransparent windows.
1274 DESKTOP BACKGROUND
1276 The following preferences are read by icewmbg(1):
1278 DesktopBackgroundCenter=0 0/1
1280 Display desktop background centered and not tiled.
1281 DesktopBackgroundScaled=0 0/1
1283 Resize desktop background to full screen.
1284 DesktopBackgroundColor=""
1286 Desktop background color(s).
1287 DesktopBackgroundImage=""
1289 Desktop background image(s).
1290 SupportSemitransparency=1 0/1
1292 Support for semitransparent terminals like Eterm or gnome-terminal.
1293 DesktopTransparencyColor=""
1295 Color(s) to announce for semitransparent windows.
1296 DesktopTransparencyImage=""
1298 Image(s) to announce for semitransparent windows.
1299 DesktopBackgroundMultihead=0 0/1
1301 Paint the background image over all multihead monitors combined.
1302
1304 Alpha=1
1305 Splash="IceWM.jpg"
1306 LimitSize=0
1307 LimitPosition=0
1308 LimitByDockLayer=1
1309 QuickSwitchToAllWorkspaces=1
1310 QuickSwitchHugeIcon=1
1311 QuickSwitchFillSelection=1
1312 TaskBarMailboxStatusBeepOnNewMail=1
1313 TaskBarMailboxStatusCountMessages=1
1314 TaskBarShowMEMStatus=0
1315 TaskBarShowCollapseButton=1
1316 TaskBarWorkspacesLimit="8"
1317 ShowProgramsMenu=1
1318 ShowAddressBar=0
1319 ToolTipDelay=200
1320 ToolTipTime=5000
1321 AutoHideDelay=900
1322 AutoShowDelay=100
1323 EdgeResistance=3
1324 KeySysWinMenu=""
1325 KeySysWinListMenu="Shift+Ctrl+Esc"
1326 The above example shows how to tell icewm to not bind a specific key:
1328 KeySysWinMenu in this case.
1329
1331 Locations for the preferences file are as follows:
1332 $ICEWM_PRIVCFG/preferences
1334 $XDG_CONFIG_HOME/icewm/preferences
1335 $HOME/.icewm/preferences
1336 /etc/icewm/preferences
1337 /usr/share/icewm/preferences
1338 The locations are searched in the order listed; the first file found is
1340 read and the remainder ignored.
1341
1343 icewm(1), icewm-prefoverride(5).
1344
1346 Brian Bidulock <mailto:bidulock@openss7.org>.
1347
1349 IceWM is licensed under the GNU Library General Public License. See
1350 the COPYING file in the distribution.
1351icewm 2.3.0 2021-04-02 ICEWM-PREFERENCES(5)