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 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           Mailbox path (use \$MAIL instead).
490
491           Path to a mbox file. Remote mail boxes are accessed by specifying
492           an URL using the Common Internet Scheme Syntax (RFC 1738):
493
494               `scheme://[user[:password]@]server[:port][/path]`.
495
496           Supported schemes are "pop3", "imap" and "file".  When the scheme
497           is omitted file:// is prepended silently. IMAP subfolders can be
498           accessed by using the  path component.  Reserved characters like
499           slash ("/"), at ("@") and colon (":") can be specified using escape
500           sequences with a hexadecimal encoding like %2f for the slash or %40
501           for the at sign.  For example:
502
503               file:///var/spool/mail/captnmark
504               pop3://markus:%2f%40%3a@maol.ch/
505               imap://mathias@localhost/INBOX.Maillisten.icewm-user
506
507       NetworkStatusDevice="eth0 wlan0"
508           Network device for which to show status.
509
510       TimeFormat="%X"
511           Clock Time format (strftime format string).
512
513       TimeFormatAlt=""
514           Alternate Clock Time format (e.g., for blinking effects).
515
516       DateFormat="%c"
517           Clock Date format for tooltip (strftime format string).
518
519       XRRPrimaryScreenName=""
520           Screen/output name of the primary screen.
521
522       AcpiIgnoreBatteries=""
523           List of battery names (directories) in /proc/acpi/battery to
524           ignore.  Useful when more slots are built-in, but only one battery
525           is used.
526
527       TaskBarCPUSamples=20  [2-1000]
528           The width of the CPU Monitor applet in pixels.
529
530       TaskBarMEMSamples=20  [2-1000]
531           The width of the Memory Monitor applet in pixels.
532
533       TaskBarNetSamples=20  [2-1000]
534           The width of the Net Monitor applet in pixels.
535
536       TaskbarButtonWidthDivisor=3  [1-25]
537           Default number of tasks in taskbar.
538
539       TaskBarWidthPercentage=100  [0-100]
540           Task bar width as percentage of the screen width.
541
542       TaskBarJustify="left"
543           Taskbar justify left, right or center.
544
545       TaskBarApmGraphWidth=10  [1-1000]
546           Width of battery Monitor.
547
548       TaskBarGraphHeight=20  [16-1000]
549           Height of taskbar monitoring applets.
550
551       XineramaPrimaryScreen=0  [0-63]
552           Primary screen for xinerama (taskbar, ...).
553
554       TaskbuttonIconOffset=0 # [0-16]
555           Width of taskbutton side icons.
556
557       TrayIconMaxWidth=32 # [16-128]
558           Maximum scaled width of tray icons.
559
560       TrayIconMaxHeight=24 # [16-128]
561           Maximum scaled height of tray icons.
562
563       TrayDrawBevel=0 # 0/1
564           Surround the tray with plastic border.
565
566       KeyboardLayouts=""
567           A comma-separated list of keyboard layouts.  A layout may be
568           enclosed in double quotes.  Each layout is a name with optional
569           arguments, which is to be parsed by the "setxkbmap" program.  To
570           support changing keyboard layouts, the "setxkbmap" program must be
571           installed.  The first in the list is the default layout.  Programs
572           may have their own keyboard layout defined in the winoptions file.
573           The first two letters of a layout are used to locate an icon image
574           file.
575
576   MENUS
577       AutoReloadMenus=1
578           Reload menu files automatically.
579
580       ShowProgramsMenu=0
581           Show programs submenu.
582
583       ShowSettingsMenu=1
584           Show settings submenu.
585
586       ShowFocusModeMenu=1
587           Show focus mode submenu.
588
589       ShowThemesMenu=1
590           Show themes submenu.
591
592       ShowLogoutMenu=1
593           Show logout menu.
594
595       ShowHelp=1
596           Show the help menu item.
597
598       ShowLogoutSubMenu=1
599           Show logout submenu.
600
601       ShowAbout=1
602           Show the about menu item.
603
604       ShowRun=1
605           Show the run menu item.
606
607       ShowWindowList=1
608           Show the window menu item.
609
610       MenuMaximalWidth=0  [0-16384]
611           Maximal width of popup menus,  2/3 of the screen's width if set to
612           zero.
613
614       NestedThemeMenuMinNumber=25  [0-1234]
615           Minimal number of themes after which the Themes menu becomes nested
616           (0=disabled).
617
618   TIMINGS
619       DelayFuzziness=10  (0-100)
620           Delay fuzziness, to allow merging of multiple timer timeouts into
621           one (notebook power saving).
622
623       ClickMotionDistance=4  [0-32]
624           Pointer motion distance before click gets interpreted as drag.
625
626       ClickMotionDelay=200  [0-2000]
627           Delay before click gets interpreted as drag.
628
629       MultiClickTime=400  [0-5000]
630           Multiple click time.
631
632       MenuActivateDelay=40  [0-5000]
633           Delay before activating menu items.
634
635       SubmenuMenuActivateDelay=300  [0-5000]
636           Delay before activating menu submenus.
637
638       ToolTipDelay=1000  [0-5000]
639           Delay before tooltip window is displayed.
640
641       ToolTipTime=0  [0-60000]
642           Time before tooltip window is hidden (0 means never.
643
644       AutoHideDelay=300  [0-5000]
645           Delay before task bar is hidden.
646
647       AutoShowDelay=500  [0-5000]
648           Delay before task bar is shown.
649
650       AutoRaiseDelay=400  [0-5000]
651           Delay before windows are auto raised if "AutoRaise=1".
652
653       PointerFocusDelay=200  [0-1000]
654           Delay for pointer focus switching.
655
656       EdgeSwitchDelay=600  [0-5000]
657           Screen edge workspace switching delay.
658
659       ScrollBarStartDelay=500  [0-5000]
660           Initial scroll bar autoscroll delay.
661
662       ScrollBarDelay=30  [0-5000]
663           Scroll bar autoscroll delay.
664
665       AutoScrollStartDelay=500  [0-5000]
666           Auto scroll start delay.
667
668       AutoScrollDelay=60  [0-5000]
669           Auto scroll delay.
670
671       WorkspaceStatusTime=2500  [0-2500]
672           Time before workspace status window is hidden.
673
674       MailCheckDelay=30  [0-86400]
675           Delay between new-mail checks. (seconds).
676
677       TaskBarCPUDelay=500  [10-3600000]
678           Delay between CPU Monitor samples in ms.
679
680       TaskBarMEMDelay=500  [10-3600000]
681           Delay between Memory Monitor samples in ms.
682
683       TaskBarNetDelay=500  [10-3600000]
684           Delay between Net Monitor samples in ms.
685
686       FocusRequestFlashTime=0  [0-86400]
687           Number of seconds the taskbar app will blink when requesting focus
688           (0 = forever).
689
690       FocusRequestFlashInterval=250  [0-30000]
691           Taskbar blink interval (ms) when requesting focus (0 = blinking
692           disabled).
693
694       BatteryPollingPeriod=10  [2-3600]
695           Delay between power status updates (seconds).
696
697       PingTimeout=3  [0-86400]
698           Timeout in seconds for applications to respond to the _NET_WM_PING
699           protocol.
700
701   BUTTONS AND KEYS
702       UseRootButtons=255  [0-255]
703           Bitmask of root window button click to use in window manager.
704
705       ButtonRaiseMask=1  [0-255]
706           Bitmask of buttons that raise the window when pressed.
707
708       DesktopWinMenuButton=0  [0-20]
709           Desktop mouse-button click to show the window list menu.
710
711       DesktopWinListButton=2 # [0-20]
712           Desktop mouse-button click to show the window list
713
714       DesktopMenuButton=3  [0-20]
715           Desktop mouse-button click to show the root menu.
716
717       TitleBarMaximizeButton=1  [0-5]
718           Title bar mouse-button double click to maximize the window to full
719           screen with the frame border visible.  Press Shift to maximize only
720           in the vertical direction.  Press Alt+Shift to maximize only in the
721           horizontal direction.
722
723       TitleBarRollupButton=2  [0-5]
724           Title bar mouse-button double click to rollup the window.  Press
725           Shift to maximize in the horizontal direction.
726
727   WORKSPACES
728       WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "
729           Create four workspaces with names  1 ,  2 ,  3  and  4 .
730
731   PATHS
732       IconPath="/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps"
733           Icon search path (colon separated). Also, the icons/ subdirectory
734           in IceWM resource folders are searched first.
735
736       IconThemes="*:-HighContrast"
737           List of icon themes (colon separated), acting as additional filter
738           of icon subdirectories in any of the IconPath folders. Expressions
739           can be wildcards, also special wildcards (starting with -) can
740           exclude matched themes from selection.
741
742       MailBoxPath=""
743           Mailbox path (use \$MAIL instead).
744
745   PROGRAMS
746       MailCommand="xterm -name mutt -e mutt"
747           Command to run on mailbox.
748
749       MailClassHint="mutt.XTerm"
750           WM_CLASS to allow runonce for MailCommand.
751
752       NewMailCommand=""
753           Command to run when new mail arrives.
754
755       LockCommand=""
756           Command to lock display/screensaver.
757
758       ClockCommand="xclock -name icewm -title Clock"
759           Command to run on clock.
760
761       ClockClassHint="icewm.XClock"
762           WM_CLASS to allow runonce for ClockCommand.
763
764       RunCommand=""
765           Command to select and run a program.
766
767       OpenCommand=""
768           Open command.
769
770       TerminalCommand="xterm"
771           Terminal emulator must accept -e option.
772
773       LogoutCommand=""
774           Command to start logout.
775
776       LogoutCancelCommand=""
777           Command to cancel logout.
778
779       ShutdownCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
780       poweroff; } ||:""
781           Command to shutdown the system.
782
783       RebootCommand="/bin/sh -c "{ test -e /run/systemd/system && systemctl
784       reboot; } ||:""
785           Command to reboot the system.
786
787       SuspendCommand="test -e /run/systemd/system && systemctl suspend"
788           Command to send the system to standby mode
789
790       CPUStatusCommand="xterm -name top -title Process\ Status -e top"
791           Command to run on CPU status.
792
793       CPUStatusClassHint="top.XTerm"
794           WM_CLASS to allow runonce for CPUStatusCommand.
795
796       CPUStatusCombine=1  0/1
797           Combine all CPUs to one.
798
799       NetStatusCommand="xterm -name netstat -title 'Network Status' -e
800       netstat -c"
801           Command to run on Net status.
802
803       NetStatusClassHint="netstat.XTerm"
804           WM_CLASS to allow runonce for NetStatusCommand.
805
806       AddressBarCommand=""
807           Command to run for address bar entries.
808
809   WINDOW MENUS
810       WinMenuItems="rmsnxfhualyticw"
811           Items supported in menu window (rmsnxfhualytickw)
812
813       RolloverButtonsSupported=0
814           Does it support the 'O' title bar button images (for mouse
815           rollover).
816
817       ShowMenuButtonIcon=1 # 0/1
818           Show application icon over menu button
819
820   THEME SETTINGS
821       The following sections show settings that can be set in theme files.
822       They can also be set in the preferences file, but themes will override
823       the values set there.  To override the theme values, the settings
824       should be set in prefoverrides file: see icewm-prefoverrides(5).
825       Default values are shown following the equal sign.
826
827       THEME DESCRIPTION
828
829       ThemeAuthor=""
830           Theme author, e-mail address, credits.
831
832       ThemeDescription=""
833           Description of the theme, credits.
834
835       Look="nice"
836           Choose a theme look from one of: "win95", "motif", "warp3",
837           "warp4", "nice", "metal2", "gtk2", and some others.
838
839       Gradients=""
840           List of gradient pixmaps in the current theme.
841
842       THEME BORDERS, ICONS, MARGINS AND BUTTONS
843
844       BorderSizeX=6  [0-128]
845           Horizontal window border.
846
847       BorderSizeY=6  [0-128]
848           Vertical window border.
849
850       DlgBorderSizeX=2  [0-128]
851           Horizontal dialog window border.
852
853       DlgBorderSizeY=2  [0-128]
854           Vertical dialog window border.
855
856       CornerSizeX=24  [0-64]
857           Resize corner width.
858
859       CornerSizeY=24  [0-64]
860           Resize corner height.
861
862       TitleBarHeight=20  [0-128]
863           Title bar height.
864
865       TitleBarJustify=0  [0-100]
866           Justification of the window title.
867
868       TitleBarHorzOffset=0  [-128-128]
869           Horizontal offset for the window title text.
870
871       TitleBarVertOffset=0  [-128-128]
872           Vertical offset for the window title text.
873
874       MenuButtonIconVertOffset=0  [-128-128]
875           Vertical offset for the menu button icon.
876
877       ScrollBarX=16  [0-64]
878           Scrollbar width.
879
880       ScrollBarY=16  [0-64]
881           Scrollbar (button) height.
882
883       MenuIconSize=16  [8-128]
884           Menu icon size.
885
886       SmallIconSize=16  [8-128]
887           Dimension of the small icons.
888
889       LargeIconSize=32  [8-128]
890           Dimension of the large icons.
891
892       HugeIconSize=48  [8-128]
893           Dimension of the large icons.
894
895       QuickSwitchHorzMargin=3  [0-64]
896           Horizontal margin of the quickswitch window.
897
898       QuickSwitchVertMargin=3  [0-64]
899           Vertical margin of the quickswitch window.
900
901       QuickSwitchIconMargin=4  [0-64]
902           Vertical margin in the quickswitch window.
903
904       QuickSwitchIconBorder=2  [0-64]
905           Distance between the active icon and it's border.
906
907       QuickSwitchSeparatorSize=6  [0-64]
908           Height of the separator between (all reachable) icons and text, 0
909           to avoid it.
910
911       TitleButtonsLeft="s"
912           Titlebar buttons from left to right (x=close, m=max, i=min, h=hide,
913           r=rollup, s=sysmenu, d=depth).
914
915       TitleButtonsRight="xmir"
916           Titlebar buttons from right to left (x=close, m=max, i=min, h=hide,
917           r=rollup, s=sysmenu, d=depth).
918
919       TitleButtonsSupported="xmis"
920           Titlebar buttons supported by theme (x,m,i,r,h,s,d).
921
922       TitleBarCentered=0 # 0/1
923           Draw window title centered (obsoleted by TitleBarJustify).
924
925       TitleBarJoinLeft=0 # 0/1
926           Join title*S and title*T.
927
928       TitleBarJoinRight=0 # 0/1
929           Join title*T and title*B.
930
931       THEME FONTS
932
933       TitleFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
934       TitleFontNameXft="sans-serif:size=12"
935           Name of the title bar font.
936
937       MenuFontName="-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*"
938       MenuFontNameXft="sans-serif:size=10:bold"
939           Name of the menu font.
940
941       StatusFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
942       StatusFontNameXft="monospace:size=12:bold"
943           Name of the status display font.
944
945       QuickSwitchFontName="-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*"
946       QuickSwitchFontNameXft="monospace:size=12:bold"
947           Name of the font for Alt+Tab switcher window.
948
949       NormalButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
950       NormalButtonFontNameXft="sans-serif:size=12"
951           Name of the normal button font.
952
953       ActiveButtonFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
954       ActiveButtonFontNameXft="sans-serif:size=12:bold"
955           Name of the active button font.
956
957       NormalTaskBarFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
958       NormalTaskBarFontNameXft="sans-serif:size=12"
959           Name of the normal task bar item font.
960
961       ActiveTaskBarFontName="-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*"
962       ActiveTaskBarFontNameXft="sans-serif:size=12:bold"
963           Name of the active task bar item font.
964
965       ToolButtonFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
966       ToolButtonFontNameXft="sans-serif:size=12"
967           Name of the tool button font (fallback: NormalButtonFontName).
968
969       NormalWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
970       NormalWorkspaceFontNameXft="sans-serif:size=12"
971           Name of the normal workspace button font (fallback:
972           NormalButtonFontName).
973
974       ActiveWorkspaceFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
975       ActiveWorkspaceFontNameXft="sans-serif:size=12"
976           Name of the active workspace button font (fallback:
977           ActiveButtonFontName).
978
979       MinimizedWindowFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
980       MinimizedWindowFontNameXft="sans-serif:size=12"
981           Name of the mini-window font.
982
983       ListBoxFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
984       ListBoxFontNameXft="sans-serif:size=12"
985           Name of the window list font.
986
987       ToolTipFontName="-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*"
988       ToolTipFontNameXft="sans-serif:size=12"
989           Name of the tool tip font.
990
991       ClockFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
992       ClockFontNameXft="monospace:size=12"
993           Name of the task bar clock font.
994
995       TempFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
996       TempFontNameXft="monospace:size=12"
997           Name of the task bar temperature font.
998
999       ApmFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1000       ApmFontNameXft="monospace:size=12"
1001           Name of the task bar battery font.
1002
1003       InputFontName="-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*"
1004       InputFontNameXft="monospace:size=12"
1005           Name of the input field font.
1006
1007       LabelFontName="-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*"
1008       LabelFontNameXft="sans-serif:size=12"
1009           Name of the label font.
1010
1011       THEME COLORS
1012
1013       ColorDialog = "rgb:C0/C0/C0"
1014           Background of dialog windows.
1015
1016       ColorNormalBorder = "rgb:C0/C0/C0"
1017           Border of inactive windows.
1018
1019       ColorActiveBorder = "rgb:C0/C0/C0"
1020           Border of active windows.
1021
1022       ColorNormalButton = "rgb:C0/C0/C0"
1023           Background of regular buttons.
1024
1025       ColorNormalButtonText = "rgb:00/00/00"
1026           Text color of regular buttons.
1027
1028       ColorActiveButton = "rgb:E0/E0/E0"
1029           Background of pressed buttons.
1030
1031       ColorActiveButtonText = "rgb:00/00/00"
1032           Text color of pressed buttons.
1033
1034       ColorNormalTitleButton = "rgb:C0/C0/C0"
1035           Background of titlebar buttons.
1036
1037       ColorNormalTitleButtonText = "rgb:00/00/00"
1038           Text color of titlebar buttons.
1039
1040       ColorToolButton = ""
1041           Background of toolbar buttons, ColorNormalButton is used if empty.
1042
1043       ColorToolButtonText = ""
1044           Text color of toolbar buttons, ColorNormalButtonText is used if
1045           empty.
1046
1047       ColorNormalWorkspaceButton = ""
1048           Background of workspace buttons, ColorNormalButton is used if
1049           empty.
1050
1051       ColorNormalWorkspaceButtonText = ""
1052           Text color of workspace buttons, ColorNormalButtonText is used if
1053           empty.
1054
1055       ColorActiveWorkspaceButton = ""
1056           Background of the active workspace button, ColorActiveButton is
1057           used if empty.
1058
1059       ColorActiveWorkspaceButtonText = ""
1060           Text color of the active workspace button, ColorActiveButtonText is
1061           used if empty.
1062
1063       ColorNormalTitleBar = "rgb:80/80/80"
1064           Background of the titlebar of regular windows.
1065
1066       ColorNormalTitleBarText = "rgb:00/00/00"
1067           Text color of the titlebar of regular windows.
1068
1069       ColorNormalTitleBarShadow = ""
1070           Text shadow of the titlebar of regular windows.
1071
1072       ColorActiveTitleBar = "rgb:00/00/A0"
1073           Background of the titlebar of active windows.
1074
1075       ColorActiveTitleBarText = "rgb:FF/FF/FF"
1076           Text color of the titlebar of active windows.
1077
1078       ColorActiveTitleBarShadow = ""
1079           Text shadow of the titlebar of active windows.
1080
1081       ColorNormalMinimizedWindow = "rgb:C0/C0/C0"
1082           Background for mini icons of regular windows.
1083
1084       ColorNormalMinimizedWindowText = "rgb:00/00/00"
1085           Text color for mini icons of regular windows.
1086
1087       ColorActiveMinimizedWindow = "rgb:E0/E0/E0"
1088           Background for mini icons of active windows.
1089
1090       ColorActiveMinimizedWindowText = "rgb:00/00/00"
1091           Text color for mini icons of active windows.
1092
1093       ColorNormalMenu = "rgb:C0/C0/C0"
1094           Background of pop-up menus.
1095
1096       ColorNormalMenuItemText = "rgb:00/00/00"
1097           Text color of regular menu items.
1098
1099       ColorActiveMenuItem = "rgb:A0/A0/A0"
1100           Background of selected menu item, leave empty to force
1101           transparency.
1102
1103       ColorActiveMenuItemText = "rgb:00/00/00"
1104           Text color of selected menu items.
1105
1106       ColorDisabledMenuItemText = "rgb:80/80/80"
1107           Text color of disabled menu items.
1108
1109       ColorDisabledMenuItemShadow = ""
1110           Shadow of regular menu items.
1111
1112       ColorMoveSizeStatus = "rgb:C0/C0/C0"
1113           Background of move/resize status window.
1114
1115       ColorMoveSizeStatusText = "rgb:00/00/00"
1116           Text color of move/resize status window.
1117
1118       ColorQuickSwitch = "rgb:C0/C0/C0"
1119           Background of the quick switch window.
1120
1121       ColorQuickSwitchText = "rgb:00/00/00"
1122           Text color in the quick switch window.
1123
1124       ColorQuickSwitchActive = ""
1125           Rectangle around the active icon in the quick switch window.
1126
1127       ColorDefaultTaskBar = "rgb:C0/C0/C0"
1128           Background of the taskbar.
1129
1130       ColorNormalTaskBarApp = "rgb:C0/C0/C0"
1131           Background for task buttons of regular windows.
1132
1133       ColorNormalTaskBarAppText = "rgb:00/00/00"
1134           Text color for task buttons of regular windows.
1135
1136       ColorActiveTaskBarApp = "rgb:E0/E0/E0"
1137           Background for task buttons of the active window.
1138
1139       ColorActiveTaskBarAppText = "rgb:00/00/00"
1140           Text color for task buttons of the active window.
1141
1142       ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"
1143           Background for task buttons of minimized windows.
1144
1145       ColorMinimizedTaskBarAppText = "rgb:00/00/00"
1146           Text color for task buttons of minimized windows.
1147
1148       ColorInvisibleTaskBarApp = "rgb:80/80/80"
1149           Background for task buttons of windows on other workspaces.
1150
1151       ColorInvisibleTaskBarAppText = "rgb:00/00/00"
1152           Text color for task buttons of windows on other workspaces.
1153
1154       ColorScrollBar = "rgb:A0/A0/A0"
1155           Scrollbar background (sliding area).
1156
1157       ColorScrollBarSlider = "rgb:C0/C0/C0"
1158           Background of the slider button in scrollbars.
1159
1160       ColorScrollBarButton = "rgb:C0/C0/C0"
1161           Background of the arrow buttons in scrollbars.
1162
1163       ColorScrollBarArrow = "rgb:C0/C0/C0"
1164           Background of the arrow buttons in scrollbars (obsolete).
1165
1166       ColorScrollBarButtonArrow = "rgb:00/00/00"
1167           Color of active arrows on scrollbar buttons.
1168
1169       ColorScrollBarInactiveArrow = "rgb:80/80/80"
1170           Color of inactive arrows on scrollbar buttons.
1171
1172       ColorListBox = "rgb:C0/C0/C0"
1173           Background of listboxes.
1174
1175       ColorListBoxText = "rgb:00/00/00"
1176           Text color in listboxes.
1177
1178       ColorListBoxSelection = "rgb:80/80/80"
1179           Background of selected listbox items.
1180
1181       ColorListBoxSelectionText = "rgb:00/00/00"
1182           Text color of selected listbox items.
1183
1184       ColorToolTip = "rgb:E0/E0/00"
1185           Background of tooltips.
1186
1187       ColorToolTipText = "rgb:00/00/00"
1188           Text color of tooltips.
1189
1190       ColorLabel = "rgb:C0/C0/C0"
1191           Background of labels, leave empty to force transparency.
1192
1193       ColorLabelText = "rgb:00/00/00"
1194           Text color of labels.
1195
1196       ColorInput = "rgb:FF/FF/FF"
1197           Background of text entry fields (e.g., the addressbar).
1198
1199       ColorInputText = "rgb:00/00/00"
1200           Text color of text entry fields (e.g., the addressbar).
1201
1202       ColorInputSelection = "rgb:80/80/80"
1203           Background of selected text in an entry field.
1204
1205       ColorInputSelectionText = "rgb:00/00/00"
1206           Selected text in an entry field.
1207
1208       ColorClock = "rgb:00/00/00"
1209           Background of non-LCD clock, leave empty to force transparency.
1210
1211       ColorClockText = "rgb:00/FF/00"
1212           Background of non-LCD monitor.
1213
1214       ColorApm = "rgb:00/00/00"
1215           Background of battery monitor, leave empty to force transparency.
1216
1217       ColorApmText = "rgb:00/FF/00"
1218           Text color of battery monitor.
1219
1220       ColorApmBattery = "rgb:FF/FF/00"
1221           Color of battery monitor when discharging.
1222
1223       ColorApmLine = "rgb:00/FF/00"
1224           Color of battery monitor when charging.
1225
1226       ColorApmGraphBg = "rgb:00/00/00"
1227           Background color for graph mode.
1228
1229       ColorCPUStatusUser = "rgb:00/FF/00"
1230           User load on the CPU monitor.
1231
1232       ColorCPUStatusSystem = "rgb:FF/00/00"
1233           System load on the CPU monitor.
1234
1235       ColorCPUStatusInterrupts = "rgb:FF/FF/00"
1236           Interrupts on the CPU monitor.
1237
1238       ColorCPUStatusIoWait = "rgb:60/00/60"
1239           IO Wait on the CPU monitor.
1240
1241       ColorCPUStatusSoftIrq = "rgb:00/FF/FF"
1242           Soft Interrupts on the CPU monitor.
1243
1244       ColorCPUStatusNice = "rgb:00/00/FF"
1245           Nice load on the CPU monitor.
1246
1247       ColorCPUStatusIdle = "rgb:00/00/00"
1248           Idle (non) load on the CPU monitor, leave empty to force
1249           transparency.
1250
1251       ColorCPUStatusSteal = "rgb:FF/8A/91"
1252           Involuntary Wait on the CPU monitor.
1253
1254       ColorCPUStatusTemp = "rgb:60/60/C0"
1255           Temperature of the CPU.
1256
1257       ColorMEMStatusUser = "rgb:40/40/80"
1258           User program usage in the memory monitor.
1259
1260       ColorMEMStatusBuffers = "rgb:60/60/C0"
1261           OS buffers usage in the memory monitor.
1262
1263       ColorMEMStatusCached = "rgb:80/80/FF"
1264           OS cached usage in the memory monitor.
1265
1266       ColorMEMStatusFree = "rgb:00/00/00"
1267           Free memory in the memory monitor.
1268
1269       ColorNetSend = "rgb:FF/FF/00"
1270           Outgoing load on the network monitor.
1271
1272       ColorNetReceive = "rgb:FF/00/FF"
1273           Incoming load on the network monitor.
1274
1275       ColorNetIdle = "rgb:00/00/00"
1276           Idle (non) load on the network monitor, leave empty to force
1277           transparency.
1278
1279       DesktopBackgroundColor=""
1280           Desktop background color(s).
1281
1282       DesktopTransparencyColor=""
1283           Color(s) to announce for semitransparent windows.
1284
1285       DESKTOP BACKGROUND
1286
1287       The following preferences are read by icewmbg(1):
1288
1289       DesktopBackgroundCenter=0  0/1
1290           Display desktop background centered and not tiled.
1291
1292       DesktopBackgroundScaled=0  0/1
1293           Resize desktop background to full screen.
1294
1295       DesktopBackgroundColor=""
1296           Desktop background color(s).
1297
1298       DesktopBackgroundImage=""
1299           Desktop background image(s).
1300
1301       SupportSemitransparency=1  0/1
1302           Support for semitransparent terminals like Eterm or gnome-terminal.
1303
1304       DesktopTransparencyColor=""
1305           Color(s) to announce for semitransparent windows.
1306
1307       DesktopTransparencyImage=""
1308           Image(s) to announce for semitransparent windows.
1309
1310       DesktopBackgroundMultihead=0  0/1
1311           Paint the background image over all multihead monitors combined.
1312

EXAMPLES

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

FILES

1341       Locations for the preferences file are as follows:
1342
1343        $ICEWM_PRIVCFG/preferences
1344        $XDG_CONFIG_HOME/icewm/preferences
1345        $HOME/.icewm/preferences
1346        /etc/icewm/preferences
1347        /usr/share/icewm/preferences
1348
1349       The locations are searched in the order listed; the first file found is
1350       read and the remainder ignored.
1351

SEE ALSO

1353       icewm(1), icewm-prefoverride(5).
1354

AUTHOR

1356       Brian Bidulock <mailto:bidulock@openss7.org>.
1357

LICENSE

1359       IceWM is licensed under the GNU Library General Public License.  See
1360       the COPYING file in the distribution.
1361
1362
1363
1364icewm 2.3.4                       2021-05-10              ICEWM-PREFERENCES(5)
Impressum