1ICEWM-PREFERENCES(5)  Standards, Environments and Macros  ICEWM-PREFERENCES(5)
2
3
4

NAME

6        icewm-preferences - icewm preferences configuration file
7

SYNOPSIS

9        $ICEWM_PRIVCFG/preferences
10        $XDG_CONFIG_HOME/icewm/preferences
11        $HOME/.icewm/preferences
12        /etc/icewm/preferences
13        /usr/share/icewm/preferences
14

DESCRIPTION

16       Contains general settings like paths, colors and fonts, but also
17       options to control the icewm focus behaviour and the applets which are
18       started in the task bar.  The icewm installation will provide a default
19       preferences file, which can be copied to the icewm user configuration
20       directory and modified.
21

FORMAT

23   FOCUS AND BEHAVIOR
24       The following preferences affect focus and general behavior of
25       icewm(1):
26
27       Alpha=0
28           Use a 32-bit visual for alpha blending
29
30       Synchronize=0
31           Synchronize X11 for debugging (slow)
32
33       LogEvents=0
34           Enable event logging for debugging
35
36       Splash=""
37           Splash image on startup (IceWM.jpg)
38
39       Trace=""
40           Enable tracing for the given list of modules.  Modules which are
41           traceable include conf, font, icon, prog, systray.
42
43       ClickToFocus=1
44           Focus windows by clicking in them.
45
46       FocusOnAppRaise=0
47           Focus windows when applications request that they be raised.
48
49       RequestFocusOnAppRaise=1
50           Request focus (flashing in taskbar) when application requests
51           raise.
52
53       RaiseOnFocus=1
54           Raise windows when focused.
55
56       FocusOnClickClient=1
57           Focus window when client area clicked.
58
59       RaiseOnClickClient=1
60           Raise window when client area clicked.
61
62       RaiseOnClickTitleBar=1
63           Raise window when title bar is clicked.
64
65       RaiseOnClickButton=1
66           Raise window when frame button is clicked.
67
68       RaiseOnClickFrame=1
69           Raise window when frame border is clicked.
70
71       LowerOnClickWhenRaised=0
72           Lower the active window when clicked again.
73
74       PassFirstClickToClient=1
75           Pass focusing click on client area to client.
76
77       FocusChangesWorkspace=0
78           Change to the workspace of newly focused windows.
79
80       FocusCurrentWorkspace=0
81           Move newly focused windows to current workspace.
82
83       FocusOnMap=1
84           Focus normal window when initially mapped.
85
86       FocusOnMapTransient=0
87           Focus dialog window when initially mapped.
88
89       FocusOnMapTransientActive=1
90           Focus dialog window when initially mapped only if parent frame
91           focused.
92
93       MapInactiveOnTop=1
94           Put new windows on top even if not focusing them.
95
96       PointerColormap=1
97           Colormap focus follows pointer.
98
99       DontRotateMenuPointer=1
100           Don't rotate the cursor for popup menus.
101
102       LimitSize=1
103           Limit size of windows to screen.
104
105       LimitPosition=1
106           Limit position of windows to screen.
107
108       LimitByDockLayer=0
109           Let the Dock layer limit the workspace (incompatible with GNOME
110           Panel).
111
112       ConsiderHBorder=0
113           Consider border frames when maximizing horizontally.
114
115       ConsiderVBorder=0
116           Consider border frames when maximizing vertically.
117
118       ConsiderSizeHintsMaximized=1
119           Consider XSizeHints if frame is maximized.  Turning this off allows
120           the titlebar to cover the width of the screen.
121
122       CenterMaximizedWindows=0
123           Center maximized windows which can't fit the screen (like
124           terminals).
125
126       HideBordersMaximized=0
127           Hide window borders if window is maximized.
128
129       SizeMaximized=0
130           Maximized windows can be resized.
131
132       ShowMoveSizeStatus=1
133           Show position status window during move/resize.
134
135       ShowWorkspaceStatus=1
136           Show name of current workspace while switching.
137
138       MinimizeToDesktop=0
139           Display mini-icons on desktop for minimized windows.
140
141       MiniIconsPlaceHorizontal=0
142           Place the mini-icons horizontal instead of vertical.
143
144       MiniIconsRightToLeft=0
145           Place new mini-icons from right to left.
146
147       MiniIconsBottomToTop=0
148           Place new mini-icons from bottom to top.
149
150       StrongPointerFocus=0
151           Always maintain focus under mouse window (makes some keyboard
152           support non-functional or unreliable.
153
154       OpaqueMove=1
155           Opaque window move.
156
157       OpaqueResize=1
158           Opaque window resize.
159
160       ManualPlacement=0
161           Windows initially placed manually by user.
162
163       SmartPlacement=1
164           Smart window placement (minimal overlap).
165
166       HideTitleBarWhenMaximized=0
167           Hide title bar when maximized.
168
169       CenterLarge=0
170           Center large windows.
171
172       CenterTransientsOnOwner=1
173           Center dialogs on owner window.
174
175       MenuMouseTracking=0
176           Menus track mouse even with no mouse buttons held.
177
178       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
183       DelayPointerFocus=1
184           Delay pointer focusing when mouse moves.
185
186       Win95Keys=1
187           Support the Windows/Super key modifier to activate special
188           functions.  The left Super key toggles the Start menu, while the
189           right Super key toggles the Window list window.
190
191       ModSuperIsCtrlAlt=0
192           Treat the Super/Win key modifier as a synonym for the Ctrl+Alt
193           modifier combination. The default key bindings have many
194           occurrences of Ctrl+Alt.  If you enable this, then the Super
195           modifier is an alternative way to activate them.
196
197       UseMouseWheel=0
198           Support mouse wheel. When pressing Ctrl+Alt rotating the mouse
199           wheel on the root window will cycle the focus over the windows.
200
201       TaskBarTaskGrouping=0
202           Group applications with the same class name under a single task
203           button.  0 disables it, 1 shows the number of windows, 2 shows
204           bread crumbs, 3 shows a number + bread crumbs.
205
206       ShowPopupsAbovePointer=0
207           Show popup menus above mouse pointer.
208
209       ReplayMenuCancelClick=0
210           Send the clicks outside menus to target window.
211
212       ClientWindowMouseActions=1
213           Allow mouse actions on client windows (buggy with some programs).
214
215       GrabRootWindow=1
216           Manage root window (EXPERIMENTAL - normally enabled!).
217
218       SnapMove=1
219           Snap to nearest screen edge/window when moving windows.
220
221       SnapDistance=8  [0-64]
222           Distance in pixels before windows snap together.
223
224       ArrangeWindowsOnScreenSizeChange=1
225           Automatically arrange windows when screen size changes.
226
227       AllowFullscreen=1
228           Allow to switch a window to fullscreen.
229
230       FullscreenUseAllMonitors=0
231           Span over all available screens if window goes into fullscreen.
232
233       MsgBoxDefaultAction=0  [0-1]
234           Preselect to Cancel (0) or the OK (1) button in message boxes.
235
236       NetWorkAreaBehaviour=0  [0-2]
237           NET_WORKAREA behaviour: 0 (single/multi-monitor with STRUT
238           information, like metacity), 1 (always full desktop), 2 (single
239           monitor with STRUT, multi-monitor without STRUT).
240
241   QUICK SWITCH
242       QuickSwitch=1
243           Enable Alt+Tab window switching.
244
245       QuickSwitchToMinimized=1
246           Enable Alt+Tab to minimized windows.
247
248       QuickSwitchToHidden=1
249           Enable Alt+Tab to hidden windows.
250
251       QuickSwitchToUrgent=1
252           Prioritize Alt+Tab to urgent windows.
253
254       QuickSwitchToAllWorkspaces=0
255           Include windows from all workspaces in Alt+Tab.
256
257       QuickSwitchGroupWorkspaces=1
258           Group windows by workspace together in Alt+Tab.
259
260       QuickSwitchRaiseCandidate=0
261           Raise a selected window while Alt+Tabbing in the QuickSwitch.
262
263       QuickSwitchAllIcons=1
264           Show all reachable icons when quick switching.
265
266       QuickSwitchTextFirst=0
267           Show the window title above (all reachable) icons.
268
269       QuickSwitchSmallWindow=0
270           Create a smaller QuickSwitch window of 1/3 screen width.
271
272       QuickSwitchMaxWidth=0
273           Go trough all window titles and choose width of the longest one.
274
275       QuickSwitchVertical=1
276           Place the icons and titles vertical instead of horizontal.
277
278       QuickSwitchHugeIcon=0
279           Show the huge (48x48) of the window icon for the active window.
280
281       QuickSwitchFillSelection=0
282           Fill the rectangle highlighting the current icon.
283
284   EDGE SWITCHING
285       EdgeSwitch=0
286           Workspace switches by moving mouse to left/right screen edge.
287
288       HorizontalEdgeSwitch=0
289           Workspace switches by moving mouse to left/right screen edge.
290
291       VerticalEdgeSwitch=0
292           Workspace switches by moving mouse to top/bottom screen edge.
293
294       ContinuousEdgeSwitch=1
295           Workspace switches continuously when moving mouse to screen edge.
296
297       EdgeResistance=32  [0-10000]
298           Resistance in pixels when trying to move windows off the screen
299           (10000 = infinite).
300
301   TASK BAR
302       The following preferences affect the icewm(1) task bar:
303
304       ShowTaskBar=1
305           Show task bar.
306
307       TaskBarAtTop=0
308           Task bar at top of the screen.
309
310       TaskBarKeepBelow=0
311           Keep the task bar below regular windows.
312
313       TaskBarAutoHide=0
314           Auto hide task bar after delay.
315
316       TaskBarFullscreenAutoShow=1
317           Auto show task bar when fullscreen window active.
318
319       TaskBarShowClock=1
320           Show clock on task bar.
321
322       TaskBarShowAPMStatus=0
323           Show battery status monitor on task bar.
324
325       TaskBarShowAPMAuto=1
326           Enable TaskBarShowAPMStatus if a battery is present.
327
328       TaskBarShowAPMTime=1
329           Show battery status on task bar in time-format
330
331       TaskBarShowAPMGraph=1
332           Show battery status in graph mode.
333
334       TaskBarShowMailboxStatus=1
335           Show mailbox status on task bar.
336
337       TaskBarMailboxStatusBeepOnNewMail=0
338           Beep when new mail arrives.
339
340       TaskBarMailboxStatusCountMessages=0
341           Count messages in mailbox.
342
343       TaskBarShowWorkspaces=1
344           Show workspace switching buttons on task bar.
345
346       TaskBarShowWindows=1
347           Show windows on the taskbar.
348
349       TaskBarShowShowDesktopButton=1
350           Show 'show desktop' button on taskbar. If set to 2, it will move
351           the icon to the right side, after the clock.
352
353       ShowEllipsis=1
354           Show Ellipsis in taskbar items.
355
356       TaskBarShowTray=1
357           Show windows in the tray.
358
359       TaskBarEnableSystemTray=1
360           Enable the system tray in the taskbar.
361
362       TrayShowAllWindows=1
363           Show windows from all workspaces on tray.
364
365       TaskBarShowTransientWindows=1
366           Show transient (dialogs, ...) windows on task bar.
367
368       TaskBarShowAllWindows=0
369           Show windows from all workspaces on task bar.
370
371       TaskBarShowWindowIcons=1
372           Show icons of windows on the task bar.
373
374       TaskBarShowStartMenu=1
375           Show 'Start' menu on task bar.
376
377       TaskBarShowWindowListMenu=1
378           Show 'window list' menu on task bar.
379
380       TaskBarShowCPUStatus=1
381           Show CPU status on task bar (Linux & Solaris).
382
383       CPUStatusShowRamUsage=1
384           Show RAM usage in CPU status tool tip.
385
386       CPUStatusShowSwapUsage=1
387           Show swap usage in CPU status tool tip.
388
389       CPUStatusShowAcpiTemp=1
390           Show ACPI temperature in CPU status tool tip.
391
392       CPUStatusShowAcpiTempInGraph=0
393           Show ACPI temperature in CPU status bar.
394
395       CPUStatusShowCpuFreq=1
396           Show CPU frequency in CPU status tool tip.
397
398       NetStatusShowOnlyRunning=0
399           Show network status only for connected devices, such as an active
400           ethernet link or associated wireless interface. If false, any
401           network interface that has been brought up will be displayed.
402
403       TaskBarShowMEMStatus=1
404           Show memory usage status on task bar (Linux only).
405
406       TaskBarShowNetStatus=1
407           Show network status on task bar (Linux only).
408
409       TaskBarShowCollapseButton=0
410           Show a button to collapse the taskbar.
411
412       TaskBarDoubleHeight=0
413           Use double-height task bar.
414
415       TaskBarWorkspacesLeft=1
416           Place workspace pager on left, not right.
417
418       TaskBarWorkspacesTop=0
419           Place workspace pager on top row when using dual-height taskbar.
420
421       TaskBarWorkspacesLimit=""
422           Limit the number of taskbar workspaces buttons which are shown on
423           the workspaces pane of the taskbar. If the numeric value has a "p"
424           suffix then the limitation is in pixels. A "%" suffix limits by
425           percentage of desktop width. By default a "B" suffix is assumed for
426           number of buttons.
427
428       TaskBarUseMouseWheel=1
429           Enable mouse wheel cycling over workspaces and task buttons in
430           taskbar.
431
432       TaskBarClockLeds=0 # 0/1
433           Task bar clock/battery monitor uses nice pixmap LCD display (but
434           then it doesn't display correctly in many languages anymore, e.g.,
435           for Japanese and Korean it works only when a real font is used and
436           not the LCD pixmaps.
437
438       PagerShowPreview=1
439           Show a mini desktop preview on each workspace button.
440
441       PagerShowWindowIcons=1
442           Draw window icons inside large enough preview windows on pager (if
443           PagerShowPreview=1).
444
445       PagerShowMinimized=1
446           Draw even minimized windows as unfilled rectangles (if
447           PagerShowPreview=1).
448
449       PagerShowBorders=1
450           Draw border around workspace buttons (if PagerShowPreview=1).
451
452       PagerShowLabels=1
453           Show workspace name label on workspace button (if
454           PagerShowPreview=1)
455
456       PagerShowNumbers=1
457           Show number of workspace on workspace button (if
458           PagerShowPreview=1).
459
460       TaskBarLaunchOnSingleClick=1
461           Execute taskbar applet commands (like MailCommand, ClockCommand,
462           ...) on single click.
463
464       EnableAddressBar=1
465           Enable address bar functionality in taskbar.
466
467       ShowAddressBar=1
468           Show address bar in task bar.
469
470       MultiByte=1
471           Overrides automatic multiple byte detection.
472
473       ConfirmLogout=1
474           Confirm logout.
475
476       ShapesProtectClientWindow=1
477           Don't cut client windows by shapes set trough frame corner pixmap.
478
479       DoubleBuffer=1
480           Use double buffering when redrawing the display.
481
482       XRRDisable=1
483           Disable use of new XRANDR API for dual head (nvidia workaround).
484
485       PreferFreetypeFonts=1
486           Favour Xft fonts over core X11 fonts where possible.
487
488       MailBoxPath=""
489           A colon separated list of paths of your mailboxes.  If this is
490           empty, $MAILPATH or $MAIL is used instead.
491
492           Path to a mbox file. Remote mail boxes are accessed by specifying
493           an URL using the Common Internet Scheme Syntax (RFC 1738):
494
495               `scheme://[user[:password]@]server[:port][/path]`.
496
497           Supported schemes are "pop3", "imap" and "file".  When the scheme
498           is omitted file:// is prepended silently. IMAP subfolders can be
499           accessed by using the  path component.  Reserved characters like
500           slash ("/"), at ("@") and colon (":") can be specified using escape
501           sequences with a hexadecimal encoding like %2f for the slash or %40
502           for the at sign.  For example:
503
504               file:///var/spool/mail/captnmark
505               pop3://markus:%2f%40%3a@maol.ch/
506               imap://mathias@localhost/INBOX.Maillisten.icewm-user
507
508       NetworkStatusDevice="eth0 wlan0"
509           Network device for which to show status.
510
511       TimeFormat="%X"
512           Clock Time format (strftime format string).
513
514       TimeFormatAlt=""
515           Alternate Clock Time format (e.g., for blinking effects).
516
517       DateFormat="%c"
518           Clock Date format for tooltip (strftime format string).
519
520       DockApps="right high desktop"
521           Support DockApps (right, left, center, down, high, above, below,
522           desktop, or empty to disable). Control with Ctrl+Mouse.
523
524       XRRPrimaryScreenName=""
525           Screen/output name of the primary screen.
526
527       AcpiIgnoreBatteries=""
528           List of battery names (directories) in /proc/acpi/battery to
529           ignore.  Useful when more slots are built-in, but only one battery
530           is used.
531
532       TaskBarCPUSamples=20  [2-1000]
533           The width of the CPU Monitor applet in pixels.
534
535       TaskBarMEMSamples=20  [2-1000]
536           The width of the Memory Monitor applet in pixels.
537
538       TaskBarNetSamples=20  [2-1000]
539           The width of the Net Monitor applet in pixels.
540
541       TaskbarButtonWidthDivisor=3  [1-25]
542           Default number of tasks in taskbar.
543
544       TaskBarWidthPercentage=100  [0-100]
545           Task bar width as percentage of the screen width.
546
547       TaskBarJustify="left"
548           Taskbar justify left, right or center.
549
550       TaskBarApmGraphWidth=10  [1-1000]
551           Width of battery Monitor.
552
553       TaskBarGraphHeight=20  [16-1000]
554           Height of taskbar monitoring applets.
555
556       XineramaPrimaryScreen=0  [0-63]
557           Primary screen for xinerama (taskbar, ...).
558
559       TaskbuttonIconOffset=0 # [0-16]
560           Width of taskbutton side icons.
561
562       TrayIconMaxWidth=32 # [16-128]
563           Maximum scaled width of tray icons.
564
565       TrayIconMaxHeight=24 # [16-128]
566           Maximum scaled height of tray icons.
567
568       TrayDrawBevel=0 # 0/1
569           Surround the tray with plastic border.
570
571       KeyboardLayouts=""
572           A comma-separated list of keyboard layouts.  A layout may be
573           enclosed in double quotes.  Each layout is a name with optional
574           arguments, which is to be parsed by the "setxkbmap" program.  To
575           support changing keyboard layouts, the "setxkbmap" program must be
576           installed.  The first in the list is the default layout.  Programs
577           may have their own keyboard layout defined in the winoptions file.
578           The first two letters of a layout are used to locate an icon image
579           file.
580
581   MENUS
582       AutoReloadMenus=1
583           Reload menu files automatically.
584
585       ShowProgramsMenu=0
586           Show programs submenu.
587
588       ShowSettingsMenu=1
589           Show settings submenu.
590
591       ShowFocusModeMenu=1
592           Show focus mode submenu.
593
594       ShowThemesMenu=1
595           Show themes submenu.
596
597       ShowLogoutMenu=1
598           Show logout menu.
599
600       ShowHelp=1
601           Show the help menu item.
602
603       ShowLogoutSubMenu=1
604           Show logout submenu.
605
606       ShowAbout=1
607           Show the about menu item.
608
609       ShowRun=1
610           Show the run menu item.
611
612       ShowWindowList=1
613           Show the window menu item.
614
615       MenuMaximalWidth=0  [0-16384]
616           Maximal width of popup menus,  2/3 of the screen's width if set to
617           zero.
618
619       NestedThemeMenuMinNumber=25  [0-1234]
620           Minimal number of themes after which the Themes menu becomes nested
621           (0=disabled).
622
623   TIMINGS
624       DelayFuzziness=10  (0-100)
625           Delay fuzziness, to allow merging of multiple timer timeouts into
626           one (notebook power saving).
627
628       ClickMotionDistance=4  [0-32]
629           Pointer motion distance before click gets interpreted as drag.
630
631       ClickMotionDelay=200  [0-2000]
632           Delay before click gets interpreted as drag.
633
634       MultiClickTime=400  [0-5000]
635           Multiple click time.
636
637       MenuActivateDelay=40  [0-5000]
638           Delay before activating menu items.
639
640       SubmenuMenuActivateDelay=300  [0-5000]
641           Delay before activating menu submenus.
642
643       ToolTipDelay=1000  [0-5000]
644           Delay before tooltip window is displayed.
645
646       ToolTipTime=0  [0-60000]
647           Time before tooltip window is hidden (0 means never.
648
649       AutoHideDelay=300  [0-5000]
650           Delay before task bar is hidden.
651
652       AutoShowDelay=500  [0-5000]
653           Delay before task bar is shown.
654
655       AutoRaiseDelay=400  [0-5000]
656           Delay before windows are auto raised if "AutoRaise=1".
657
658       PointerFocusDelay=200  [0-1000]
659           Delay for pointer focus switching.
660
661       EdgeSwitchDelay=600  [0-5000]
662           Screen edge workspace switching delay.
663
664       ScrollBarStartDelay=500  [0-5000]
665           Initial scroll bar autoscroll delay.
666
667       ScrollBarDelay=30  [0-5000]
668           Scroll bar autoscroll delay.
669
670       AutoScrollStartDelay=500  [0-5000]
671           Auto scroll start delay.
672
673       AutoScrollDelay=60  [0-5000]
674           Auto scroll delay.
675
676       WorkspaceStatusTime=2500  [0-2500]
677           Time before workspace status window is hidden.
678
679       MailCheckDelay=30  [0-86400]
680           Delay between new-mail checks. (seconds).
681
682       TaskBarCPUDelay=500  [10-3600000]
683           Delay between CPU Monitor samples in ms.
684
685       TaskBarMEMDelay=500  [10-3600000]
686           Delay between Memory Monitor samples in ms.
687
688       TaskBarNetDelay=500  [10-3600000]
689           Delay between Net Monitor samples in ms.
690
691       FocusRequestFlashTime=0  [0-86400]
692           Number of seconds the taskbar app will blink when requesting focus
693           (0 = forever).
694
695       FocusRequestFlashInterval=250  [0-30000]
696           Taskbar blink interval (ms) when requesting focus (0 = blinking
697           disabled).
698
699       BatteryPollingPeriod=10  [2-3600]
700           Delay between power status updates (seconds).
701
702       PingTimeout=3  [0-86400]
703           Timeout in seconds for applications to respond to the _NET_WM_PING
704           protocol.
705
706   BUTTONS AND KEYS
707       UseRootButtons=255  [0-255]
708           Bitmask of root window button click to use in window manager.
709
710       ButtonRaiseMask=1  [0-255]
711           Bitmask of buttons that raise the window when pressed.
712
713       DesktopWinMenuButton=0  [0-20]
714           Desktop mouse-button click to show the window list menu.
715
716       DesktopWinListButton=2 # [0-20]
717           Desktop mouse-button click to show the window list
718
719       DesktopMenuButton=3  [0-20]
720           Desktop mouse-button click to show the root menu.
721
722       TitleBarMaximizeButton=1  [0-5]
723           Title bar mouse-button double click to maximize the window to full
724           screen with the frame border visible.  Press Shift to maximize only
725           in the vertical direction.  Press Alt+Shift to maximize only in the
726           horizontal direction.
727
728       TitleBarRollupButton=2  [0-5]
729           Title bar mouse-button double click to rollup the window.  Press
730           Shift to maximize in the horizontal direction.
731
732   WORKSPACES
733       WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
734           Create four workspaces with names  1 ,  2 ,  3  and  4 .
735
736   PATHS
737       IconPath="/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps"
738           Icon search path (colon separated). Also, the icons/ subdirectory
739           in IceWM resource folders are searched first.
740
741       IconThemes="*:-HighContrast"
742           List of icon themes (colon separated), acting as additional filter
743           of icon subdirectories in any of the IconPath folders. Expressions
744           can be wildcards, also special wildcards (starting with -) can
745           exclude matched themes from selection.
746
747       MailBoxPath=""
748           A colon separated list of paths of your mailboxes.  If this is
749           empty, $MAILPATH or $MAIL is used instead.
750
751   PROGRAMS
752       MailCommand="xterm -name mutt -e mutt"
753           Command to run on mailbox.
754
755       MailClassHint="mutt.XTerm"
756           WM_CLASS to allow runonce for MailCommand.
757
758       NewMailCommand=""
759           Command to run when new mail arrives.
760
761       LockCommand=""
762           Command to lock display/screensaver.
763
764       ClockCommand="xclock -name icewm -title Clock"
765           Command to run on clock.
766
767       ClockClassHint="icewm.XClock"
768           WM_CLASS to allow runonce for ClockCommand.
769
770       RunCommand=""
771           Command to select and run a program.
772
773       OpenCommand=""
774           Open command.
775
776       TerminalCommand="xterm"
777           Terminal emulator must accept -e option.
778
779       LogoutCommand=""
780           Command to start logout.
781
782       LogoutCancelCommand=""
783           Command to cancel logout.
784
785       ShutdownCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
786       poweroff; } ||:""
787           Command to shutdown the system.
788
789       RebootCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
790       reboot; } ||:""
791           Command to reboot the system.
792
793       SuspendCommand="test -e /run/systemd/system && systemctl suspend"
794           Command to send the system to standby mode
795
796       CPUStatusCommand="xterm -name top -title Process\ Status -e top"
797           Command to run on CPU status.
798
799       CPUStatusClassHint="top.XTerm"
800           WM_CLASS to allow runonce for CPUStatusCommand.
801
802       CPUStatusCombine=1  0/1
803           Combine all CPUs to one.
804
805       NetStatusCommand="xterm -name netstat -title 'Network Status' -e
806       netstat -c"
807           Command to run on Net status.
808
809       NetStatusClassHint="netstat.XTerm"
810           WM_CLASS to allow runonce for NetStatusCommand.
811
812       AddressBarCommand=""
813           Command to run for address bar entries.
814
815   WINDOW MENUS
816       WinMenuItems="rmsnxfhualyticw"
817           Items supported in menu window (rmsnxfhualytickw)
818
819       RolloverButtonsSupported=0
820           Does it support the 'O' title bar button images (for mouse
821           rollover).
822
823       ShowMenuButtonIcon=1 # 0/1
824           Show application icon over menu button
825
826   THEME SETTINGS
827       The following sections show settings that can be set in theme files.
828       They can also be set in the preferences file, but themes will override
829       the values set there.  To override the theme values, the settings
830       should be set in prefoverrides file: see icewm-prefoverrides(5).
831       Default values are shown following the equal sign.
832
833       THEME DESCRIPTION
834
835       ThemeAuthor=""
836           Theme author, e-mail address, credits.
837
838       ThemeDescription=""
839           Description of the theme, credits.
840
841       Look="nice"
842           Choose a theme look from one of: "win95", "motif", "warp3",
843           "warp4", "nice", "metal2", "gtk2", and some others.
844
845       Gradients=""
846           List of gradient pixmaps in the current theme.
847
848       THEME BORDERS, ICONS, MARGINS AND BUTTONS
849
850       BorderSizeX=6  [0-128]
851           Horizontal window border.
852
853       BorderSizeY=6  [0-128]
854           Vertical window border.
855
856       DlgBorderSizeX=2  [0-128]
857           Horizontal dialog window border.
858
859       DlgBorderSizeY=2  [0-128]
860           Vertical dialog window border.
861
862       CornerSizeX=24  [0-64]
863           Resize corner width.
864
865       CornerSizeY=24  [0-64]
866           Resize corner height.
867
868       TitleBarHeight=20  [0-128]
869           Title bar height.
870
871       TitleBarJustify=0  [0-100]
872           Justification of the window title.
873
874       TitleBarHorzOffset=0  [-128-128]
875           Horizontal offset for the window title text.
876
877       TitleBarVertOffset=0  [-128-128]
878           Vertical offset for the window title text.
879
880       MenuButtonIconVertOffset=0  [-128-128]
881           Vertical offset for the menu button icon.
882
883       ScrollBarX=16  [0-64]
884           Scrollbar width.
885
886       ScrollBarY=16  [0-64]
887           Scrollbar (button) height.
888
889       MenuIconSize=16  [8-128]
890           Menu icon size.
891
892       SmallIconSize=16  [8-128]
893           Dimension of the small icons.
894
895       LargeIconSize=32  [8-128]
896           Dimension of the large icons.
897
898       HugeIconSize=48  [8-128]
899           Dimension of the large icons.
900
901       QuickSwitchHorzMargin=3  [0-64]
902           Horizontal margin of the quickswitch window.
903
904       QuickSwitchVertMargin=3  [0-64]
905           Vertical margin of the quickswitch window.
906
907       QuickSwitchIconMargin=4  [0-64]
908           Vertical margin in the quickswitch window.
909
910       QuickSwitchIconBorder=2  [0-64]
911           Distance between the active icon and it's border.
912
913       QuickSwitchSeparatorSize=6  [0-64]
914           Height of the separator between (all reachable) icons and text, 0
915           to avoid it.
916
917       TitleButtonsLeft="s"
918           Titlebar buttons from left to right (x=close, m=max, i=min, h=hide,
919           r=rollup, s=sysmenu, d=depth).
920
921       TitleButtonsRight="xmir"
922           Titlebar buttons from right to left (x=close, m=max, i=min, h=hide,
923           r=rollup, s=sysmenu, d=depth).
924
925       TitleButtonsSupported="xmis"
926           Titlebar buttons supported by theme (x,m,i,r,h,s,d).
927
928       TitleBarCentered=0 # 0/1
929           Draw window title centered (obsoleted by TitleBarJustify).
930
931       TitleBarJoinLeft=0 # 0/1
932           Join title*S and title*T.
933
934       TitleBarJoinRight=0 # 0/1
935           Join title*T and title*B.
936
937       THEME FONTS
938
939       TitleFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
940       TitleFontNameXft="sans-serif:size=12"
941           Name of the title bar font.
942
943       MenuFontName="-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"
944       MenuFontNameXft="sans-serif:size=10:bold"
945           Name of the menu font.
946
947       StatusFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
948       StatusFontNameXft="monospace:size=12:bold"
949           Name of the status display font.
950
951       QuickSwitchFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
952       QuickSwitchFontNameXft="monospace:size=12:bold"
953           Name of the font for Alt+Tab switcher window.
954
955       NormalButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
956       NormalButtonFontNameXft="sans-serif:size=12"
957           Name of the normal button font.
958
959       ActiveButtonFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
960       ActiveButtonFontNameXft="sans-serif:size=12:bold"
961           Name of the active button font.
962
963       NormalTaskBarFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
964       NormalTaskBarFontNameXft="sans-serif:size=12"
965           Name of the normal task bar item font.
966
967       ActiveTaskBarFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
968       ActiveTaskBarFontNameXft="sans-serif:size=12:bold"
969           Name of the active task bar item font.
970
971       ToolButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
972       ToolButtonFontNameXft="sans-serif:size=12"
973           Name of the tool button font (fallback: NormalButtonFontName).
974
975       NormalWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
976       NormalWorkspaceFontNameXft="sans-serif:size=12"
977           Name of the normal workspace button font (fallback:
978           NormalButtonFontName).
979
980       ActiveWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
981       ActiveWorkspaceFontNameXft="sans-serif:size=12"
982           Name of the active workspace button font (fallback:
983           ActiveButtonFontName).
984
985       MinimizedWindowFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
986       MinimizedWindowFontNameXft="sans-serif:size=12"
987           Name of the mini-window font.
988
989       ListBoxFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
990       ListBoxFontNameXft="sans-serif:size=12"
991           Name of the window list font.
992
993       ToolTipFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
994       ToolTipFontNameXft="sans-serif:size=12"
995           Name of the tool tip font.
996
997       ClockFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
998       ClockFontNameXft="monospace:size=12"
999           Name of the task bar clock font.
1000
1001       TempFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1002       TempFontNameXft="monospace:size=12"
1003           Name of the task bar temperature font.
1004
1005       ApmFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1006       ApmFontNameXft="monospace:size=12"
1007           Name of the task bar battery font.
1008
1009       InputFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1010       InputFontNameXft="monospace:size=12"
1011           Name of the input field font.
1012
1013       LabelFontName="-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"
1014       LabelFontNameXft="sans-serif:size=12"
1015           Name of the label font.
1016
1017       THEME COLORS
1018
1019       ColorDialog = "rgb:C0/C0/C0"
1020           Background of dialog windows.
1021
1022       ColorNormalBorder = "rgb:C0/C0/C0"
1023           Border of inactive windows.
1024
1025       ColorActiveBorder = "rgb:C0/C0/C0"
1026           Border of active windows.
1027
1028       ColorNormalButton = "rgb:C0/C0/C0"
1029           Background of regular buttons.
1030
1031       ColorNormalButtonText = "rgb:00/00/00"
1032           Text color of regular buttons.
1033
1034       ColorActiveButton = "rgb:E0/E0/E0"
1035           Background of pressed buttons.
1036
1037       ColorActiveButtonText = "rgb:00/00/00"
1038           Text color of pressed buttons.
1039
1040       ColorNormalTitleButton = "rgb:C0/C0/C0"
1041           Background of titlebar buttons.
1042
1043       ColorNormalTitleButtonText = "rgb:00/00/00"
1044           Text color of titlebar buttons.
1045
1046       ColorToolButton = ""
1047           Background of toolbar buttons, ColorNormalButton is used if empty.
1048
1049       ColorToolButtonText = ""
1050           Text color of toolbar buttons, ColorNormalButtonText is used if
1051           empty.
1052
1053       ColorNormalWorkspaceButton = ""
1054           Background of workspace buttons, ColorNormalButton is used if
1055           empty.
1056
1057       ColorNormalWorkspaceButtonText = ""
1058           Text color of workspace buttons, ColorNormalButtonText is used if
1059           empty.
1060
1061       ColorActiveWorkspaceButton = ""
1062           Background of the active workspace button, ColorActiveButton is
1063           used if empty.
1064
1065       ColorActiveWorkspaceButtonText = ""
1066           Text color of the active workspace button, ColorActiveButtonText is
1067           used if empty.
1068
1069       ColorNormalTitleBar = "rgb:80/80/80"
1070           Background of the titlebar of regular windows.
1071
1072       ColorNormalTitleBarText = "rgb:00/00/00"
1073           Text color of the titlebar of regular windows.
1074
1075       ColorNormalTitleBarShadow = ""
1076           Text shadow of the titlebar of regular windows.
1077
1078       ColorActiveTitleBar = "rgb:00/00/A0"
1079           Background of the titlebar of active windows.
1080
1081       ColorActiveTitleBarText = "rgb:FF/FF/FF"
1082           Text color of the titlebar of active windows.
1083
1084       ColorActiveTitleBarShadow = ""
1085           Text shadow of the titlebar of active windows.
1086
1087       ColorNormalMinimizedWindow = "rgb:C0/C0/C0"
1088           Background for mini icons of regular windows.
1089
1090       ColorNormalMinimizedWindowText = "rgb:00/00/00"
1091           Text color for mini icons of regular windows.
1092
1093       ColorActiveMinimizedWindow = "rgb:E0/E0/E0"
1094           Background for mini icons of active windows.
1095
1096       ColorActiveMinimizedWindowText = "rgb:00/00/00"
1097           Text color for mini icons of active windows.
1098
1099       ColorNormalMenu = "rgb:C0/C0/C0"
1100           Background of pop-up menus.
1101
1102       ColorNormalMenuItemText = "rgb:00/00/00"
1103           Text color of regular menu items.
1104
1105       ColorActiveMenuItem = "rgb:A0/A0/A0"
1106           Background of selected menu item, leave empty to force
1107           transparency.
1108
1109       ColorActiveMenuItemText = "rgb:00/00/00"
1110           Text color of selected menu items.
1111
1112       ColorDisabledMenuItemText = "rgb:80/80/80"
1113           Text color of disabled menu items.
1114
1115       ColorDisabledMenuItemShadow = ""
1116           Shadow of regular menu items.
1117
1118       ColorMoveSizeStatus = "rgb:C0/C0/C0"
1119           Background of move/resize status window.
1120
1121       ColorMoveSizeStatusText = "rgb:00/00/00"
1122           Text color of move/resize status window.
1123
1124       ColorQuickSwitch = "rgb:C0/C0/C0"
1125           Background of the quick switch window.
1126
1127       ColorQuickSwitchText = "rgb:00/00/00"
1128           Text color in the quick switch window.
1129
1130       ColorQuickSwitchActive = ""
1131           Rectangle around the active icon in the quick switch window.
1132
1133       ColorDefaultTaskBar = "rgb:C0/C0/C0"
1134           Background of the taskbar.
1135
1136       ColorNormalTaskBarApp = "rgb:C0/C0/C0"
1137           Background for task buttons of regular windows.
1138
1139       ColorNormalTaskBarAppText = "rgb:00/00/00"
1140           Text color for task buttons of regular windows.
1141
1142       ColorActiveTaskBarApp = "rgb:E0/E0/E0"
1143           Background for task buttons of the active window.
1144
1145       ColorActiveTaskBarAppText = "rgb:00/00/00"
1146           Text color for task buttons of the active window.
1147
1148       ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"
1149           Background for task buttons of minimized windows.
1150
1151       ColorMinimizedTaskBarAppText = "rgb:00/00/00"
1152           Text color for task buttons of minimized windows.
1153
1154       ColorInvisibleTaskBarApp = "rgb:80/80/80"
1155           Background for task buttons of windows on other workspaces.
1156
1157       ColorInvisibleTaskBarAppText = "rgb:00/00/00"
1158           Text color for task buttons of windows on other workspaces.
1159
1160       ColorScrollBar = "rgb:A0/A0/A0"
1161           Scrollbar background (sliding area).
1162
1163       ColorScrollBarSlider = "rgb:C0/C0/C0"
1164           Background of the slider button in scrollbars.
1165
1166       ColorScrollBarButton = "rgb:C0/C0/C0"
1167           Background of the arrow buttons in scrollbars.
1168
1169       ColorScrollBarArrow = "rgb:C0/C0/C0"
1170           Background of the arrow buttons in scrollbars (obsolete).
1171
1172       ColorScrollBarButtonArrow = "rgb:00/00/00"
1173           Color of active arrows on scrollbar buttons.
1174
1175       ColorScrollBarInactiveArrow = "rgb:80/80/80"
1176           Color of inactive arrows on scrollbar buttons.
1177
1178       ColorListBox = "rgb:C0/C0/C0"
1179           Background of listboxes.
1180
1181       ColorListBoxText = "rgb:00/00/00"
1182           Text color in listboxes.
1183
1184       ColorListBoxSelection = "rgb:80/80/80"
1185           Background of selected listbox items.
1186
1187       ColorListBoxSelectionText = "rgb:00/00/00"
1188           Text color of selected listbox items.
1189
1190       ColorToolTip = "rgb:E0/E0/00"
1191           Background of tooltips.
1192
1193       ColorToolTipText = "rgb:00/00/00"
1194           Text color of tooltips.
1195
1196       ColorLabel = "rgb:C0/C0/C0"
1197           Background of labels, leave empty to force transparency.
1198
1199       ColorLabelText = "rgb:00/00/00"
1200           Text color of labels.
1201
1202       ColorInput = "rgb:FF/FF/FF"
1203           Background of text entry fields (e.g., the addressbar).
1204
1205       ColorInputText = "rgb:00/00/00"
1206           Text color of text entry fields (e.g., the addressbar).
1207
1208       ColorInputSelection = "rgb:80/80/80"
1209           Background of selected text in an entry field.
1210
1211       ColorInputSelectionText = "rgb:00/00/00"
1212           Selected text in an entry field.
1213
1214       ColorClock = "rgb:00/00/00"
1215           Background of non-LCD clock, leave empty to force transparency.
1216
1217       ColorClockText = "rgb:00/FF/00"
1218           Background of non-LCD monitor.
1219
1220       ColorApm = "rgb:00/00/00"
1221           Background of battery monitor, leave empty to force transparency.
1222
1223       ColorApmText = "rgb:00/FF/00"
1224           Text color of battery monitor.
1225
1226       ColorApmBattery = "rgb:FF/FF/00"
1227           Color of battery monitor when discharging.
1228
1229       ColorApmLine = "rgb:00/FF/00"
1230           Color of battery monitor when charging.
1231
1232       ColorApmGraphBg = "rgb:00/00/00"
1233           Background color for graph mode.
1234
1235       ColorCPUStatusUser = "rgb:00/FF/00"
1236           User load on the CPU monitor.
1237
1238       ColorCPUStatusSystem = "rgb:FF/00/00"
1239           System load on the CPU monitor.
1240
1241       ColorCPUStatusInterrupts = "rgb:FF/FF/00"
1242           Interrupts on the CPU monitor.
1243
1244       ColorCPUStatusIoWait = "rgb:60/00/60"
1245           IO Wait on the CPU monitor.
1246
1247       ColorCPUStatusSoftIrq = "rgb:00/FF/FF"
1248           Soft Interrupts on the CPU monitor.
1249
1250       ColorCPUStatusNice = "rgb:00/00/FF"
1251           Nice load on the CPU monitor.
1252
1253       ColorCPUStatusIdle = "rgb:00/00/00"
1254           Idle (non) load on the CPU monitor, leave empty to force
1255           transparency.
1256
1257       ColorCPUStatusSteal = "rgb:FF/8A/91"
1258           Involuntary Wait on the CPU monitor.
1259
1260       ColorCPUStatusTemp = "rgb:60/60/C0"
1261           Temperature of the CPU.
1262
1263       ColorMEMStatusUser = "rgb:40/40/80"
1264           User program usage in the memory monitor.
1265
1266       ColorMEMStatusBuffers = "rgb:60/60/C0"
1267           OS buffers usage in the memory monitor.
1268
1269       ColorMEMStatusCached = "rgb:80/80/FF"
1270           OS cached usage in the memory monitor.
1271
1272       ColorMEMStatusFree = "rgb:00/00/00"
1273           Free memory in the memory monitor.
1274
1275       ColorNetSend = "rgb:FF/FF/00"
1276           Outgoing load on the network monitor.
1277
1278       ColorNetReceive = "rgb:FF/00/FF"
1279           Incoming load on the network monitor.
1280
1281       ColorNetIdle = "rgb:00/00/00"
1282           Idle (non) load on the network monitor, leave empty to force
1283           transparency.
1284
1285       DesktopBackgroundColor=""
1286           Desktop background color(s).
1287
1288       DesktopTransparencyColor=""
1289           Color(s) to announce for semitransparent windows.
1290
1291       DESKTOP BACKGROUND
1292
1293       The following preferences are read by icewmbg(1):
1294
1295       DesktopBackgroundCenter=0  0/1
1296           Display desktop background centered and not tiled.
1297
1298       DesktopBackgroundScaled=0  0/1
1299           Resize desktop background to full screen.
1300
1301       DesktopBackgroundColor=""
1302           Desktop background color(s).
1303
1304       DesktopBackgroundImage=""
1305           Desktop background image(s).
1306
1307       SupportSemitransparency=1  0/1
1308           Support for semitransparent terminals like Eterm or gnome-terminal.
1309
1310       DesktopTransparencyColor=""
1311           Color(s) to announce for semitransparent windows.
1312
1313       DesktopTransparencyImage=""
1314           Image(s) to announce for semitransparent windows.
1315
1316       DesktopBackgroundMultihead=0  0/1
1317           Paint the background image over all multihead monitors combined.
1318

EXAMPLES

1320           Alpha=1
1321           Splash="IceWM.jpg"
1322           LimitSize=0
1323           LimitPosition=0
1324           LimitByDockLayer=1
1325           QuickSwitchToAllWorkspaces=1
1326           QuickSwitchHugeIcon=1
1327           QuickSwitchFillSelection=1
1328           TaskBarMailboxStatusBeepOnNewMail=1
1329           TaskBarMailboxStatusCountMessages=1
1330           TaskBarShowMEMStatus=0
1331           TaskBarShowCollapseButton=1
1332           TaskBarWorkspacesLimit="8"
1333           ShowProgramsMenu=1
1334           ShowAddressBar=0
1335           ToolTipDelay=200
1336           ToolTipTime=5000
1337           AutoHideDelay=900
1338           AutoShowDelay=100
1339           EdgeResistance=3
1340           KeySysWinMenu=""
1341           KeySysWinListMenu="Shift+Ctrl+Esc"
1342
1343       The above example shows how to tell icewm to not bind a specific key:
1344       KeySysWinMenu in this case.
1345

FILES

1347       Locations for the preferences file are as follows:
1348
1349        $ICEWM_PRIVCFG/preferences
1350        $XDG_CONFIG_HOME/icewm/preferences
1351        $HOME/.icewm/preferences
1352        /etc/icewm/preferences
1353        /usr/share/icewm/preferences
1354
1355       The locations are searched in the order listed; the first file found is
1356       read and the remainder ignored.
1357

SEE ALSO

1359       icewm(1), icewm-prefoverride(5).
1360

AUTHOR

1362       Brian Bidulock <mailto:bidulock@openss7.org>.
1363

LICENSE

1365       IceWM is licensed under the GNU Library General Public License.  See
1366       the COPYING file in the distribution.
1367
1368
1369
1370icewm 2.9.0                       2021-11-24              ICEWM-PREFERENCES(5)
Impressum