diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
commit | fc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch) | |
tree | ce1e3bce06471410239a6f41282e328770aa404a /upstream/mageia-cauldron/man5/icewm-preferences.5 | |
parent | Initial commit. (diff) | |
download | manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip |
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'upstream/mageia-cauldron/man5/icewm-preferences.5')
-rw-r--r-- | upstream/mageia-cauldron/man5/icewm-preferences.5 | 1508 |
1 files changed, 1508 insertions, 0 deletions
diff --git a/upstream/mageia-cauldron/man5/icewm-preferences.5 b/upstream/mageia-cauldron/man5/icewm-preferences.5 new file mode 100644 index 00000000..94bdd49e --- /dev/null +++ b/upstream/mageia-cauldron/man5/icewm-preferences.5 @@ -0,0 +1,1508 @@ +.\" -*- mode: troff; coding: utf-8 -*- +.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) +.\" +.\" Standard preamble: +.\" ======================================================================== +.de Sp \" Vertical space (when we can't use .PP) +.if t .sp .5v +.if n .sp +.. +.de Vb \" Begin verbatim text +.ft CW +.nf +.ne \\$1 +.. +.de Ve \" End verbatim text +.ft R +.fi +.. +.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. +.ie n \{\ +. ds C` "" +. ds C' "" +'br\} +.el\{\ +. ds C` +. ds C' +'br\} +.\" +.\" Escape single quotes in literal strings from groff's Unicode transform. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.\" +.\" If the F register is >0, we'll generate index entries on stderr for +.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index +.\" entries marked with X<> in POD. Of course, you'll have to process the +.\" output yourself in some meaningful fashion. +.\" +.\" Avoid warning from groff about undefined register 'F'. +.de IX +.. +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{\ +. if \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" +.. +. if !\nF==2 \{\ +. nr % 0 +. nr F 2 +. \} +. \} +.\} +.rr rF +.\" ======================================================================== +.\" +.IX Title "ICEWM-PREFERENCES 5" +.TH ICEWM-PREFERENCES 5 2023-12-28 "icewm 3.4.5" "Standards, Environments and Macros" +.\" For nroff, turn off justification. Always turn off hyphenation; it makes +.\" way too many mistakes in technical documents. +.if n .ad l +.nh +.SS NAME +.IX Subsection "NAME" +.Vb 1 +\& icewm\-preferences \- icewm preferences configuration file +.Ve +.SS SYNOPSIS +.IX Subsection "SYNOPSIS" +.Vb 5 +\& $ICEWM_PRIVCFG/preferences +\& $XDG_CONFIG_HOME/icewm/preferences +\& $HOME/.icewm/preferences +\& /etc/icewm/preferences +\& /usr/share/icewm/preferences +.Ve +.SS DESCRIPTION +.IX Subsection "DESCRIPTION" +Contains general settings like paths, colors and fonts, but also options +to control the \fBicewm\fR focus behaviour and the applets that are +started in the task bar. The \fBicewm\fR installation will provide a +default \fIpreferences\fR file, that can be copied to the \fBicewm\fR user +configuration directory and modified. +.SS FORMAT +.IX Subsection "FORMAT" +.SS "FOCUS AND BEHAVIOR" +.IX Subsection "FOCUS AND BEHAVIOR" +The following preferences affect focus and general behavior of +\&\fBicewm\fR\|(1): +.IP \fBAlpha\fR=0 4 +.IX Item "Alpha=0" +Use a 32\-bit visual for alpha blending +.IP \fBSynchronize\fR=0 4 +.IX Item "Synchronize=0" +Synchronize X11 for debugging (slow) +.IP \fBLogEvents\fR=0 4 +.IX Item "LogEvents=0" +Enable event logging for debugging +.IP "\fBOutputFile\fR=""""" 4 +.IX Item "OutputFile=""""" +Redirect all output to \fIFILE\fR. +A leading tilde or environment variable is expanded. +This file is truncated on startup if it exceeds 5 KB. +.IP "\fBSplash\fR=""""" 4 +.IX Item "Splash=""""" +Splash image on startup (IceWM.jpg) +.IP "\fBTrace\fR=""""" 4 +.IX Item "Trace=""""" +Enable tracing for the given list of modules. +Modules that are traceable include \fBconf, font, icon, prog, systray\fR. +.IP \fBClickToFocus\fR=1 4 +.IX Item "ClickToFocus=1" +Focus windows by clicking in them. +.IP \fBFocusOnAppRaise\fR=0 4 +.IX Item "FocusOnAppRaise=0" +Focus windows when applications request that they be raised. +.IP \fBRequestFocusOnAppRaise\fR=1 4 +.IX Item "RequestFocusOnAppRaise=1" +Request focus (flashing in taskbar) when application requests raise. +.IP \fBRaiseOnFocus\fR=1 4 +.IX Item "RaiseOnFocus=1" +Raise windows when focused. +.IP \fBFocusOnClickClient\fR=1 4 +.IX Item "FocusOnClickClient=1" +Focus window when client area clicked. +.IP \fBRaiseOnClickClient\fR=1 4 +.IX Item "RaiseOnClickClient=1" +Raise window when client area clicked. +.IP \fBRaiseOnClickTitleBar\fR=1 4 +.IX Item "RaiseOnClickTitleBar=1" +Raise window when title bar is clicked. +.IP \fBRaiseOnClickButton\fR=1 4 +.IX Item "RaiseOnClickButton=1" +Raise window when frame button is clicked. +.IP \fBRaiseOnClickFrame\fR=1 4 +.IX Item "RaiseOnClickFrame=1" +Raise window when frame border is clicked. +.IP \fBLowerOnClickWhenRaised\fR=0 4 +.IX Item "LowerOnClickWhenRaised=0" +Lower the active window when clicked again. +.IP \fBPassFirstClickToClient\fR=1 4 +.IX Item "PassFirstClickToClient=1" +Pass focusing click on client area to client. +.IP \fBFocusChangesWorkspace\fR=0 4 +.IX Item "FocusChangesWorkspace=0" +Change to the workspace of newly focused windows. +.IP \fBFocusCurrentWorkspace\fR=0 4 +.IX Item "FocusCurrentWorkspace=0" +Move newly focused windows to current workspace. +.IP \fBFocusOnMap\fR=1 4 +.IX Item "FocusOnMap=1" +Focus normal window when initially mapped. +.IP \fBFocusOnMapTransient\fR=0 4 +.IX Item "FocusOnMapTransient=0" +Focus dialog window when initially mapped. +.IP \fBFocusOnMapTransientActive\fR=1 4 +.IX Item "FocusOnMapTransientActive=1" +Focus dialog window when initially mapped only if parent frame focused. +.IP \fBMapInactiveOnTop\fR=1 4 +.IX Item "MapInactiveOnTop=1" +Put new windows on top even if not focusing them. +.IP \fBPointerColormap\fR=1 4 +.IX Item "PointerColormap=1" +Colormap focus follows pointer. +.IP \fBDontRotateMenuPointer\fR=1 4 +.IX Item "DontRotateMenuPointer=1" +Don't rotate the cursor for popup menus. +.IP \fBLimitSize\fR=1 4 +.IX Item "LimitSize=1" +Limit size of windows to screen. +.IP \fBLimitPosition\fR=1 4 +.IX Item "LimitPosition=1" +Limit position of windows to screen. +.IP \fBLimitByDockLayer\fR=0 4 +.IX Item "LimitByDockLayer=0" +Let the Dock layer limit the workspace (incompatible with GNOME Panel). +.IP \fBConsiderHBorder\fR=0 4 +.IX Item "ConsiderHBorder=0" +Consider border frames when maximizing horizontally. +.IP \fBConsiderVBorder\fR=0 4 +.IX Item "ConsiderVBorder=0" +Consider border frames when maximizing vertically. +.IP \fBConsiderSizeHintsMaximized\fR=1 4 +.IX Item "ConsiderSizeHintsMaximized=1" +Consider XSizeHints if frame is maximized. +Turning this off allows the titlebar to cover the width of the screen. +.IP \fBCenterMaximizedWindows\fR=0 4 +.IX Item "CenterMaximizedWindows=0" +Center maximized windows that can't fit the screen (like terminals). +.IP \fBHideBordersMaximized\fR=0 4 +.IX Item "HideBordersMaximized=0" +Hide window borders if window is maximized. +.IP \fBSizeMaximized\fR=0 4 +.IX Item "SizeMaximized=0" +Maximized windows can be resized. +.IP \fBShowMoveSizeStatus\fR=1 4 +.IX Item "ShowMoveSizeStatus=1" +Show position status window during move/resize. +.IP \fBShowWorkspaceStatus\fR=1 4 +.IX Item "ShowWorkspaceStatus=1" +Show name of current workspace while switching. +.IP \fBMinimizeToDesktop\fR=0 4 +.IX Item "MinimizeToDesktop=0" +Display mini-icons on desktop for minimized windows. +.IP \fBMiniIconsPlaceHorizontal\fR=0 4 +.IX Item "MiniIconsPlaceHorizontal=0" +Place the mini-icons horizontal instead of vertical. +.IP \fBMiniIconsRightToLeft\fR=0 4 +.IX Item "MiniIconsRightToLeft=0" +Place new mini-icons from right to left. +.IP \fBMiniIconsBottomToTop\fR=0 4 +.IX Item "MiniIconsBottomToTop=0" +Place new mini-icons from bottom to top. +.IP \fBStrongPointerFocus\fR=0 4 +.IX Item "StrongPointerFocus=0" +Always maintain focus under mouse window. Makes some keyboard support +non-functional or unreliable. +.IP \fBOpaqueMove\fR=1 4 +.IX Item "OpaqueMove=1" +Opaque window move. +.IP \fBOpaqueResize\fR=1 4 +.IX Item "OpaqueResize=1" +Opaque window resize. +.IP \fBManualPlacement\fR=0 4 +.IX Item "ManualPlacement=0" +Windows initially placed manually by user. +.IP \fBSmartPlacement\fR=1 4 +.IX Item "SmartPlacement=1" +Smart window placement (minimal overlap). +.IP \fBHideTitleBarWhenMaximized\fR=0 4 +.IX Item "HideTitleBarWhenMaximized=0" +Hide title bar when maximized. +.IP \fBCenterLarge\fR=0 4 +.IX Item "CenterLarge=0" +Center large windows. +.IP \fBCenterTransientsOnOwner\fR=1 4 +.IX Item "CenterTransientsOnOwner=1" +Center dialogs on owner window. +.IP \fBMenuMouseTracking\fR=0 4 +.IX Item "MenuMouseTracking=0" +Menus track mouse even with no mouse buttons held. +.IP \fBAutoRaise\fR=0 4 +.IX Item "AutoRaise=0" +Raise windows when the mouse pointer enters, after a delay of +\&\fIAutoRaiseDelay\fR milliseconds. Note that \f(CW\*(C`RaiseOnFocus=1\*(C'\fR +may interfere. +.IP \fBDelayPointerFocus\fR=1 4 +.IX Item "DelayPointerFocus=1" +Delay pointer focusing when mouse moves. +.IP \fBWin95Keys\fR=1 4 +.IX Item "Win95Keys=1" +Support the Windows/Super key modifier to activate special functions. +The left Super key toggles the Start menu, while the right Super key +toggles the Window list window. +.IP \fBModSuperIsCtrlAlt\fR=0 4 +.IX Item "ModSuperIsCtrlAlt=0" +Treat the Super/Win key modifier as a synonym for the Ctrl+Alt modifier +combination. The default key bindings have many occurrences of Ctrl+Alt. +If you enable this, then the Super modifier is an alternative way to +activate them. +.IP \fBUseMouseWheel\fR=0 4 +.IX Item "UseMouseWheel=0" +Support mouse wheel. When pressing Ctrl+Alt rotating the mouse wheel +on the root window will cycle the focus over the windows. +.IP \fBTaskBarTaskGrouping\fR=0 4 +.IX Item "TaskBarTaskGrouping=0" +Group applications with the same class name under a single task button. +0 disables it, 1 shows the number of windows, 2 shows bread crumbs, +3 shows a number + bread crumbs. +.IP \fBShowPopupsAbovePointer\fR=0 4 +.IX Item "ShowPopupsAbovePointer=0" +Show popup menus above mouse pointer. +.IP \fBReplayMenuCancelClick\fR=0 4 +.IX Item "ReplayMenuCancelClick=0" +Send the clicks outside menus to target window. +.IP \fBClientWindowMouseActions\fR=1 4 +.IX Item "ClientWindowMouseActions=1" +Allow mouse actions on client windows. This is buggy with some programs. +.IP \fBGrabRootWindow\fR=1 4 +.IX Item "GrabRootWindow=1" +Manage root window (EXPERIMENTAL \- normally enabled!). +.IP \fBSnapMove\fR=1 4 +.IX Item "SnapMove=1" +Snap to nearest screen edge/window when moving windows. +.IP "\fBSnapDistance\fR=8 [0\-64]" 4 +.IX Item "SnapDistance=8 [0-64]" +Distance in pixels before windows snap together. +.IP \fBArrangeWindowsOnScreenSizeChange\fR=1 4 +.IX Item "ArrangeWindowsOnScreenSizeChange=1" +Automatically arrange windows when screen size changes. +.IP \fBAllowFullscreen\fR=1 4 +.IX Item "AllowFullscreen=1" +Allow to switch a window to fullscreen. +.IP \fBFullscreenUseAllMonitors\fR=0 4 +.IX Item "FullscreenUseAllMonitors=0" +Span over all available screens if window goes into fullscreen. +.IP "\fBMsgBoxDefaultAction\fR=0 [0\-1]" 4 +.IX Item "MsgBoxDefaultAction=0 [0-1]" +Preselect to Cancel (0) or the OK (1) button in message boxes. +.IP "\fBNetWorkAreaBehaviour\fR=0 [0\-2]" 4 +.IX Item "NetWorkAreaBehaviour=0 [0-2]" +NET_WORKAREA behaviour: 0 (single/multi\-monitor with STRUT information, +like metacity), 1 (always full desktop), 2 (single monitor with STRUT, +multi-monitor without STRUT). +.SS "QUICK SWITCH" +.IX Subsection "QUICK SWITCH" +.IP \fBQuickSwitch\fR=1 4 +.IX Item "QuickSwitch=1" +Enable Alt+Tab window switching. +.IP \fBQuickSwitchToMinimized\fR=1 4 +.IX Item "QuickSwitchToMinimized=1" +Enable Alt+Tab to minimized windows. +.IP \fBQuickSwitchToHidden\fR=1 4 +.IX Item "QuickSwitchToHidden=1" +Enable Alt+Tab to hidden windows. +.IP \fBQuickSwitchToUrgent\fR=1 4 +.IX Item "QuickSwitchToUrgent=1" +Prioritize Alt+Tab to urgent windows. +.IP \fBQuickSwitchToAllWorkspaces\fR=0 4 +.IX Item "QuickSwitchToAllWorkspaces=0" +Include windows from all workspaces in Alt+Tab. +.IP \fBQuickSwitchGroupWorkspaces\fR=1 4 +.IX Item "QuickSwitchGroupWorkspaces=1" +Group windows by workspace together in Alt+Tab. +.IP \fBQuickSwitchPersistence\fR=0 4 +.IX Item "QuickSwitchPersistence=0" +Time in seconds to remember the state of Alt+Tab. +.IP \fBQuickSwitchRaiseCandidate\fR=0 4 +.IX Item "QuickSwitchRaiseCandidate=0" +Raise a selected window while Alt+Tabbing in the QuickSwitch. +.IP \fBQuickSwitchAllIcons\fR=1 4 +.IX Item "QuickSwitchAllIcons=1" +Show all reachable icons when quick switching. +.IP \fBQuickSwitchTextFirst\fR=0 4 +.IX Item "QuickSwitchTextFirst=0" +Show the window title above (all reachable) icons. +.IP \fBQuickSwitchSmallWindow\fR=0 4 +.IX Item "QuickSwitchSmallWindow=0" +Create a smaller QuickSwitch window of 1/3 screen width. +.IP \fBQuickSwitchMaxWidth\fR=0 4 +.IX Item "QuickSwitchMaxWidth=0" +Go trough all window titles and choose width of the longest one. +.IP \fBQuickSwitchVertical\fR=1 4 +.IX Item "QuickSwitchVertical=1" +Place the icons and titles vertical instead of horizontal. +.IP \fBQuickSwitchHugeIcon\fR=0 4 +.IX Item "QuickSwitchHugeIcon=0" +Show the huge (48x48) of the window icon for the active window. +.IP \fBQuickSwitchFillSelection\fR=0 4 +.IX Item "QuickSwitchFillSelection=0" +Fill the rectangle highlighting the current icon. +.SS "EDGE SWITCHING" +.IX Subsection "EDGE SWITCHING" +.IP \fBEdgeSwitch\fR=0 4 +.IX Item "EdgeSwitch=0" +Workspace switches by moving mouse to left/right screen edge. +.IP \fBHorizontalEdgeSwitch\fR=0 4 +.IX Item "HorizontalEdgeSwitch=0" +Workspace switches by moving mouse to left/right screen edge. +.IP \fBVerticalEdgeSwitch\fR=0 4 +.IX Item "VerticalEdgeSwitch=0" +Workspace switches by moving mouse to top/bottom screen edge. +.IP \fBContinuousEdgeSwitch\fR=1 4 +.IX Item "ContinuousEdgeSwitch=1" +Workspace switches continuously when moving mouse to screen edge. +.IP "\fBEdgeResistance\fR=32 [0\-10000]" 4 +.IX Item "EdgeResistance=32 [0-10000]" +Resistance in pixels when trying to move windows off the screen (10000 = +infinite). +.SS "TASK BAR" +.IX Subsection "TASK BAR" +The following preferences affect the \fBicewm\fR\|(1) task bar: +.IP \fBShowTaskBar\fR=1 4 +.IX Item "ShowTaskBar=1" +Show task bar. +.IP \fBTaskBarAtTop\fR=0 4 +.IX Item "TaskBarAtTop=0" +Task bar at top of the screen. +.IP \fBTaskBarKeepBelow\fR=0 4 +.IX Item "TaskBarKeepBelow=0" +Keep the task bar below regular windows. +.IP \fBTaskBarAutoHide\fR=0 4 +.IX Item "TaskBarAutoHide=0" +Auto hide task bar after delay. +.IP \fBTaskBarFullscreenAutoShow\fR=1 4 +.IX Item "TaskBarFullscreenAutoShow=1" +Auto show task bar when fullscreen window active. +.IP \fBTaskBarShowClock\fR=1 4 +.IX Item "TaskBarShowClock=1" +Show clock on task bar. +.IP \fBTaskBarShowAPMStatus\fR=0 4 +.IX Item "TaskBarShowAPMStatus=0" +Show battery status monitor on task bar. +.IP \fBTaskBarShowAPMAuto\fR=1 4 +.IX Item "TaskBarShowAPMAuto=1" +Enable TaskBarShowAPMStatus if a battery is present. +.IP \fBTaskBarShowAPMTime\fR=1 4 +.IX Item "TaskBarShowAPMTime=1" +Show battery status on task bar in time-format +.IP \fBTaskBarShowAPMGraph\fR=1 4 +.IX Item "TaskBarShowAPMGraph=1" +Show battery status in graph mode. +.IP \fBTaskBarShowMailboxStatus\fR=1 4 +.IX Item "TaskBarShowMailboxStatus=1" +Show mailbox status on task bar. +.IP \fBTaskBarMailboxStatusBeepOnNewMail\fR=0 4 +.IX Item "TaskBarMailboxStatusBeepOnNewMail=0" +Beep when new mail arrives. +.IP \fBTaskBarMailboxStatusCountMessages\fR=0 4 +.IX Item "TaskBarMailboxStatusCountMessages=0" +Count messages in mailbox. +.IP \fBTaskBarShowWorkspaces\fR=1 4 +.IX Item "TaskBarShowWorkspaces=1" +Show workspace switching buttons on task bar. +.IP \fBTaskBarShowWindows\fR=1 4 +.IX Item "TaskBarShowWindows=1" +Show windows on the taskbar. +.IP \fBTaskBarShowShowDesktopButton\fR=1 4 +.IX Item "TaskBarShowShowDesktopButton=1" +Show 'show desktop' button on taskbar. If set to 2, it will move the icon to the right side, after the clock. +.IP \fBShowEllipsis\fR=1 4 +.IX Item "ShowEllipsis=1" +Show Ellipsis in taskbar items. +.IP \fBTaskBarShowTray\fR=1 4 +.IX Item "TaskBarShowTray=1" +Show windows in the tray. +.IP \fBTaskBarEnableSystemTray\fR=1 4 +.IX Item "TaskBarEnableSystemTray=1" +Enable the system tray in the taskbar. +.IP \fBTrayShowAllWindows\fR=1 4 +.IX Item "TrayShowAllWindows=1" +Show windows from all workspaces on tray. +.IP \fBTaskBarShowTransientWindows\fR=1 4 +.IX Item "TaskBarShowTransientWindows=1" +Show transient (dialogs, ...) windows on task bar. +.IP \fBTaskBarShowAllWindows\fR=0 4 +.IX Item "TaskBarShowAllWindows=0" +Show windows from all workspaces on task bar. +.IP \fBTaskBarShowWindowIcons\fR=1 4 +.IX Item "TaskBarShowWindowIcons=1" +Show icons of windows on task buttons of the task bar. +.IP \fBTaskBarShowWindowTitles\fR=1 4 +.IX Item "TaskBarShowWindowTitles=1" +Show titles of windows on task buttons of the task bar. +.IP \fBTaskBarShowStartMenu\fR=1 4 +.IX Item "TaskBarShowStartMenu=1" +Show 'Start' menu on task bar. +.IP \fBTaskBarShowWindowListMenu\fR=1 4 +.IX Item "TaskBarShowWindowListMenu=1" +Show 'window list' menu on task bar. +.IP \fBTaskBarShowCPUStatus\fR=1 4 +.IX Item "TaskBarShowCPUStatus=1" +Show CPU status on task bar (Linux & Solaris). +.IP \fBCPUStatusShowRamUsage\fR=1 4 +.IX Item "CPUStatusShowRamUsage=1" +Show RAM usage in CPU status tool tip. +.IP \fBCPUStatusShowSwapUsage\fR=1 4 +.IX Item "CPUStatusShowSwapUsage=1" +Show swap usage in CPU status tool tip. +.IP \fBCPUStatusShowAcpiTemp\fR=1 4 +.IX Item "CPUStatusShowAcpiTemp=1" +Show ACPI temperature in CPU status tool tip. +.IP \fBCPUStatusShowAcpiTempInGraph\fR=0 4 +.IX Item "CPUStatusShowAcpiTempInGraph=0" +Show ACPI temperature in CPU status bar. +.IP \fBCPUStatusShowCpuFreq\fR=1 4 +.IX Item "CPUStatusShowCpuFreq=1" +Show CPU frequency in CPU status tool tip. +.IP \fBNetStatusShowOnlyRunning\fR=0 4 +.IX Item "NetStatusShowOnlyRunning=0" +Show network status only for connected devices, such as an active Ethernet link +or associated wireless interface. If false, any network interface that has been +brought up will be displayed. +.IP \fBTaskBarShowMEMStatus\fR=1 4 +.IX Item "TaskBarShowMEMStatus=1" +Show memory usage status on task bar (Linux only). +.IP \fBTaskBarShowNetStatus\fR=1 4 +.IX Item "TaskBarShowNetStatus=1" +Show network status on task bar (Linux only). +.IP \fBTaskBarShowCollapseButton\fR=0 4 +.IX Item "TaskBarShowCollapseButton=0" +Show a button to collapse the taskbar. +.IP \fBTaskBarDoubleHeight\fR=0 4 +.IX Item "TaskBarDoubleHeight=0" +Use double-height task bar. +.IP \fBTaskBarWorkspacesLeft\fR=1 4 +.IX Item "TaskBarWorkspacesLeft=1" +Place workspace pager on left, not right. +.IP \fBTaskBarWorkspacesTop\fR=0 4 +.IX Item "TaskBarWorkspacesTop=0" +Place workspace pager on top row when using dual-height taskbar. +.IP "\fBTaskBarWorkspacesLimit\fR=""""" 4 +.IX Item "TaskBarWorkspacesLimit=""""" +Limit the number of taskbar workspaces buttons that are shown on the +workspaces pane of the taskbar. If the numeric value has a \f(CW\*(C`p\*(C'\fR suffix +then the limitation is in pixels. A \f(CW\*(C`%\*(C'\fR suffix limits by percentage of +desktop width. By default a \f(CW\*(C`B\*(C'\fR suffix is assumed for number of buttons. +.IP \fBTaskBarUseMouseWheel\fR=1 4 +.IX Item "TaskBarUseMouseWheel=1" +Enable mouse wheel cycling over workspaces and task buttons in taskbar. +.IP \fBPagerShowPreview\fR=1 4 +.IX Item "PagerShowPreview=1" +Show a mini desktop preview on each workspace button. +.IP \fBPagerShowWindowIcons\fR=1 4 +.IX Item "PagerShowWindowIcons=1" +Draw window icons inside large enough preview windows on pager (if PagerShowPreview=1). +.IP \fBPagerShowMinimized\fR=1 4 +.IX Item "PagerShowMinimized=1" +Draw even minimized windows as unfilled rectangles (if PagerShowPreview=1). +.IP \fBPagerShowBorders\fR=1 4 +.IX Item "PagerShowBorders=1" +Draw border around workspace buttons (if PagerShowPreview=1). +.IP \fBPagerShowLabels\fR=1 4 +.IX Item "PagerShowLabels=1" +Show workspace name label on workspace button (if PagerShowPreview=1) +.IP \fBPagerShowNumbers\fR=1 4 +.IX Item "PagerShowNumbers=1" +Show number of workspace on workspace button (if PagerShowPreview=1). +.IP \fBTaskBarLaunchOnSingleClick\fR=1 4 +.IX Item "TaskBarLaunchOnSingleClick=1" +Execute taskbar applet commands (like MailCommand, ClockCommand, ...) on single click. +.IP \fBEnableAddressBar\fR=1 4 +.IX Item "EnableAddressBar=1" +Enable address bar functionality in taskbar. +.IP \fBShowAddressBar\fR=1 4 +.IX Item "ShowAddressBar=1" +Show address bar in task bar. +.IP \fBMultiByte\fR=1 4 +.IX Item "MultiByte=1" +Overrides automatic multiple byte detection. +.IP \fBConfirmLogout\fR=1 4 +.IX Item "ConfirmLogout=1" +Confirm logout. +.IP \fBShapesProtectClientWindow\fR=1 4 +.IX Item "ShapesProtectClientWindow=1" +Don't cut client windows by shapes set trough frame corner pixmap. +.IP \fBDoubleBuffer\fR=1 4 +.IX Item "DoubleBuffer=1" +Use double buffering when redrawing the display. +.IP \fBXRRDisable\fR=1 4 +.IX Item "XRRDisable=1" +Disable use of new XRANDR API for dual head (nvidia workaround). +.IP \fBPreferFreetypeFonts\fR=1 4 +.IX Item "PreferFreetypeFonts=1" +Favour Xft fonts over core X11 fonts where possible. +.IP "\fBMailBoxPath\fR=""""" 4 +.IX Item "MailBoxPath=""""" +A colon separated list of paths of your mailboxes. +If this is empty, \f(CW$MAILPATH\fR or \f(CW$MAIL\fR is used instead. +.Sp +Path to a mbox file. Remote mail boxes are accessed by specifying an URL +using the Common Internet Scheme Syntax (RFC 1738): +.Sp +.Vb 1 +\& \`scheme://[user[:password]@]server[:port][/path]\`. +.Ve +.Sp +Supported schemes are \f(CW\*(C`pop3\*(C'\fR, \f(CW\*(C`imap\*(C'\fR and \f(CW\*(C`file\*(C'\fR. When the scheme is +omitted \fIfile://\fR is prepended silently. IMAP subfolders can be +accessed by using the path component. Reserved characters like +\&\fIslash\fR (\f(CW\*(C`/\*(C'\fR), \fIat\fR (\f(CW\*(C`@\*(C'\fR) and \fIcolon\fR (\f(CW\*(C`:\*(C'\fR) can be specified using +escape sequences with a hexadecimal encoding like \f(CW%2f\fR for the slash +or \f(CW%40\fR for the at sign. For example: +.Sp +.Vb 3 +\& file:///var/spool/mail/captnmark +\& pop3://markus:%2f%40%3a@maol.ch/ +\& imap://mathias@localhost/INBOX.Maillisten.icewm\-user +.Ve +.IP "\fBNetworkStatusDevice\fR=""eth0 wlan0""" 4 +.IX Item "NetworkStatusDevice=""eth0 wlan0""" +Network devices for which to show status. +.IP "\fBTimeFormat\fR=""%X""" 4 +.IX Item "TimeFormat=""%X""" +The clock time format. See the strftime manpage for the meaning of all +the percent options. It is possible to define multiple clocks for +different time zones in a single \fITimeFormat\fR. A new clock is defined +by the beginning of the string, and by each time zone specification +that starts with \f(CW\*(C`TZ=...\*(C'\fR, followed by a space. For example, +\&\fBTimeFormat\fR=\f(CW\*(C`%X TZ=Asia/Aden %T TZ=Asia/Baku %T\*(C'\fR defines 3 clocks. +.IP "\fBTimeFormatAlt\fR=""""" 4 +.IX Item "TimeFormatAlt=""""" +Alternate Clock Time format shown every other second. +.IP "\fBDateFormat\fR=""%c""" 4 +.IX Item "DateFormat=""%c""" +Clock Date format for tooltip (strftime format string). +.IP "\fBDockApps\fR=""right high desktop""" 4 +.IX Item "DockApps=""right high desktop""" +Support DockApps (right, left, center, down, high, above, below, +desktop, or empty to disable). Control with Ctrl+Mouse. +.IP "\fBXRRPrimaryScreenName\fR=""""" 4 +.IX Item "XRRPrimaryScreenName=""""" +Screen/output name of the primary screen. +.IP "\fBAcpiIgnoreBatteries\fR=""""" 4 +.IX Item "AcpiIgnoreBatteries=""""" +List of battery names (directories) in /proc/acpi/battery to ignore. +Useful when more slots are built-in, but only one battery is used. +.IP "\fBTaskBarCPUSamples\fR=20 [2\-1000]" 4 +.IX Item "TaskBarCPUSamples=20 [2-1000]" +The width of the CPU Monitor applet in pixels. +.IP "\fBTaskBarMEMSamples\fR=20 [2\-1000]" 4 +.IX Item "TaskBarMEMSamples=20 [2-1000]" +The width of the Memory Monitor applet in pixels. +.IP "\fBTaskBarNetSamples\fR=20 [2\-1000]" 4 +.IX Item "TaskBarNetSamples=20 [2-1000]" +The width of the Net Monitor applet in pixels. +.IP "\fBTaskbarButtonWidthDivisor\fR=3 [1\-25]" 4 +.IX Item "TaskbarButtonWidthDivisor=3 [1-25]" +Default number of tasks in taskbar. +.IP "\fBTaskBarWidthPercentage\fR=100 [0\-100]" 4 +.IX Item "TaskBarWidthPercentage=100 [0-100]" +Task bar width as percentage of the screen width. +.IP "\fBTaskBarJustify\fR=""left""" 4 +.IX Item "TaskBarJustify=""left""" +Taskbar justify left, right or center. +.IP "\fBTaskBarApmGraphWidth\fR=10 [1\-1000]" 4 +.IX Item "TaskBarApmGraphWidth=10 [1-1000]" +Width of battery Monitor. +.IP "\fBXineramaPrimaryScreen\fR=0 [0\-63]" 4 +.IX Item "XineramaPrimaryScreen=0 [0-63]" +Primary screen for xinerama (taskbar, ...). +.IP "\fBKeyboardLayouts\fR=""""" 4 +.IX Item "KeyboardLayouts=""""" +A comma-separated list of keyboard layouts. +A layout may be enclosed in double quotes. +Each layout is a name with optional arguments, +that is to be parsed by the \f(CW\*(C`setxkbmap\*(C'\fR program. +To support changing keyboard layouts, the +\&\f(CW\*(C`setxkbmap\*(C'\fR program must be installed. +The first in the list is the default layout. +Programs may have their own keyboard layout +defined in the \fIwinoptions\fR file. +The first two letters of a layout are used +to locate an icon image file. +.SS MENUS +.IX Subsection "MENUS" +.IP \fBAutoReloadMenus\fR=1 4 +.IX Item "AutoReloadMenus=1" +Reload menu files automatically. +.IP \fBShowProgramsMenu\fR=0 4 +.IX Item "ShowProgramsMenu=0" +Show programs submenu. +.IP \fBShowSettingsMenu\fR=1 4 +.IX Item "ShowSettingsMenu=1" +Show settings submenu. +.IP \fBShowFocusModeMenu\fR=1 4 +.IX Item "ShowFocusModeMenu=1" +Show focus mode submenu. +.IP \fBShowThemesMenu\fR=1 4 +.IX Item "ShowThemesMenu=1" +Show themes submenu. +.IP \fBShowLogoutMenu\fR=1 4 +.IX Item "ShowLogoutMenu=1" +Show logout menu. +.IP \fBShowHelp\fR=1 4 +.IX Item "ShowHelp=1" +Show the help menu item. +.IP \fBShowLogoutSubMenu\fR=1 4 +.IX Item "ShowLogoutSubMenu=1" +Show logout submenu. +.IP \fBShowAbout\fR=1 4 +.IX Item "ShowAbout=1" +Show the about menu item. +.IP \fBShowRun\fR=1 4 +.IX Item "ShowRun=1" +Show the run menu item. +.IP \fBShowWindowList\fR=1 4 +.IX Item "ShowWindowList=1" +Show the window menu item. +.IP "\fBMenuMaximalWidth\fR=0 [0\-16384]" 4 +.IX Item "MenuMaximalWidth=0 [0-16384]" +Maximal width of popup menus, 2/3 of the screen's width if set to zero. +.IP "\fBNestedThemeMenuMinNumber\fR=25 [0\-1234]" 4 +.IX Item "NestedThemeMenuMinNumber=25 [0-1234]" +Minimal number of themes after which the Themes menu becomes nested (0=disabled). +.SS TIMINGS +.IX Subsection "TIMINGS" +.IP "\fBDelayFuzziness\fR=10 (0\-100)" 4 +.IX Item "DelayFuzziness=10 (0-100)" +Delay fuzziness, to allow merging of multiple timer timeouts into one +(notebook power saving). +.IP "\fBClickMotionDistance\fR=4 [0\-32]" 4 +.IX Item "ClickMotionDistance=4 [0-32]" +Pointer motion distance before click gets interpreted as drag. +.IP "\fBClickMotionDelay\fR=200 [0\-2000]" 4 +.IX Item "ClickMotionDelay=200 [0-2000]" +Delay before click gets interpreted as drag. +.IP "\fBMultiClickTime\fR=400 [0\-5000]" 4 +.IX Item "MultiClickTime=400 [0-5000]" +Multiple click time. +.IP "\fBMenuActivateDelay\fR=40 [0\-5000]" 4 +.IX Item "MenuActivateDelay=40 [0-5000]" +Delay before activating menu items. +.IP "\fBSubmenuMenuActivateDelay\fR=300 [0\-5000]" 4 +.IX Item "SubmenuMenuActivateDelay=300 [0-5000]" +Delay before activating menu submenus. +.IP \fBToolTipIcon\fR=1 4 +.IX Item "ToolTipIcon=1" +Show an application icon in toolbar and tray tooltips. +.IP "\fBToolTipDelay\fR=1000 [0\-5000]" 4 +.IX Item "ToolTipDelay=1000 [0-5000]" +Delay before tooltip window is displayed. +.IP "\fBToolTipTime\fR=0 [0\-60000]" 4 +.IX Item "ToolTipTime=0 [0-60000]" +Time before tooltip window is hidden (0 means never). +.IP "\fBAutoHideDelay\fR=300 [0\-5000]" 4 +.IX Item "AutoHideDelay=300 [0-5000]" +Delay before task bar is hidden. +.IP "\fBAutoShowDelay\fR=500 [0\-5000]" 4 +.IX Item "AutoShowDelay=500 [0-5000]" +Delay before task bar is shown. +.IP "\fBAutoRaiseDelay\fR=400 [0\-5000]" 4 +.IX Item "AutoRaiseDelay=400 [0-5000]" +Delay before windows are auto raised if \f(CW\*(C`AutoRaise=1\*(C'\fR. +.IP "\fBPointerFocusDelay\fR=200 [0\-1000]" 4 +.IX Item "PointerFocusDelay=200 [0-1000]" +Delay for pointer focus switching. +.IP "\fBEdgeSwitchDelay\fR=600 [0\-5000]" 4 +.IX Item "EdgeSwitchDelay=600 [0-5000]" +Screen edge workspace switching delay. +.IP "\fBScrollBarStartDelay\fR=500 [0\-5000]" 4 +.IX Item "ScrollBarStartDelay=500 [0-5000]" +Initial scroll bar autoscroll delay. +.IP "\fBScrollBarDelay\fR=30 [0\-5000]" 4 +.IX Item "ScrollBarDelay=30 [0-5000]" +Scroll bar autoscroll delay. +.IP "\fBAutoScrollStartDelay\fR=500 [0\-5000]" 4 +.IX Item "AutoScrollStartDelay=500 [0-5000]" +Auto scroll start delay. +.IP "\fBAutoScrollDelay\fR=60 [0\-5000]" 4 +.IX Item "AutoScrollDelay=60 [0-5000]" +Auto scroll delay. +.IP "\fBWorkspaceStatusTime\fR=2500 [0\-2500]" 4 +.IX Item "WorkspaceStatusTime=2500 [0-2500]" +Time before workspace status window is hidden. +.IP "\fBMailCheckDelay\fR=30 [0\-86400]" 4 +.IX Item "MailCheckDelay=30 [0-86400]" +Delay between new-mail checks. (seconds). +.IP "\fBTaskBarCPUDelay\fR=500 [10\-3600000]" 4 +.IX Item "TaskBarCPUDelay=500 [10-3600000]" +Delay between CPU Monitor samples in ms. +.IP "\fBTaskBarMEMDelay\fR=500 [10\-3600000]" 4 +.IX Item "TaskBarMEMDelay=500 [10-3600000]" +Delay between Memory Monitor samples in ms. +.IP "\fBTaskBarNetDelay\fR=500 [10\-3600000]" 4 +.IX Item "TaskBarNetDelay=500 [10-3600000]" +Delay between Net Monitor samples in ms. +.IP "\fBFocusRequestFlashTime\fR=0 [0\-86400]" 4 +.IX Item "FocusRequestFlashTime=0 [0-86400]" +Number of seconds the taskbar app will blink when requesting focus (0 = forever). +.IP "\fBFocusRequestFlashInterval\fR=250 [0\-30000]" 4 +.IX Item "FocusRequestFlashInterval=250 [0-30000]" +Taskbar blink interval (ms) when requesting focus (0 = blinking disabled). +.IP "\fBBatteryPollingPeriod\fR=10 [2\-3600]" 4 +.IX Item "BatteryPollingPeriod=10 [2-3600]" +Delay between power status updates (seconds). +.IP "\fBPingTimeout\fR=3 [0\-86400]" 4 +.IX Item "PingTimeout=3 [0-86400]" +Timeout in seconds for applications to respond to the _NET_WM_PING protocol. +.SS "BUTTONS AND KEYS" +.IX Subsection "BUTTONS AND KEYS" +.IP "\fBUseRootButtons\fR=255 [0\-255]" 4 +.IX Item "UseRootButtons=255 [0-255]" +Bitmask of root window button click to use in window manager. +.IP "\fBButtonRaiseMask\fR=1 [0\-255]" 4 +.IX Item "ButtonRaiseMask=1 [0-255]" +Bitmask of buttons that raise the window when pressed. +.IP "\fBDesktopWinMenuButton\fR=0 [0\-20]" 4 +.IX Item "DesktopWinMenuButton=0 [0-20]" +Desktop mouse-button click to show the window list menu. +.IP "\fBDesktopWinListButton\fR=2 # [0\-20]" 4 +.IX Item "DesktopWinListButton=2 # [0-20]" +Desktop mouse-button click to show the window list +.IP "\fBDesktopMenuButton\fR=3 [0\-20]" 4 +.IX Item "DesktopMenuButton=3 [0-20]" +Desktop mouse-button click to show the root menu. +.IP "\fBTitleBarMaximizeButton\fR=1 [0\-5]" 4 +.IX Item "TitleBarMaximizeButton=1 [0-5]" +Title bar mouse-button double click to maximize the window to full +screen with the frame border visible. +Press Shift to maximize only in the vertical direction. +Press Alt+Shift to maximize only in the horizontal direction. +.IP "\fBTitleBarRollupButton\fR=2 [0\-5]" 4 +.IX Item "TitleBarRollupButton=2 [0-5]" +Title bar mouse-button double click to rollup the window. +Press Shift to maximize in the horizontal direction. +.SS WORKSPACES +.IX Subsection "WORKSPACES" +.IP "\fBWorkspaceNames\fR="" 1 "", "" 2 "", "" 3 "", "" 4 """ 4 +.IX Item "WorkspaceNames="" 1 "", "" 2 "", "" 3 "", "" 4 """ +Create four workspaces with names \f(CW 1 \fR, \f(CW 2 \fR, \f(CW 3 \fR and \f(CW 4 \fR. +.SS PATHS +.IX Subsection "PATHS" +.IP "\fBIconPath\fR=""/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps""" 4 +.IX Item "IconPath=""/usr/local/share/icons:/usr/local/share/pixmaps:/usr/share/icons:/usr/share/pixmaps""" +Icon search path (colon separated). Also, the icons/ subdirectory in +IceWM resource folders are searched first. +.IP "\fBIconThemes\fR=""*:\-HighContrast""" 4 +.IX Item "IconThemes=""*:-HighContrast""" +List of icon themes (colon separated), acting as additional filter of +icon subdirectories in any of the \fBIconPath\fR folders. Expressions can be +wildcards, also special wildcards (starting with \fB\-\fR) can exclude matched +themes from selection. +.IP "\fBMailBoxPath\fR=""""" 4 +.IX Item "MailBoxPath=""""" +A colon separated list of paths of your mailboxes. +If this is empty, \f(CW$MAILPATH\fR or \f(CW$MAIL\fR is used instead. +.SS PROGRAMS +.IX Subsection "PROGRAMS" +.IP "\fBMailCommand\fR=""xterm \-name mutt \-e mutt""" 4 +.IX Item "MailCommand=""xterm -name mutt -e mutt""" +Command to run on mailbox. +.IP "\fBMailClassHint\fR=""mutt.XTerm""" 4 +.IX Item "MailClassHint=""mutt.XTerm""" +\&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBMailCommand\fR. +.IP "\fBNewMailCommand\fR=""""" 4 +.IX Item "NewMailCommand=""""" +Command to run when new mail arrives. +.IP "\fBLockCommand\fR=""""" 4 +.IX Item "LockCommand=""""" +Command to lock display/screensaver. +.IP "\fBClockCommand\fR=""xclock \-name icewm \-title Clock""" 4 +.IX Item "ClockCommand=""xclock -name icewm -title Clock""" +Command to run on clock. +.IP "\fBClockClassHint\fR=""icewm.XClock""" 4 +.IX Item "ClockClassHint=""icewm.XClock""" +\&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBClockCommand\fR. +.IP "\fBRunCommand\fR=""""" 4 +.IX Item "RunCommand=""""" +Command to select and run a program. +.IP "\fBOpenCommand\fR=""""" 4 +.IX Item "OpenCommand=""""" +Open command. +.IP "\fBTerminalCommand\fR=""xterm""" 4 +.IX Item "TerminalCommand=""xterm""" +Terminal emulator must accept \-e option. +.IP "\fBLogoutCommand\fR=""""" 4 +.IX Item "LogoutCommand=""""" +Command to start logout. +.IP "\fBLogoutCancelCommand\fR=""""" 4 +.IX Item "LogoutCancelCommand=""""" +Command to cancel logout. +.IP "\fBShutdownCommand\fR=""/bin/sh \-c ""{ test \-e /run/systemd/system && systemctl poweroff || loginctl poweroff; }""""" 4 +.IX Item "ShutdownCommand=""/bin/sh -c ""{ test -e /run/systemd/system && systemctl poweroff || loginctl poweroff; }""""" +Command to shutdown the system. +.IP "\fBRebootCommand\fR=""/bin/sh \-c ""{ test \-e /run/systemd/system && systemctl reboot || loginctl reboot; }""""" 4 +.IX Item "RebootCommand=""/bin/sh -c ""{ test -e /run/systemd/system && systemctl reboot || loginctl reboot; }""""" +Command to reboot the system. +.IP "\fBSuspendCommand\fR=""test \-e /run/systemd/system && systemctl suspend || loginctl suspend""" 4 +.IX Item "SuspendCommand=""test -e /run/systemd/system && systemctl suspend || loginctl suspend""" +Command to send the system to standby mode +.IP "\fBSuspendCommand\fR=""test \-e /run/systemd/system && systemctl hibernate || loginctl hibernate""" 4 +.IX Item "SuspendCommand=""test -e /run/systemd/system && systemctl hibernate || loginctl hibernate""" +Command to hibernate the system. +.IP "\fBCPUStatusCommand\fR=""xterm \-name top \-title Process\e Status \-e top""" 4 +.IX Item "CPUStatusCommand=""xterm -name top -title Process Status -e top""" +Command to run on CPU status. +.IP "\fBCPUStatusClassHint\fR=""top.XTerm""" 4 +.IX Item "CPUStatusClassHint=""top.XTerm""" +\&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBCPUStatusCommand\fR. +.IP "\fBCPUStatusCombine\fR=1 0/1" 4 +.IX Item "CPUStatusCombine=1 0/1" +Combine all CPUs to one. +.IP "\fBNetStatusCommand\fR=""xterm \-name netstat \-title 'Network Status' \-e netstat \-c""" 4 +.IX Item "NetStatusCommand=""xterm -name netstat -title 'Network Status' -e netstat -c""" +Command to run on Net status. +.IP "\fBNetStatusClassHint\fR=""netstat.XTerm""" 4 +.IX Item "NetStatusClassHint=""netstat.XTerm""" +\&\fBWM_CLASS\fR to allow \fBrunonce\fR for \fBNetStatusCommand\fR. +.IP "\fBAddressBarCommand\fR=""""" 4 +.IX Item "AddressBarCommand=""""" +Command to run for address bar entries. +.SS "WINDOW MENUS" +.IX Subsection "WINDOW MENUS" +.IP "\fBWinMenuItems\fR=""rmsnxfhualytiecw""" 4 +.IX Item "WinMenuItems=""rmsnxfhualytiecw""" +Items supported in menu window (rmsnxfhualytieckw) +.IP \fBRolloverButtonsSupported\fR=0 4 +.IX Item "RolloverButtonsSupported=0" +Does it support the 'O' title bar button images (for mouse rollover). +.IP "\fBShowMenuButtonIcon\fR=1 # 0/1" 4 +.IX Item "ShowMenuButtonIcon=1 # 0/1" +Show application icon over menu button +.SS "THEME SETTINGS" +.IX Subsection "THEME SETTINGS" +The following sections show settings that can be set in theme files. +They can also be set in the \fIpreferences\fR file, but themes will override +the values set there. To override the theme values, the settings should +be set in \fIprefoverrides\fR file: see \fBicewm\-prefoverrides\fR\|(5). Default +values are shown following the equal sign. +.PP +\fITHEME DESCRIPTION\fR +.IX Subsection "THEME DESCRIPTION" +.IP "\fBThemeAuthor\fR=""""" 4 +.IX Item "ThemeAuthor=""""" +Theme author, e\-mail address, credits. +.IP "\fBThemeDescription\fR=""""" 4 +.IX Item "ThemeDescription=""""" +Description of the theme, credits. +.IP "\fBLook\fR=""nice""" 4 +.IX Item "Look=""nice""" +Choose a theme look from one of: +"win95", "motif", "warp3", "warp4", +"nice", "metal2", "gtk2", and some others. +.IP "\fBGradients\fR=""""" 4 +.IX Item "Gradients=""""" +List of gradient pixmaps in the current theme. +.PP +\fITHEME BORDERS, ICONS, MARGINS AND BUTTONS\fR +.IX Subsection "THEME BORDERS, ICONS, MARGINS AND BUTTONS" +.IP "\fBBorderSizeX\fR=6 [0\-128]" 4 +.IX Item "BorderSizeX=6 [0-128]" +Horizontal window border. +.IP "\fBBorderSizeY\fR=6 [0\-128]" 4 +.IX Item "BorderSizeY=6 [0-128]" +Vertical window border. +.IP "\fBDlgBorderSizeX\fR=2 [0\-128]" 4 +.IX Item "DlgBorderSizeX=2 [0-128]" +Horizontal dialog window border. +.IP "\fBDlgBorderSizeY\fR=2 [0\-128]" 4 +.IX Item "DlgBorderSizeY=2 [0-128]" +Vertical dialog window border. +.IP "\fBCornerSizeX\fR=24 [0\-64]" 4 +.IX Item "CornerSizeX=24 [0-64]" +Resize corner width. +.IP "\fBCornerSizeY\fR=24 [0\-64]" 4 +.IX Item "CornerSizeY=24 [0-64]" +Resize corner height. +.IP "\fBTitleBarHeight\fR=20 [0\-128]" 4 +.IX Item "TitleBarHeight=20 [0-128]" +Title bar height. +.IP "\fBTitleBarJustify\fR=0 [0\-100]" 4 +.IX Item "TitleBarJustify=0 [0-100]" +Justification of the window title. +.IP "\fBTitleBarHorzOffset\fR=0 [\-128\-128]" 4 +.IX Item "TitleBarHorzOffset=0 [-128-128]" +Horizontal offset for the window title text. +.IP "\fBTitleBarVertOffset\fR=0 [\-128\-128]" 4 +.IX Item "TitleBarVertOffset=0 [-128-128]" +Vertical offset for the window title text. +.IP "\fBMenuButtonIconVertOffset\fR=0 [\-128\-128]" 4 +.IX Item "MenuButtonIconVertOffset=0 [-128-128]" +Vertical offset for the menu button icon. +.IP "\fBScrollBarX\fR=16 [0\-64]" 4 +.IX Item "ScrollBarX=16 [0-64]" +Scrollbar width. +.IP "\fBScrollBarY\fR=16 [0\-64]" 4 +.IX Item "ScrollBarY=16 [0-64]" +Scrollbar (button) height. +.IP "\fBMenuIconSize\fR=16 [8\-128]" 4 +.IX Item "MenuIconSize=16 [8-128]" +Menu icon size. +.IP "\fBSmallIconSize\fR=16 [8\-128]" 4 +.IX Item "SmallIconSize=16 [8-128]" +Dimension of the small icons. +.IP "\fBLargeIconSize\fR=32 [8\-128]" 4 +.IX Item "LargeIconSize=32 [8-128]" +Dimension of the large icons. +.IP "\fBHugeIconSize\fR=48 [8\-128]" 4 +.IX Item "HugeIconSize=48 [8-128]" +Dimension of the large icons. +.IP "\fBQuickSwitchHorzMargin\fR=3 [0\-64]" 4 +.IX Item "QuickSwitchHorzMargin=3 [0-64]" +Horizontal margin of the quickswitch window. +.IP "\fBQuickSwitchVertMargin\fR=3 [0\-64]" 4 +.IX Item "QuickSwitchVertMargin=3 [0-64]" +Vertical margin of the quickswitch window. +.IP "\fBQuickSwitchIconMargin\fR=4 [0\-64]" 4 +.IX Item "QuickSwitchIconMargin=4 [0-64]" +Vertical margin in the quickswitch window. +.IP "\fBQuickSwitchIconBorder\fR=2 [0\-64]" 4 +.IX Item "QuickSwitchIconBorder=2 [0-64]" +Distance between the active icon and it's border. +.IP "\fBQuickSwitchSeparatorSize\fR=6 [0\-64]" 4 +.IX Item "QuickSwitchSeparatorSize=6 [0-64]" +Height of the separator between (all reachable) icons and text, 0 to avoid it. +.IP "\fBTitleButtonsLeft\fR=""s""" 4 +.IX Item "TitleButtonsLeft=""s""" +Titlebar buttons from left to right (x=close, m=max, i=min, h=hide, r=rollup, s=sysmenu, d=depth). +.IP "\fBTitleButtonsRight\fR=""xmir""" 4 +.IX Item "TitleButtonsRight=""xmir""" +Titlebar buttons from right to left (x=close, m=max, i=min, h=hide, r=rollup, s=sysmenu, d=depth). +.IP "\fBTitleButtonsSupported\fR=""xmis""" 4 +.IX Item "TitleButtonsSupported=""xmis""" +Titlebar buttons supported by theme (x,m,i,r,h,s,d). +.IP "\fBTitleBarCentered\fR=0 # 0/1" 4 +.IX Item "TitleBarCentered=0 # 0/1" +Draw window title centered (obsoleted by TitleBarJustify). +.IP "\fBTitleBarJoinLeft\fR=0 # 0/1" 4 +.IX Item "TitleBarJoinLeft=0 # 0/1" +Join title*S and title*T. +.IP "\fBTitleBarJoinRight\fR=0 # 0/1" 4 +.IX Item "TitleBarJoinRight=0 # 0/1" +Join title*T and title*B. +.IP "\fBTaskBarClockLeds\fR=0 # 0/1" 4 +.IX Item "TaskBarClockLeds=0 # 0/1" +Task bar clock/battery monitor uses nice pixmap LCD display (but then it +doesn't display correctly in many languages anymore, e.g., for +Japanese and Korean it works only when a real font is used and not +the LCD pixmaps.) +.IP "\fBTaskBarGraphHeight\fR=20 [16\-1000]" 4 +.IX Item "TaskBarGraphHeight=20 [16-1000]" +Height of taskbar monitoring applets. +.IP "\fBTaskbuttonIconOffset\fR=0 # [0\-16]" 4 +.IX Item "TaskbuttonIconOffset=0 # [0-16]" +Width of taskbutton side icons. +.IP "\fBTrayIconMaxWidth\fR=32 # [16\-128]" 4 +.IX Item "TrayIconMaxWidth=32 # [16-128]" +Maximum scaled width of tray icons. +.IP "\fBTrayIconMaxHeight\fR=24 # [16\-128]" 4 +.IX Item "TrayIconMaxHeight=24 # [16-128]" +Maximum scaled height of tray icons. +.IP "\fBTrayDrawBevel\fR=0 # 0/1" 4 +.IX Item "TrayDrawBevel=0 # 0/1" +Surround the tray with plastic border. +.PP +\fITHEME FONTS\fR +.IX Subsection "THEME FONTS" +.IP "\fBTitleFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "TitleFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBTitleFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "TitleFontNameXft=""sans-serif:size=12""" +.PD +Name of the title bar font. +.IP "\fBMenuFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-100\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "MenuFontName=""-*-sans-bold-r-*-*-*-100-*-*-*-*-*-*""" +.PD 0 +.IP "\fBMenuFontNameXft\fR=""sans\-serif:size=10:bold""" 4 +.IX Item "MenuFontNameXft=""sans-serif:size=10:bold""" +.PD +Name of the menu font. +.IP "\fBStatusFontName\fR=""\-*\-monospace\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "StatusFontName=""-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBStatusFontNameXft\fR=""monospace:size=12:bold""" 4 +.IX Item "StatusFontNameXft=""monospace:size=12:bold""" +.PD +Name of the status display font. +.IP "\fBQuickSwitchFontName\fR=""\-*\-monospace\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "QuickSwitchFontName=""-*-monospace-bold-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBQuickSwitchFontNameXft\fR=""monospace:size=12:bold""" 4 +.IX Item "QuickSwitchFontNameXft=""monospace:size=12:bold""" +.PD +Name of the font for Alt+Tab switcher window. +.IP "\fBNormalButtonFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "NormalButtonFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBNormalButtonFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "NormalButtonFontNameXft=""sans-serif:size=12""" +.PD +Name of the normal button font. +.IP "\fBActiveButtonFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "ActiveButtonFontName=""-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBActiveButtonFontNameXft\fR=""sans\-serif:size=12:bold""" 4 +.IX Item "ActiveButtonFontNameXft=""sans-serif:size=12:bold""" +.PD +Name of the active button font. +.IP "\fBNormalTaskBarFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "NormalTaskBarFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBNormalTaskBarFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "NormalTaskBarFontNameXft=""sans-serif:size=12""" +.PD +Name of the normal task bar item font. +.IP "\fBActiveTaskBarFontName\fR=""\-*\-sans\-bold\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "ActiveTaskBarFontName=""-*-sans-bold-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBActiveTaskBarFontNameXft\fR=""sans\-serif:size=12:bold""" 4 +.IX Item "ActiveTaskBarFontNameXft=""sans-serif:size=12:bold""" +.PD +Name of the active task bar item font. +.IP "\fBToolButtonFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "ToolButtonFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBToolButtonFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "ToolButtonFontNameXft=""sans-serif:size=12""" +.PD +Name of the tool button font (fallback: NormalButtonFontName). +.IP "\fBNormalWorkspaceFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "NormalWorkspaceFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBNormalWorkspaceFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "NormalWorkspaceFontNameXft=""sans-serif:size=12""" +.PD +Name of the normal workspace button font (fallback: NormalButtonFontName). +.IP "\fBActiveWorkspaceFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "ActiveWorkspaceFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBActiveWorkspaceFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "ActiveWorkspaceFontNameXft=""sans-serif:size=12""" +.PD +Name of the active workspace button font (fallback: ActiveButtonFontName). +.IP "\fBMinimizedWindowFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "MinimizedWindowFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBMinimizedWindowFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "MinimizedWindowFontNameXft=""sans-serif:size=12""" +.PD +Name of the mini-window font. +.IP "\fBListBoxFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "ListBoxFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBListBoxFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "ListBoxFontNameXft=""sans-serif:size=12""" +.PD +Name of the window list font. +.IP "\fBToolTipFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-120\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "ToolTipFontName=""-*-sans-medium-r-*-*-*-120-*-*-*-*-*-*""" +.PD 0 +.IP "\fBToolTipFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "ToolTipFontNameXft=""sans-serif:size=12""" +.PD +Name of the tool tip font. +.IP "\fBClockFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "ClockFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*""" +.PD 0 +.IP "\fBClockFontNameXft\fR=""monospace:size=12""" 4 +.IX Item "ClockFontNameXft=""monospace:size=12""" +.PD +Name of the task bar clock font. +.IP "\fBTempFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "TempFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*""" +.PD 0 +.IP "\fBTempFontNameXft\fR=""monospace:size=12""" 4 +.IX Item "TempFontNameXft=""monospace:size=12""" +.PD +Name of the task bar temperature font. +.IP "\fBApmFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "ApmFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*""" +.PD 0 +.IP "\fBApmFontNameXft\fR=""monospace:size=12""" 4 +.IX Item "ApmFontNameXft=""monospace:size=12""" +.PD +Name of the task bar battery font. +.IP "\fBInputFontName\fR=""\-*\-monospace\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "InputFontName=""-*-monospace-medium-r-*-*-*-140-*-*-*-*-*-*""" +.PD 0 +.IP "\fBInputFontNameXft\fR=""monospace:size=12""" 4 +.IX Item "InputFontNameXft=""monospace:size=12""" +.PD +Name of the input field font. +.IP "\fBLabelFontName\fR=""\-*\-sans\-medium\-r\-*\-*\-*\-140\-*\-*\-*\-*\-*\-*""" 4 +.IX Item "LabelFontName=""-*-sans-medium-r-*-*-*-140-*-*-*-*-*-*""" +.PD 0 +.IP "\fBLabelFontNameXft\fR=""sans\-serif:size=12""" 4 +.IX Item "LabelFontNameXft=""sans-serif:size=12""" +.PD +Name of the label font. +.PP +\fITHEME COLORS\fR +.IX Subsection "THEME COLORS" +.IP "\fBColorDialog\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorDialog = ""rgb:C0/C0/C0""" +Background of dialog windows. +.IP "\fBColorNormalBorder\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorNormalBorder = ""rgb:C0/C0/C0""" +Border of inactive windows. +.IP "\fBColorActiveBorder\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorActiveBorder = ""rgb:C0/C0/C0""" +Border of active windows. +.IP "\fBColorNormalButton\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorNormalButton = ""rgb:C0/C0/C0""" +Background of regular buttons. +.IP "\fBColorNormalButtonText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorNormalButtonText = ""rgb:00/00/00""" +Text color of regular buttons. +.IP "\fBColorActiveButton\fR = ""rgb:E0/E0/E0""" 4 +.IX Item "ColorActiveButton = ""rgb:E0/E0/E0""" +Background of pressed buttons. +.IP "\fBColorActiveButtonText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorActiveButtonText = ""rgb:00/00/00""" +Text color of pressed buttons. +.IP "\fBColorNormalTitleButton\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorNormalTitleButton = ""rgb:C0/C0/C0""" +Background of titlebar buttons. +.IP "\fBColorNormalTitleButtonText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorNormalTitleButtonText = ""rgb:00/00/00""" +Text color of titlebar buttons. +.IP "\fBColorToolButton\fR = """"" 4 +.IX Item "ColorToolButton = """"" +Background of toolbar buttons, ColorNormalButton is used if empty. +.IP "\fBColorToolButtonText\fR = """"" 4 +.IX Item "ColorToolButtonText = """"" +Text color of toolbar buttons, ColorNormalButtonText is used if empty. +.IP "\fBColorNormalWorkspaceButton\fR = """"" 4 +.IX Item "ColorNormalWorkspaceButton = """"" +Background of workspace buttons, ColorNormalButton is used if empty. +.IP "\fBColorNormalWorkspaceButtonText\fR = """"" 4 +.IX Item "ColorNormalWorkspaceButtonText = """"" +Text color of workspace buttons, ColorNormalButtonText is used if empty. +.IP "\fBColorActiveWorkspaceButton\fR = """"" 4 +.IX Item "ColorActiveWorkspaceButton = """"" +Background of the active workspace button, ColorActiveButton is used if empty. +.IP "\fBColorActiveWorkspaceButtonText\fR = """"" 4 +.IX Item "ColorActiveWorkspaceButtonText = """"" +Text color of the active workspace button, ColorActiveButtonText is used if empty. +.IP "\fBColorNormalTitleBar\fR = ""rgb:80/80/80""" 4 +.IX Item "ColorNormalTitleBar = ""rgb:80/80/80""" +Background of the titlebar of regular windows. +.IP "\fBColorNormalTitleBarText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorNormalTitleBarText = ""rgb:00/00/00""" +Text color of the titlebar of regular windows. +.IP "\fBColorNormalTitleBarShadow\fR = """"" 4 +.IX Item "ColorNormalTitleBarShadow = """"" +Text shadow of the titlebar of regular windows. +.IP "\fBColorActiveTitleBar\fR = ""rgb:00/00/A0""" 4 +.IX Item "ColorActiveTitleBar = ""rgb:00/00/A0""" +Background of the titlebar of active windows. +.IP "\fBColorActiveTitleBarText\fR = ""rgb:FF/FF/FF""" 4 +.IX Item "ColorActiveTitleBarText = ""rgb:FF/FF/FF""" +Text color of the titlebar of active windows. +.IP "\fBColorActiveTitleBarShadow\fR = """"" 4 +.IX Item "ColorActiveTitleBarShadow = """"" +Text shadow of the titlebar of active windows. +.IP "\fBColorNormalMinimizedWindow\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorNormalMinimizedWindow = ""rgb:C0/C0/C0""" +Background for mini icons of regular windows. +.IP "\fBColorNormalMinimizedWindowText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorNormalMinimizedWindowText = ""rgb:00/00/00""" +Text color for mini icons of regular windows. +.IP "\fBColorActiveMinimizedWindow\fR = ""rgb:E0/E0/E0""" 4 +.IX Item "ColorActiveMinimizedWindow = ""rgb:E0/E0/E0""" +Background for mini icons of active windows. +.IP "\fBColorActiveMinimizedWindowText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorActiveMinimizedWindowText = ""rgb:00/00/00""" +Text color for mini icons of active windows. +.IP "\fBColorNormalMenu\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorNormalMenu = ""rgb:C0/C0/C0""" +Background of pop-up menus. +.IP "\fBColorNormalMenuItemText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorNormalMenuItemText = ""rgb:00/00/00""" +Text color of regular menu items. +.IP "\fBColorActiveMenuItem\fR = ""rgb:A0/A0/A0""" 4 +.IX Item "ColorActiveMenuItem = ""rgb:A0/A0/A0""" +Background of selected menu item, leave empty to force transparency. +.IP "\fBColorActiveMenuItemText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorActiveMenuItemText = ""rgb:00/00/00""" +Text color of selected menu items. +.IP "\fBColorDisabledMenuItemText\fR = ""rgb:80/80/80""" 4 +.IX Item "ColorDisabledMenuItemText = ""rgb:80/80/80""" +Text color of disabled menu items. +.IP "\fBColorDisabledMenuItemShadow\fR = """"" 4 +.IX Item "ColorDisabledMenuItemShadow = """"" +Shadow of regular menu items. +.IP "\fBColorMoveSizeStatus\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorMoveSizeStatus = ""rgb:C0/C0/C0""" +Background of move/resize status window. +.IP "\fBColorMoveSizeStatusText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorMoveSizeStatusText = ""rgb:00/00/00""" +Text color of move/resize status window. +.IP "\fBColorQuickSwitch\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorQuickSwitch = ""rgb:C0/C0/C0""" +Background of the quick switch window. +.IP "\fBColorQuickSwitchText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorQuickSwitchText = ""rgb:00/00/00""" +Text color in the quick switch window. +.IP "\fBColorQuickSwitchActive\fR = """"" 4 +.IX Item "ColorQuickSwitchActive = """"" +Rectangle around the active icon in the quick switch window. +.IP "\fBColorDefaultTaskBar\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorDefaultTaskBar = ""rgb:C0/C0/C0""" +Background of the taskbar. +.IP "\fBColorNormalTaskBarApp\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorNormalTaskBarApp = ""rgb:C0/C0/C0""" +Background for task buttons of regular windows. +.IP "\fBColorNormalTaskBarAppText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorNormalTaskBarAppText = ""rgb:00/00/00""" +Text color for task buttons of regular windows. +.IP "\fBColorActiveTaskBarApp\fR = ""rgb:E0/E0/E0""" 4 +.IX Item "ColorActiveTaskBarApp = ""rgb:E0/E0/E0""" +Background for task buttons of the active window. +.IP "\fBColorActiveTaskBarAppText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorActiveTaskBarAppText = ""rgb:00/00/00""" +Text color for task buttons of the active window. +.IP "\fBColorMinimizedTaskBarApp\fR = ""rgb:A0/A0/A0""" 4 +.IX Item "ColorMinimizedTaskBarApp = ""rgb:A0/A0/A0""" +Background for task buttons of minimized windows. +.IP "\fBColorMinimizedTaskBarAppText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorMinimizedTaskBarAppText = ""rgb:00/00/00""" +Text color for task buttons of minimized windows. +.IP "\fBColorInvisibleTaskBarApp\fR = ""rgb:80/80/80""" 4 +.IX Item "ColorInvisibleTaskBarApp = ""rgb:80/80/80""" +Background for task buttons of windows on other workspaces. +.IP "\fBColorInvisibleTaskBarAppText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorInvisibleTaskBarAppText = ""rgb:00/00/00""" +Text color for task buttons of windows on other workspaces. +.IP "\fBColorScrollBar\fR = ""rgb:A0/A0/A0""" 4 +.IX Item "ColorScrollBar = ""rgb:A0/A0/A0""" +Scrollbar background (sliding area). +.IP "\fBColorScrollBarSlider\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorScrollBarSlider = ""rgb:C0/C0/C0""" +Background of the slider button in scrollbars. +.IP "\fBColorScrollBarButton\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorScrollBarButton = ""rgb:C0/C0/C0""" +Background of the arrow buttons in scrollbars. +.IP "\fBColorScrollBarArrow\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorScrollBarArrow = ""rgb:C0/C0/C0""" +Background of the arrow buttons in scrollbars (obsolete). +.IP "\fBColorScrollBarButtonArrow\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorScrollBarButtonArrow = ""rgb:00/00/00""" +Color of active arrows on scrollbar buttons. +.IP "\fBColorScrollBarInactiveArrow\fR = ""rgb:80/80/80""" 4 +.IX Item "ColorScrollBarInactiveArrow = ""rgb:80/80/80""" +Color of inactive arrows on scrollbar buttons. +.IP "\fBColorListBox\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorListBox = ""rgb:C0/C0/C0""" +Background of listboxes. +.IP "\fBColorListBoxText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorListBoxText = ""rgb:00/00/00""" +Text color in listboxes. +.IP "\fBColorListBoxSelection\fR = ""rgb:80/80/80""" 4 +.IX Item "ColorListBoxSelection = ""rgb:80/80/80""" +Background of selected listbox items. +.IP "\fBColorListBoxSelectionText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorListBoxSelectionText = ""rgb:00/00/00""" +Text color of selected listbox items. +.IP "\fBColorToolTip\fR = ""rgb:E0/E0/00""" 4 +.IX Item "ColorToolTip = ""rgb:E0/E0/00""" +Background of tooltips. +.IP "\fBColorToolTipText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorToolTipText = ""rgb:00/00/00""" +Text color of tooltips. +.IP "\fBColorLabel\fR = ""rgb:C0/C0/C0""" 4 +.IX Item "ColorLabel = ""rgb:C0/C0/C0""" +Background of labels, leave empty to force transparency. +.IP "\fBColorLabelText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorLabelText = ""rgb:00/00/00""" +Text color of labels. +.IP "\fBColorInput\fR = ""rgb:FF/FF/FF""" 4 +.IX Item "ColorInput = ""rgb:FF/FF/FF""" +Background of text entry fields (e.g., the addressbar). +.IP "\fBColorInputText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorInputText = ""rgb:00/00/00""" +Text color of text entry fields (e.g., the addressbar). +.IP "\fBColorInputSelection\fR = ""rgb:80/80/80""" 4 +.IX Item "ColorInputSelection = ""rgb:80/80/80""" +Background of selected text in an entry field. +.IP "\fBColorInputSelectionText\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorInputSelectionText = ""rgb:00/00/00""" +Selected text in an entry field. +.IP "\fBColorClock\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorClock = ""rgb:00/00/00""" +Background of non-LCD clock, leave empty to force transparency. +.IP "\fBColorClockText\fR = ""rgb:00/FF/00""" 4 +.IX Item "ColorClockText = ""rgb:00/FF/00""" +Text color of non-LCD clock. +.IP "\fBColorKeyboardLayoutText\fR = """"" 4 +.IX Item "ColorKeyboardLayoutText = """"" +Color of keyboard layout indicator. +.IP "\fBColorApm\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorApm = ""rgb:00/00/00""" +Background of battery monitor, leave empty to force transparency. +.IP "\fBColorApmText\fR = ""rgb:00/FF/00""" 4 +.IX Item "ColorApmText = ""rgb:00/FF/00""" +Text color of battery monitor. +.IP "\fBColorApmBattery\fR = ""rgb:FF/FF/00""" 4 +.IX Item "ColorApmBattery = ""rgb:FF/FF/00""" +Color of battery monitor when discharging. +.IP "\fBColorApmLine\fR = ""rgb:00/FF/00""" 4 +.IX Item "ColorApmLine = ""rgb:00/FF/00""" +Color of battery monitor when charging. +.IP "\fBColorApmGraphBg\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorApmGraphBg = ""rgb:00/00/00""" +Background color for graph mode. +.IP "\fBColorCPUStatusUser\fR = ""rgb:00/FF/00""" 4 +.IX Item "ColorCPUStatusUser = ""rgb:00/FF/00""" +User load on the CPU monitor. +.IP "\fBColorCPUStatusSystem\fR = ""rgb:FF/00/00""" 4 +.IX Item "ColorCPUStatusSystem = ""rgb:FF/00/00""" +System load on the CPU monitor. +.IP "\fBColorCPUStatusInterrupts\fR = ""rgb:FF/FF/00""" 4 +.IX Item "ColorCPUStatusInterrupts = ""rgb:FF/FF/00""" +Interrupts on the CPU monitor. +.IP "\fBColorCPUStatusIoWait\fR = ""rgb:60/00/60""" 4 +.IX Item "ColorCPUStatusIoWait = ""rgb:60/00/60""" +IO Wait on the CPU monitor. +.IP "\fBColorCPUStatusSoftIrq\fR = ""rgb:00/FF/FF""" 4 +.IX Item "ColorCPUStatusSoftIrq = ""rgb:00/FF/FF""" +Soft Interrupts on the CPU monitor. +.IP "\fBColorCPUStatusNice\fR = ""rgb:00/00/FF""" 4 +.IX Item "ColorCPUStatusNice = ""rgb:00/00/FF""" +Nice load on the CPU monitor. +.IP "\fBColorCPUStatusIdle\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorCPUStatusIdle = ""rgb:00/00/00""" +Idle (non) load on the CPU monitor, leave empty to force +transparency. +.IP "\fBColorCPUStatusSteal\fR = ""rgb:FF/8A/91""" 4 +.IX Item "ColorCPUStatusSteal = ""rgb:FF/8A/91""" +Involuntary Wait on the CPU monitor. +.IP "\fBColorCPUStatusTemp\fR = ""rgb:60/60/C0""" 4 +.IX Item "ColorCPUStatusTemp = ""rgb:60/60/C0""" +Temperature of the CPU. +.IP "\fBColorMEMStatusUser\fR = ""rgb:40/40/80""" 4 +.IX Item "ColorMEMStatusUser = ""rgb:40/40/80""" +User program usage in the memory monitor. +.IP "\fBColorMEMStatusBuffers\fR = ""rgb:60/60/C0""" 4 +.IX Item "ColorMEMStatusBuffers = ""rgb:60/60/C0""" +OS buffers usage in the memory monitor. +.IP "\fBColorMEMStatusCached\fR = ""rgb:80/80/FF""" 4 +.IX Item "ColorMEMStatusCached = ""rgb:80/80/FF""" +OS cached usage in the memory monitor. +.IP "\fBColorMEMStatusFree\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorMEMStatusFree = ""rgb:00/00/00""" +Free memory in the memory monitor. +.IP "\fBColorNetSend\fR = ""rgb:FF/FF/00""" 4 +.IX Item "ColorNetSend = ""rgb:FF/FF/00""" +Outgoing load on the network monitor. +.IP "\fBColorNetReceive\fR = ""rgb:FF/00/FF""" 4 +.IX Item "ColorNetReceive = ""rgb:FF/00/FF""" +Incoming load on the network monitor. +.IP "\fBColorNetIdle\fR = ""rgb:00/00/00""" 4 +.IX Item "ColorNetIdle = ""rgb:00/00/00""" +Idle (non) load on the network monitor, leave empty to force transparency. +.PP +\fIDESKTOP BACKGROUND\fR +.IX Subsection "DESKTOP BACKGROUND" +.PP +The following themeable preferences are read by \fBicewmbg\fR\|(1): +.IP "\fBDesktopBackgroundCenter\fR=0 0/1" 4 +.IX Item "DesktopBackgroundCenter=0 0/1" +Display desktop background centered and not tiled. +.IP "\fBDesktopBackgroundScaled\fR=0 0/1" 4 +.IX Item "DesktopBackgroundScaled=0 0/1" +Resize desktop background to full screen. +.IP "\fBDesktopBackgroundColor\fR=""""" 4 +.IX Item "DesktopBackgroundColor=""""" +A comma-separated list of zero or more desktop background colors. +.IP "\fBDesktopBackgroundImage\fR=""""" 4 +.IX Item "DesktopBackgroundImage=""""" +A comma-separated list of zero or more desktop background images. +Each image may be a path with a \fBglob\fR\|(7) pattern, or start with a +tilde or environment variable. +.IP "\fBShuffleBackgroundImages\fR=0 0/1" 4 +.IX Item "ShuffleBackgroundImages=0 0/1" +Choose a random selection from the list of background images. +.IP "\fBSupportSemitransparency\fR=1 0/1" 4 +.IX Item "SupportSemitransparency=1 0/1" +Support for semitransparent terminals like Eterm or gnome-terminal. +.IP "\fBDesktopTransparencyColor\fR=""""" 4 +.IX Item "DesktopTransparencyColor=""""" +Color(s) to announce for semitransparent windows. +.IP "\fBDesktopTransparencyImage\fR=""""" 4 +.IX Item "DesktopTransparencyImage=""""" +Image(s) to announce for semitransparent windows. +This is a list similar to \fBDesktopBackgroundImage\fR. +.IP "\fBDesktopBackgroundMultihead\fR=0 0/1" 4 +.IX Item "DesktopBackgroundMultihead=0 0/1" +Paint the background image over all multihead monitors combined. +.IP \fBCycleBackgroundsPeriod\fR=0 4 +.IX Item "CycleBackgroundsPeriod=0" +Seconds between cycling over all background images, default zero is off. +.SS EXAMPLES +.IX Subsection "EXAMPLES" +.Vb 10 +\& Alpha=1 +\& Splash="IceWM.jpg" +\& LimitSize=0 +\& LimitPosition=0 +\& LimitByDockLayer=1 +\& QuickSwitchToAllWorkspaces=1 +\& QuickSwitchHugeIcon=1 +\& QuickSwitchFillSelection=1 +\& TaskBarMailboxStatusBeepOnNewMail=1 +\& TaskBarMailboxStatusCountMessages=1 +\& TaskBarShowMEMStatus=0 +\& TaskBarShowCollapseButton=1 +\& TaskBarWorkspacesLimit="8" +\& ShowProgramsMenu=1 +\& ShowAddressBar=0 +\& ToolTipDelay=200 +\& ToolTipTime=5000 +\& AutoHideDelay=900 +\& AutoShowDelay=100 +\& EdgeResistance=3 +\& KeySysWinMenu="" +\& KeySysWinListMenu="Shift+Ctrl+Esc" +.Ve +.PP +The above example shows how to tell \fBicewm\fR to not bind a specific key: +\&\fIKeySysWinMenu\fR in this case. +.SS FILES +.IX Subsection "FILES" +Locations for the \fIpreferences\fR file are as follows: +.PP +.Vb 5 +\& $ICEWM_PRIVCFG/preferences +\& $XDG_CONFIG_HOME/icewm/preferences +\& $HOME/.icewm/preferences +\& /etc/icewm/preferences +\& /usr/share/icewm/preferences +.Ve +.PP +The locations are searched in the order listed; the first file found is +read and the remainder ignored. +.SS "SEE ALSO" +.IX Subsection "SEE ALSO" +\&\fBicewm\fR\|(1), +\&\fBicewm\-prefoverride\fR\|(5). +.SS AUTHOR +.IX Subsection "AUTHOR" +Brian Bidulock <mailto:bidulock@openss7.org>. +.SS LICENSE +.IX Subsection "LICENSE" +\&\fBIceWM\fR is licensed under the GNU Library General Public License. +See the \fICOPYING\fR file in the distribution. |