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