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, 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 win95 keyboard keys (Penguin/Meta/Win_L,R shows menu).
188
189       ModSuperIsCtrlAlt=1
190           Treat Super/Win modifier as Ctrl+Alt.
191
192       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
196       TaskBarTaskGrouping=0
197           Group applications with the same class name under a single task
198           button.
199
200       ShowPopupsAbovePointer=0
201           Show popup menus above mouse pointer.
202
203       ReplayMenuCancelClick=0
204           Send the clicks outside menus to target window.
205
206       ClientWindowMouseActions=1
207           Allow mouse actions on client windows (buggy with some programs).
208
209       GrabRootWindow=1
210           Manage root window (EXPERIMENTAL - normally enabled!).
211
212       SnapMove=1
213           Snap to nearest screen edge/window when moving windows.
214
215       SnapDistance=8  [0-64]
216           Distance in pixels before windows snap together.
217
218       ArrangeWindowsOnScreenSizeChange=1
219           Automatically arrange windows when screen size changes.
220
221       AllowFullscreen=1
222           Allow to switch a window to fullscreen.
223
224       FullscreenUseAllMonitors=0
225           Span over all available screens if window goes into fullscreen.
226
227       MsgBoxDefaultAction=0  [0-1]
228           Preselect to Cancel (0) or the OK (1) button in message boxes.
229
230       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
235   QUICK SWITCH
236       QuickSwitch=1
237           Enable Alt+Tab window switching.
238
239       QuickSwitchToMinimized=1
240           Enable Alt+Tab to minimized windows.
241
242       QuickSwitchToHidden=1
243           Enable Alt+Tab to hidden windows.
244
245       QuickSwitchToUrgent=1
246           Prioritize Alt+Tab to urgent windows.
247
248       QuickSwitchToAllWorkspaces=0
249           Include windows from all workspaces in Alt+Tab.
250
251       QuickSwitchGroupWorkspaces=1
252           Group windows by workspace together in Alt+Tab.
253
254       QuickSwitchRaiseCandidate=0
255           Raise a selected window while Alt+Tabbing in the QuickSwitch.
256
257       QuickSwitchAllIcons=1
258           Show all reachable icons when quick switching.
259
260       QuickSwitchTextFirst=0
261           Show the window title above (all reachable) icons.
262
263       QuickSwitchSmallWindow=0
264           Create a smaller QuickSwitch window of 1/3 screen width.
265
266       QuickSwitchMaxWidth=0
267           Go trough all window titles and choose width of the longest one.
268
269       QuickSwitchVertical=1
270           Place the icons and titles vertical instead of horizontal.
271
272       QuickSwitchHugeIcon=0
273           Show the huge (48x48) of the window icon for the active window.
274
275       QuickSwitchFillSelection=0
276           Fill the rectangle highlighting the current icon.
277
278   EDGE SWITCHING
279       EdgeSwitch=0
280           Workspace switches by moving mouse to left/right screen edge.
281
282       HorizontalEdgeSwitch=0
283           Workspace switches by moving mouse to left/right screen edge.
284
285       VerticalEdgeSwitch=0
286           Workspace switches by moving mouse to top/bottom screen edge.
287
288       ContinuousEdgeSwitch=1
289           Workspace switches continuously when moving mouse to screen edge.
290
291       EdgeResistance=32  [0-10000]
292           Resistance in pixels when trying to move windows off the screen
293           (10000 = infinite).
294
295   TASK BAR
296       The following preferences affect the icewm(1) task bar:
297
298       ShowTaskBar=1
299           Show task bar.
300
301       TaskBarAtTop=0
302           Task bar at top of the screen.
303
304       TaskBarKeepBelow=0
305           Keep the task bar below regular windows.
306
307       TaskBarAutoHide=0
308           Auto hide task bar after delay.
309
310       TaskBarFullscreenAutoShow=1
311           Auto show task bar when fullscreen window active.
312
313       TaskBarShowClock=1
314           Show clock on task bar.
315
316       TaskBarShowAPMStatus=0
317           Show battery status monitor on task bar.
318
319       TaskBarShowAPMAuto=1
320           Enable TaskBarShowAPMStatus if a battery is present.
321
322       TaskBarShowAPMTime=1
323           Show battery status on task bar in time-format
324
325       TaskBarShowAPMGraph=1
326           Show battery status in graph mode.
327
328       TaskBarShowMailboxStatus=1
329           Show mailbox status on task bar.
330
331       TaskBarMailboxStatusBeepOnNewMail=0
332           Beep when new mail arrives.
333
334       TaskBarMailboxStatusCountMessages=0
335           Count messages in mailbox.
336
337       TaskBarShowWorkspaces=1
338           Show workspace switching buttons on task bar.
339
340       TaskBarShowWindows=1
341           Show windows on the taskbar.
342
343       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
347       ShowEllipsis=1
348           Show Ellipsis in taskbar items.
349
350       TaskBarShowTray=1
351           Show windows in the tray.
352
353       TaskBarEnableSystemTray=1
354           Enable the system tray in the taskbar.
355
356       TrayShowAllWindows=1
357           Show windows from all workspaces on tray.
358
359       TaskBarShowTransientWindows=1
360           Show transient (dialogs, ...) windows on task bar.
361
362       TaskBarShowAllWindows=0
363           Show windows from all workspaces on task bar.
364
365       TaskBarShowWindowIcons=1
366           Show icons of windows on the task bar.
367
368       TaskBarShowStartMenu=1
369           Show 'Start' menu on task bar.
370
371       TaskBarShowWindowListMenu=1
372           Show 'window list' menu on task bar.
373
374       TaskBarShowCPUStatus=1
375           Show CPU status on task bar (Linux & Solaris).
376
377       CPUStatusShowRamUsage=1
378           Show RAM usage in CPU status tool tip.
379
380       CPUStatusShowSwapUsage=1
381           Show swap usage in CPU status tool tip.
382
383       CPUStatusShowAcpiTemp=1
384           Show ACPI temperature in CPU status tool tip.
385
386       CPUStatusShowAcpiTempInGraph=0
387           Show ACPI temperature in CPU status bar.
388
389       CPUStatusShowCpuFreq=1
390           Show CPU frequency in CPU status tool tip.
391
392       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
397       TaskBarShowMEMStatus=1
398           Show memory usage status on task bar (Linux only).
399
400       TaskBarShowNetStatus=1
401           Show network status on task bar (Linux only).
402
403       TaskBarShowCollapseButton=0
404           Show a button to collapse the taskbar.
405
406       TaskBarDoubleHeight=0
407           Use double-height task bar.
408
409       TaskBarWorkspacesLeft=1
410           Place workspace pager on left, not right.
411
412       TaskBarWorkspacesTop=0
413           Place workspace pager on top row when using dual-height taskbar.
414
415       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
422       TaskBarUseMouseWheel=1
423           Enable mouse wheel cycling over workspaces and task buttons in
424           taskbar.
425
426       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
432       PagerShowPreview=1
433           Show a mini desktop preview on each workspace button.
434
435       PagerShowWindowIcons=1
436           Draw window icons inside large enough preview windows on pager (if
437           PagerShowPreview=1).
438
439       PagerShowMinimized=1
440           Draw even minimized windows as unfilled rectangles (if
441           PagerShowPreview=1).
442
443       PagerShowBorders=1
444           Draw border around workspace buttons (if PagerShowPreview=1).
445
446       PagerShowLabels=1
447           Show workspace name label on workspace button (if
448           PagerShowPreview=1)
449
450       PagerShowNumbers=1
451           Show number of workspace on workspace button (if
452           PagerShowPreview=1).
453
454       TaskBarLaunchOnSingleClick=1
455           Execute taskbar applet commands (like MailCommand, ClockCommand,
456           ...) on single click.
457
458       EnableAddressBar=1
459           Enable address bar functionality in taskbar.
460
461       ShowAddressBar=1
462           Show address bar in task bar.
463
464       MultiByte=1
465           Overrides automatic multiple byte detection.
466
467       ConfirmLogout=1
468           Confirm logout.
469
470       ShapesProtectClientWindow=1
471           Don't cut client windows by shapes set trough frame corner pixmap.
472
473       DoubleBuffer=1
474           Use double buffering when redrawing the display.
475
476       XRRDisable=1
477           Disable use of new XRANDR API for dual head (nvidia workaround).
478
479       PreferFreetypeFonts=1
480           Favour Xft fonts over core X11 fonts where possible.
481
482       MailBoxPath=""
483           Mailbox path (use \$MAIL instead).
484
485           Path to a mbox file. Remote mail boxes are accessed by specifying
486           an URL using the Common Internet Scheme Syntax (RFC 1738):
487
488               `scheme://[user[:password]@]server[:port][/path]`.
489
490           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
497               file:///var/spool/mail/captnmark
498               pop3://markus:%2f%40%3a@maol.ch/
499               imap://mathias@localhost/INBOX.Maillisten.icewm-user
500
501       NetworkStatusDevice="eth0 wlan0"
502           Network device for which to show status.
503
504       TimeFormat="%X"
505           Clock Time format (strftime format string).
506
507       TimeFormatAlt=""
508           Alternate Clock Time format (e.g., for blinking effects).
509
510       DateFormat="%c"
511           Clock Date format for tooltip (strftime format string).
512
513       XRRPrimaryScreenName=""
514           Screen/output name of the primary screen.
515
516       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
521       TaskBarCPUSamples=20  [2-1000]
522           The width of the CPU Monitor applet in pixels.
523
524       TaskBarMEMSamples=20  [2-1000]
525           The width of the Memory Monitor applet in pixels.
526
527       TaskBarNetSamples=20  [2-1000]
528           The width of the Net Monitor applet in pixels.
529
530       TaskbarButtonWidthDivisor=3  [1-25]
531           Default number of tasks in taskbar.
532
533       TaskBarWidthPercentage=100  [0-100]
534           Task bar width as percentage of the screen width.
535
536       TaskBarJustify="left"
537           Taskbar justify left, right or center.
538
539       TaskBarApmGraphWidth=10  [1-1000]
540           Width of battery Monitor.
541
542       TaskBarGraphHeight=20  [16-1000]
543           Height of taskbar monitoring applets.
544
545       XineramaPrimaryScreen=0  [0-63]
546           Primary screen for xinerama (taskbar, ...).
547
548       TaskbuttonIconOffset=0 # [0-16]
549           Width of taskbutton side icons.
550
551       TrayIconMaxWidth=32 # [16-128]
552           Maximum scaled width of tray icons.
553
554       TrayIconMaxHeight=24 # [16-128]
555           Maximum scaled height of tray icons.
556
557       TrayDrawBevel=0 # 0/1
558           Surround the tray with plastic border.
559
560       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
570   MENUS
571       AutoReloadMenus=1
572           Reload menu files automatically.
573
574       ShowProgramsMenu=0
575           Show programs submenu.
576
577       ShowSettingsMenu=1
578           Show settings submenu.
579
580       ShowFocusModeMenu=1
581           Show focus mode submenu.
582
583       ShowThemesMenu=1
584           Show themes submenu.
585
586       ShowLogoutMenu=1
587           Show logout menu.
588
589       ShowHelp=1
590           Show the help menu item.
591
592       ShowLogoutSubMenu=1
593           Show logout submenu.
594
595       ShowAbout=1
596           Show the about menu item.
597
598       ShowRun=1
599           Show the run menu item.
600
601       ShowWindowList=1
602           Show the window menu item.
603
604       MenuMaximalWidth=0  [0-16384]
605           Maximal width of popup menus,  2/3 of the screen's width if set to
606           zero.
607
608       NestedThemeMenuMinNumber=25  [0-1234]
609           Minimal number of themes after which the Themes menu becomes nested
610           (0=disabled).
611
612   TIMINGS
613       DelayFuzziness=10  (0-100)
614           Delay fuzziness, to allow merging of multiple timer timeouts into
615           one (notebook power saving).
616
617       ClickMotionDistance=4  [0-32]
618           Pointer motion distance before click gets interpreted as drag.
619
620       ClickMotionDelay=200  [0-2000]
621           Delay before click gets interpreted as drag.
622
623       MultiClickTime=400  [0-5000]
624           Multiple click time.
625
626       MenuActivateDelay=40  [0-5000]
627           Delay before activating menu items.
628
629       SubmenuMenuActivateDelay=300  [0-5000]
630           Delay before activating menu submenus.
631
632       ToolTipDelay=1000  [0-5000]
633           Delay before tooltip window is displayed.
634
635       ToolTipTime=0  [0-60000]
636           Time before tooltip window is hidden (0 means never.
637
638       AutoHideDelay=300  [0-5000]
639           Delay before task bar is hidden.
640
641       AutoShowDelay=500  [0-5000]
642           Delay before task bar is shown.
643
644       AutoRaiseDelay=400  [0-5000]
645           Delay before windows are auto raised if "AutoRaise=1".
646
647       PointerFocusDelay=200  [0-1000]
648           Delay for pointer focus switching.
649
650       EdgeSwitchDelay=600  [0-5000]
651           Screen edge workspace switching delay.
652
653       ScrollBarStartDelay=500  [0-5000]
654           Initial scroll bar autoscroll delay.
655
656       ScrollBarDelay=30  [0-5000]
657           Scroll bar autoscroll delay.
658
659       AutoScrollStartDelay=500  [0-5000]
660           Auto scroll start delay.
661
662       AutoScrollDelay=60  [0-5000]
663           Auto scroll delay.
664
665       WorkspaceStatusTime=2500  [0-2500]
666           Time before workspace status window is hidden.
667
668       MailCheckDelay=30  [0-86400]
669           Delay between new-mail checks. (seconds).
670
671       TaskBarCPUDelay=500  [10-3600000]
672           Delay between CPU Monitor samples in ms.
673
674       TaskBarMEMDelay=500  [10-3600000]
675           Delay between Memory Monitor samples in ms.
676
677       TaskBarNetDelay=500  [10-3600000]
678           Delay between Net Monitor samples in ms.
679
680       FocusRequestFlashTime=0  [0-86400]
681           Number of seconds the taskbar app will blink when requesting focus
682           (0 = forever).
683
684       FocusRequestFlashInterval=250  [0-30000]
685           Taskbar blink interval (ms) when requesting focus (0 = blinking
686           disabled).
687
688       BatteryPollingPeriod=10  [2-3600]
689           Delay between power status updates (seconds).
690
691   BUTTONS AND KEYS
692       UseRootButtons=255  [0-255]
693           Bitmask of root window button click to use in window manager.
694
695       ButtonRaiseMask=1  [0-255]
696           Bitmask of buttons that raise the window when pressed.
697
698       DesktopWinMenuButton=0  [0-20]
699           Desktop mouse-button click to show the window list menu.
700
701       DesktopWinListButton=2 # [0-20]
702           Desktop mouse-button click to show the window list
703
704       DesktopMenuButton=3  [0-20]
705           Desktop mouse-button click to show the root menu.
706
707       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
713       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
717   WORKSPACES
718       WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
719           Create four workspaces with names  1 ,  2 ,  3  and  4 .
720
721   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
726       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
732       MailBoxPath=""
733           Mailbox path (use \$MAIL instead).
734
735   PROGRAMS
736       MailCommand="xterm -name mutt -e mutt"
737           Command to run on mailbox.
738
739       MailClassHint="mutt.XTerm"
740           WM_CLASS to allow runonce for MailCommand.
741
742       NewMailCommand=""
743           Command to run when new mail arrives.
744
745       LockCommand=""
746           Command to lock display/screensaver.
747
748       ClockCommand="xclock -name icewm -title Clock"
749           Command to run on clock.
750
751       ClockClassHint="icewm.XClock"
752           WM_CLASS to allow runonce for ClockCommand.
753
754       RunCommand=""
755           Command to select and run a program.
756
757       OpenCommand=""
758           Open command.
759
760       TerminalCommand="xterm"
761           Terminal emulator must accept -e option.
762
763       LogoutCommand=""
764           Command to start logout.
765
766       LogoutCancelCommand=""
767           Command to cancel logout.
768
769       ShutdownCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
770       poweroff; } ||:""
771           Command to shutdown the system.
772
773       RebootCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
774       reboot; } ||:""
775           Command to reboot the system.
776
777       SuspendCommand="test -e /run/systemd/system && systemctl suspend"
778           Command to send the system to standby mode
779
780       CPUStatusCommand="xterm -name top -title Process\ Status -e top"
781           Command to run on CPU status.
782
783       CPUStatusClassHint="top.XTerm"
784           WM_CLASS to allow runonce for CPUStatusCommand.
785
786       CPUStatusCombine=1  0/1
787           Combine all CPUs to one.
788
789       NetStatusCommand="xterm -name netstat -title 'Network Status' -e
790       netstat -c"
791           Command to run on Net status.
792
793       NetStatusClassHint="netstat.XTerm"
794           WM_CLASS to allow runonce for NetStatusCommand.
795
796       AddressBarCommand=""
797           Command to run for address bar entries.
798
799   WINDOW MENUS
800       WinMenuItems="rmsnxfhualyticw"
801           Items supported in menu window (rmsnxfhualytickw)
802
803       RolloverButtonsSupported=0
804           Does it support the 'O' title bar button images (for mouse
805           rollover).
806
807       ShowMenuButtonIcon=1 # 0/1
808           Show application icon over menu button
809
810   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
817       THEME DESCRIPTION
818
819       ThemeAuthor=""
820           Theme author, e-mail address, credits.
821
822       ThemeDescription=""
823           Description of the theme, credits.
824
825       Look="nice"
826           Choose a theme look from one of: "win95", "motif", "warp3",
827           "warp4", "nice", "metal2", "gtk2", and some others.
828
829       Gradients=""
830           List of gradient pixmaps in the current theme.
831
832       THEME BORDERS, ICONS, MARGINS AND BUTTONS
833
834       BorderSizeX=6  [0-128]
835           Horizontal window border.
836
837       BorderSizeY=6  [0-128]
838           Vertical window border.
839
840       DlgBorderSizeX=2  [0-128]
841           Horizontal dialog window border.
842
843       DlgBorderSizeY=2  [0-128]
844           Vertical dialog window border.
845
846       CornerSizeX=24  [0-64]
847           Resize corner width.
848
849       CornerSizeY=24  [0-64]
850           Resize corner height.
851
852       TitleBarHeight=20  [0-128]
853           Title bar height.
854
855       TitleBarJustify=0  [0-100]
856           Justification of the window title.
857
858       TitleBarHorzOffset=0  [-128-128]
859           Horizontal offset for the window title text.
860
861       TitleBarVertOffset=0  [-128-128]
862           Vertical offset for the window title text.
863
864       MenuButtonIconVertOffset=0  [-128-128]
865           Vertical offset for the menu button icon.
866
867       ScrollBarX=16  [0-64]
868           Scrollbar width.
869
870       ScrollBarY=16  [0-64]
871           Scrollbar (button) height.
872
873       MenuIconSize=16  [8-128]
874           Menu icon size.
875
876       SmallIconSize=16  [8-128]
877           Dimension of the small icons.
878
879       LargeIconSize=32  [8-128]
880           Dimension of the large icons.
881
882       HugeIconSize=48  [8-128]
883           Dimension of the large icons.
884
885       QuickSwitchHorzMargin=3  [0-64]
886           Horizontal margin of the quickswitch window.
887
888       QuickSwitchVertMargin=3  [0-64]
889           Vertical margin of the quickswitch window.
890
891       QuickSwitchIconMargin=4  [0-64]
892           Vertical margin in the quickswitch window.
893
894       QuickSwitchIconBorder=2  [0-64]
895           Distance between the active icon and it's border.
896
897       QuickSwitchSeparatorSize=6  [0-64]
898           Height of the separator between (all reachable) icons and text, 0
899           to avoid it.
900
901       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
905       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
909       TitleButtonsSupported="xmis"
910           Titlebar buttons supported by theme (x,m,i,r,h,s,d).
911
912       TitleBarCentered=0 # 0/1
913           Draw window title centered (obsoleted by TitleBarJustify).
914
915       TitleBarJoinLeft=0 # 0/1
916           Join title*S and title*T.
917
918       TitleBarJoinRight=0 # 0/1
919           Join title*T and title*B.
920
921       THEME FONTS
922
923       TitleFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
924       TitleFontNameXft="sans-serif:size=12"
925           Name of the title bar font.
926
927       MenuFontName="-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"
928       MenuFontNameXft="sans-serif:size=10:bold"
929           Name of the menu font.
930
931       StatusFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
932       StatusFontNameXft="monospace:size=12:bold"
933           Name of the status display font.
934
935       QuickSwitchFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
936       QuickSwitchFontNameXft="monospace:size=12:bold"
937           Name of the font for Alt+Tab switcher window.
938
939       NormalButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
940       NormalButtonFontNameXft="sans-serif:size=12"
941           Name of the normal button font.
942
943       ActiveButtonFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
944       ActiveButtonFontNameXft="sans-serif:size=12:bold"
945           Name of the active button font.
946
947       NormalTaskBarFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
948       NormalTaskBarFontNameXft="sans-serif:size=12"
949           Name of the normal task bar item font.
950
951       ActiveTaskBarFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
952       ActiveTaskBarFontNameXft="sans-serif:size=12:bold"
953           Name of the active task bar item font.
954
955       ToolButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
956       ToolButtonFontNameXft="sans-serif:size=12"
957           Name of the tool button font (fallback: NormalButtonFontName).
958
959       NormalWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
960       NormalWorkspaceFontNameXft="sans-serif:size=12"
961           Name of the normal workspace button font (fallback:
962           NormalButtonFontName).
963
964       ActiveWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
965       ActiveWorkspaceFontNameXft="sans-serif:size=12"
966           Name of the active workspace button font (fallback:
967           ActiveButtonFontName).
968
969       MinimizedWindowFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
970       MinimizedWindowFontNameXft="sans-serif:size=12"
971           Name of the mini-window font.
972
973       ListBoxFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
974       ListBoxFontNameXft="sans-serif:size=12"
975           Name of the window list font.
976
977       ToolTipFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
978       ToolTipFontNameXft="sans-serif:size=12"
979           Name of the tool tip font.
980
981       ClockFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
982       ClockFontNameXft="monospace:size=12"
983           Name of the task bar clock font.
984
985       TempFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
986       TempFontNameXft="monospace:size=12"
987           Name of the task bar temperature font.
988
989       ApmFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
990       ApmFontNameXft="monospace:size=12"
991           Name of the task bar battery font.
992
993       InputFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
994       InputFontNameXft="monospace:size=12"
995           Name of the input field font.
996
997       LabelFontName="-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"
998       LabelFontNameXft="sans-serif:size=12"
999           Name of the label font.
1000
1001       THEME COLORS
1002
1003       ColorDialog = "rgb:C0/C0/C0"
1004           Background of dialog windows.
1005
1006       ColorNormalBorder = "rgb:C0/C0/C0"
1007           Border of inactive windows.
1008
1009       ColorActiveBorder = "rgb:C0/C0/C0"
1010           Border of active windows.
1011
1012       ColorNormalButton = "rgb:C0/C0/C0"
1013           Background of regular buttons.
1014
1015       ColorNormalButtonText = "rgb:00/00/00"
1016           Text color of regular buttons.
1017
1018       ColorActiveButton = "rgb:E0/E0/E0"
1019           Background of pressed buttons.
1020
1021       ColorActiveButtonText = "rgb:00/00/00"
1022           Text color of pressed buttons.
1023
1024       ColorNormalTitleButton = "rgb:C0/C0/C0"
1025           Background of titlebar buttons.
1026
1027       ColorNormalTitleButtonText = "rgb:00/00/00"
1028           Text color of titlebar buttons.
1029
1030       ColorToolButton = ""
1031           Background of toolbar buttons, ColorNormalButton is used if empty.
1032
1033       ColorToolButtonText = ""
1034           Text color of toolbar buttons, ColorNormalButtonText is used if
1035           empty.
1036
1037       ColorNormalWorkspaceButton = ""
1038           Background of workspace buttons, ColorNormalButton is used if
1039           empty.
1040
1041       ColorNormalWorkspaceButtonText = ""
1042           Text color of workspace buttons, ColorNormalButtonText is used if
1043           empty.
1044
1045       ColorActiveWorkspaceButton = ""
1046           Background of the active workspace button, ColorActiveButton is
1047           used if empty.
1048
1049       ColorActiveWorkspaceButtonText = ""
1050           Text color of the active workspace button, ColorActiveButtonText is
1051           used if empty.
1052
1053       ColorNormalTitleBar = "rgb:80/80/80"
1054           Background of the titlebar of regular windows.
1055
1056       ColorNormalTitleBarText = "rgb:00/00/00"
1057           Text color of the titlebar of regular windows.
1058
1059       ColorNormalTitleBarShadow = ""
1060           Text shadow of the titlebar of regular windows.
1061
1062       ColorActiveTitleBar = "rgb:00/00/A0"
1063           Background of the titlebar of active windows.
1064
1065       ColorActiveTitleBarText = "rgb:FF/FF/FF"
1066           Text color of the titlebar of active windows.
1067
1068       ColorActiveTitleBarShadow = ""
1069           Text shadow of the titlebar of active windows.
1070
1071       ColorNormalMinimizedWindow = "rgb:C0/C0/C0"
1072           Background for mini icons of regular windows.
1073
1074       ColorNormalMinimizedWindowText = "rgb:00/00/00"
1075           Text color for mini icons of regular windows.
1076
1077       ColorActiveMinimizedWindow = "rgb:E0/E0/E0"
1078           Background for mini icons of active windows.
1079
1080       ColorActiveMinimizedWindowText = "rgb:00/00/00"
1081           Text color for mini icons of active windows.
1082
1083       ColorNormalMenu = "rgb:C0/C0/C0"
1084           Background of pop-up menus.
1085
1086       ColorNormalMenuItemText = "rgb:00/00/00"
1087           Text color of regular menu items.
1088
1089       ColorActiveMenuItem = "rgb:A0/A0/A0"
1090           Background of selected menu item, leave empty to force
1091           transparency.
1092
1093       ColorActiveMenuItemText = "rgb:00/00/00"
1094           Text color of selected menu items.
1095
1096       ColorDisabledMenuItemText = "rgb:80/80/80"
1097           Text color of disabled menu items.
1098
1099       ColorDisabledMenuItemShadow = ""
1100           Shadow of regular menu items.
1101
1102       ColorMoveSizeStatus = "rgb:C0/C0/C0"
1103           Background of move/resize status window.
1104
1105       ColorMoveSizeStatusText = "rgb:00/00/00"
1106           Text color of move/resize status window.
1107
1108       ColorQuickSwitch = "rgb:C0/C0/C0"
1109           Background of the quick switch window.
1110
1111       ColorQuickSwitchText = "rgb:00/00/00"
1112           Text color in the quick switch window.
1113
1114       ColorQuickSwitchActive = ""
1115           Rectangle around the active icon in the quick switch window.
1116
1117       ColorDefaultTaskBar = "rgb:C0/C0/C0"
1118           Background of the taskbar.
1119
1120       ColorNormalTaskBarApp = "rgb:C0/C0/C0"
1121           Background for task buttons of regular windows.
1122
1123       ColorNormalTaskBarAppText = "rgb:00/00/00"
1124           Text color for task buttons of regular windows.
1125
1126       ColorActiveTaskBarApp = "rgb:E0/E0/E0"
1127           Background for task buttons of the active window.
1128
1129       ColorActiveTaskBarAppText = "rgb:00/00/00"
1130           Text color for task buttons of the active window.
1131
1132       ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"
1133           Background for task buttons of minimized windows.
1134
1135       ColorMinimizedTaskBarAppText = "rgb:00/00/00"
1136           Text color for task buttons of minimized windows.
1137
1138       ColorInvisibleTaskBarApp = "rgb:80/80/80"
1139           Background for task buttons of windows on other workspaces.
1140
1141       ColorInvisibleTaskBarAppText = "rgb:00/00/00"
1142           Text color for task buttons of windows on other workspaces.
1143
1144       ColorScrollBar = "rgb:A0/A0/A0"
1145           Scrollbar background (sliding area).
1146
1147       ColorScrollBarSlider = "rgb:C0/C0/C0"
1148           Background of the slider button in scrollbars.
1149
1150       ColorScrollBarButton = "rgb:C0/C0/C0"
1151           Background of the arrow buttons in scrollbars.
1152
1153       ColorScrollBarArrow = "rgb:C0/C0/C0"
1154           Background of the arrow buttons in scrollbars (obsolete).
1155
1156       ColorScrollBarButtonArrow = "rgb:00/00/00"
1157           Color of active arrows on scrollbar buttons.
1158
1159       ColorScrollBarInactiveArrow = "rgb:80/80/80"
1160           Color of inactive arrows on scrollbar buttons.
1161
1162       ColorListBox = "rgb:C0/C0/C0"
1163           Background of listboxes.
1164
1165       ColorListBoxText = "rgb:00/00/00"
1166           Text color in listboxes.
1167
1168       ColorListBoxSelection = "rgb:80/80/80"
1169           Background of selected listbox items.
1170
1171       ColorListBoxSelectionText = "rgb:00/00/00"
1172           Text color of selected listbox items.
1173
1174       ColorToolTip = "rgb:E0/E0/00"
1175           Background of tooltips.
1176
1177       ColorToolTipText = "rgb:00/00/00"
1178           Text color of tooltips.
1179
1180       ColorLabel = "rgb:C0/C0/C0"
1181           Background of labels, leave empty to force transparency.
1182
1183       ColorLabelText = "rgb:00/00/00"
1184           Text color of labels.
1185
1186       ColorInput = "rgb:FF/FF/FF"
1187           Background of text entry fields (e.g., the addressbar).
1188
1189       ColorInputText = "rgb:00/00/00"
1190           Text color of text entry fields (e.g., the addressbar).
1191
1192       ColorInputSelection = "rgb:80/80/80"
1193           Background of selected text in an entry field.
1194
1195       ColorInputSelectionText = "rgb:00/00/00"
1196           Selected text in an entry field.
1197
1198       ColorClock = "rgb:00/00/00"
1199           Background of non-LCD clock, leave empty to force transparency.
1200
1201       ColorClockText = "rgb:00/FF/00"
1202           Background of non-LCD monitor.
1203
1204       ColorApm = "rgb:00/00/00"
1205           Background of battery monitor, leave empty to force transparency.
1206
1207       ColorApmText = "rgb:00/FF/00"
1208           Text color of battery monitor.
1209
1210       ColorApmBattery = "rgb:FF/FF/00"
1211           Color of battery monitor when discharging.
1212
1213       ColorApmLine = "rgb:00/FF/00"
1214           Color of battery monitor when charging.
1215
1216       ColorApmGraphBg = "rgb:00/00/00"
1217           Background color for graph mode.
1218
1219       ColorCPUStatusUser = "rgb:00/FF/00"
1220           User load on the CPU monitor.
1221
1222       ColorCPUStatusSystem = "rgb:FF/00/00"
1223           System load on the CPU monitor.
1224
1225       ColorCPUStatusInterrupts = "rgb:FF/FF/00"
1226           Interrupts on the CPU monitor.
1227
1228       ColorCPUStatusIoWait = "rgb:60/00/60"
1229           IO Wait on the CPU monitor.
1230
1231       ColorCPUStatusSoftIrq = "rgb:00/FF/FF"
1232           Soft Interrupts on the CPU monitor.
1233
1234       ColorCPUStatusNice = "rgb:00/00/FF"
1235           Nice load on the CPU monitor.
1236
1237       ColorCPUStatusIdle = "rgb:00/00/00"
1238           Idle (non) load on the CPU monitor, leave empty to force
1239           transparency.
1240
1241       ColorCPUStatusSteal = "rgb:FF/8A/91"
1242           Involuntary Wait on the CPU monitor.
1243
1244       ColorCPUStatusTemp = "rgb:60/60/C0"
1245           Temperature of the CPU.
1246
1247       ColorMEMStatusUser = "rgb:40/40/80"
1248           User program usage in the memory monitor.
1249
1250       ColorMEMStatusBuffers = "rgb:60/60/C0"
1251           OS buffers usage in the memory monitor.
1252
1253       ColorMEMStatusCached = "rgb:80/80/FF"
1254           OS cached usage in the memory monitor.
1255
1256       ColorMEMStatusFree = "rgb:00/00/00"
1257           Free memory in the memory monitor.
1258
1259       ColorNetSend = "rgb:FF/FF/00"
1260           Outgoing load on the network monitor.
1261
1262       ColorNetReceive = "rgb:FF/00/FF"
1263           Incoming load on the network monitor.
1264
1265       ColorNetIdle = "rgb:00/00/00"
1266           Idle (non) load on the network monitor, leave empty to force
1267           transparency.
1268
1269       DesktopBackgroundColor=""
1270           Desktop background color(s).
1271
1272       DesktopTransparencyColor=""
1273           Color(s) to announce for semitransparent windows.
1274
1275       DESKTOP BACKGROUND
1276
1277       The following preferences are read by icewmbg(1):
1278
1279       DesktopBackgroundCenter=0  0/1
1280           Display desktop background centered and not tiled.
1281
1282       DesktopBackgroundScaled=0  0/1
1283           Resize desktop background to full screen.
1284
1285       DesktopBackgroundColor=""
1286           Desktop background color(s).
1287
1288       DesktopBackgroundImage=""
1289           Desktop background image(s).
1290
1291       SupportSemitransparency=1  0/1
1292           Support for semitransparent terminals like Eterm or gnome-terminal.
1293
1294       DesktopTransparencyColor=""
1295           Color(s) to announce for semitransparent windows.
1296
1297       DesktopTransparencyImage=""
1298           Image(s) to announce for semitransparent windows.
1299
1300       DesktopBackgroundMultihead=0  0/1
1301           Paint the background image over all multihead monitors combined.
1302

EXAMPLES

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
1327       The above example shows how to tell icewm to not bind a specific key:
1328       KeySysWinMenu in this case.
1329

FILES

1331       Locations for the preferences file are as follows:
1332
1333        $ICEWM_PRIVCFG/preferences
1334        $XDG_CONFIG_HOME/icewm/preferences
1335        $HOME/.icewm/preferences
1336        /etc/icewm/preferences
1337        /usr/share/icewm/preferences
1338
1339       The locations are searched in the order listed; the first file found is
1340       read and the remainder ignored.
1341

SEE ALSO

1343       icewm(1), icewm-prefoverride(5).
1344

AUTHOR

1346       Brian Bidulock <mailto:bidulock@openss7.org>.
1347

LICENSE

1349       IceWM is licensed under the GNU Library General Public License.  See
1350       the COPYING file in the distribution.
1351
1352
1353
1354icewm 2.3.0                       2021-04-02              ICEWM-PREFERENCES(5)
Impressum