.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "labwc-theme" "5" "2025-12-20"
.PP
.SH NAME
.PP
labwc - theme files
.PP
.SH THEME
.PP
The theme engine aims to be compatible with openbox and themes will be
searched for in the following order:
.PP
.PD 0
.IP \(bu 4
${XDG_DATA_HOME:-$HOME/.\&local/share}/themes/<theme-name>/labwc/
.IP \(bu 4
$HOME/.\&themes/<theme-name>/labwc/
.IP \(bu 4
/usr/share/themes/<theme-name>/labwc/
.IP \(bu 4
/usr/local/share/themes/<theme-name>/labwc/
.IP \(bu 4
/opt/share/themes/<theme-name>/labwc/
.IP \(bu 4
${XDG_DATA_HOME:-$HOME/.\&local/share}/themes/<theme-name>/openbox-3/
.IP \(bu 4
$HOME/.\&themes/<theme-name>/openbox-3/
.IP \(bu 4
/usr/share/themes/<theme-name>/openbox-3/
.IP \(bu 4
/usr/local/share/themes/<theme-name>/openbox-3/
.IP \(bu 4
/opt/share/themes/<theme-name>/openbox-3/
.PD
.PP
When $XDG_DATA_HOME is defined, it replaces (rather than augments)
$HOME/.\&local/share.\& The same is the case for $XDG_DATA_DIRS and /usr/share/.\&
.PP
Choosing a theme is done by editing the <name> key in the <theme> section of
the rc.\&xml configuration file (labwc-config(5)).\&
.PP
A theme consists of a themerc file and optionally some titlebar icons (referred
to as buttons).\&
.PP
Theme settings specified in themerc can be overridden by creating a
\&'\&themerc-override'\& file in the configuration directory, which is normally
$HOME/.\&config/labwc/ but can be a few other locations as described in
labwc-config(5).\&
.PP
.SH DATA TYPES
.PP
\fBcolor\fR
.RS 4
Colors can be specified by name or hexadecimal Red-Green-Blue (RGB)
value:
.PP
\fBcolor name\fR refers to "X11 color name", for example: '\&white'\&, '\&grey40'\&,
\&'\&pink'\& and '\&peach puff'\&.\& More information can be found here:
.PD 0
.IP \(bu 4
http://en.\&wikipedia.\&org/wiki/Web_colors#X11_color_names
.IP \(bu 4
http://en.\&wikipedia.\&org/wiki/X11_color_names
.IP \(bu 4
https://github.\&com/labwc/labwc/blob/master/src/common/rgb.\&txt
.PD
.PP
\fBRGB value\fR
.PP
.PD 0
.IP \(bu 4
#rrggbb (hexadecimal RGB values)
.IP \(bu 4
#rrggbb aaa (same but with decimal alpha value percentage)
.IP \(bu 4
#rrggbbaa (same but with inline alpha value in hex encoding)
.IP \(bu 4
#rgb (hexadecimal RGB values where #fff is shorthand for #f0f0f0)
(since 0.\&9.\&0)
.PD
.PP
Note: the #rrggbb aaa notation is deprecated starting from
labwc 0.\&7.\&2 and may be removed in future releases.\&
.PP
.RE
\fBjustification\fR
.RS 4
Justification determines the horizontal alignment of text.\&
Valid options are Left, Center and Right.\&
.PP
.RE
\fBtextures\fR
.RS 4
Textures determine the visual look of an element.\& They are specified
through a text string with a number of fields.\& Capitalization is not
significant.\& The format is as follows:
.PP
.RE
.nf
.RS 4
(Solid | Gradient <type>)
.fi
.RE
.PP
.RS 4
\&.\&.\& where \fB|\fR stands for "or".\&
.PP
.PD 0
.IP \(bu 4
\fBSolid\fR means that the background of the texture is filled with a
single color.\& The texture must be accompanied by a single color field.\&
For example:
.PD
.PP
.RE
.nf
.RS 4
window\&.*\&.title\&.bg: Solid
window\&.*\&.title\&.bg\&.color: #f8f5f2
.fi
.RE
.PP
.RS 4
.PD 0
.IP \(bu 4
\fBGradient\fR means that the background of the texture is filled with a
gradient from one color to another.\& When Gradient is specified, it
must be followed by the gradient'\&s type.\& It must also be accompanied
by the fields \fBcolor\fR and \fBcolorTo\fR.\& Valid gradient types are:
(1) \fBVertical\fR where the gradient goes from the top edge to the bottom
(2) \fBSplitVertical\fR where the gradient is split in the middle and goes
out toward the top and bottom edges.\& SplitVertical gradients have two
extra, optional color fields: \fBcolor.\&splitTo\fR and \fBcolorTo.\&splitTo\fR.\&
These colors are the light colors used on the far top and bottom of
the SplitVertical gradient.\& When these are omitted, the default values
for these are \fBcolor x 5/4\fR and \fBcolorTo x 17/16\fR.\& Examples:
.PD
.PP
.RE
.nf
.RS 4
# Vertical gradient
window\&.*\&.title\&.bg: Gradient Vertical
window\&.*\&.title\&.bg\&.color: #658fb5
window\&.*\&.title\&.bg\&.colorTo: #4d6982

# SplitVertical gradient
window\&.*\&.title\&.bg: Gradient SplitVertical
window\&.*\&.title\&.bg\&.color: #658fb5
window\&.*\&.title\&.bg\&.color\&.splitTo: #7595b9
window\&.*\&.title\&.bg\&.colorTo: #4d6982
window\&.*\&.title\&.bg\&.colorTo\&.splitTo: #557485
.fi
.RE
.PP
.SH THEME ELEMENTS
.PP
\fBborder.\&width\fR
.RS 4
Line width (integer) of border drawn around window frames.\&
Default is 1.\&
.PP
.RE
\fBwindow.\&titlebar.\&padding.\&width\fR
.RS 4
Horizontal titlebar padding size, in pixels, between border and first
button on the left/right.\&
Default is 0.\&
.PP
.RE
\fBwindow.\&titlebar.\&padding.\&height\fR
.RS 4
Vertical titlebar padding size, in pixels.\&
Default is 0.\&
.PP
.RE
\fBwindow.\&active.\&border.\&color\fR
.RS 4
Border color of active window.\& Default is #aaaaaa.\&
.PP
.RE
\fBwindow.\&inactive.\&border.\&color\fR
.RS 4
Border color of inactive window.\& Default is #aaaaaa.\&
.PP
.RE
\fBwindow.\&active.\&indicator.\&toggled-keybind.\&color\fR
.RS 4
Status indicator for the ToggleKeybinds action.\& Can be set to the same
value as set for window.\&active.\&border.\&color to disable the status
indicator.\& Default is #ff0000.\&
.PP
.RE
\fBwindow.\&active.\&title.\&bg\fR
.RS 4
Texture for the focused window'\&s titlebar.\& See texture section above.\&
Default is \fBSolid\fR
.PP
.RE
\fBwindow.\&active.\&title.\&bg.\&color\fR
.RS 4
Background color for the focused window'\&s titlebar.\& See texture section
for additional color fields associated with gradients.\&
Default is #e1dedb.\&
.PP
.RE
\fBwindow.\&inactive.\&title.\&bg\fR
.RS 4
Texture for non-focused windows'\& titlebars.\& See texture section above.\&
Default is \fBSolid\fR
.PP
.RE
\fBwindow.\&inactive.\&title.\&bg.\&color\fR
.RS 4
Background color for non-focused windows'\& titlebars.\& See texture section
for additional color fields associated with gradients.\&
Default is #f6f5f4.\&
.PP
.RE
\fBwindow.\&active.\&label.\&text.\&color\fR
.RS 4
Text color for the focused window'\&s titlebar.\& Default is #000000.\&
.PP
.RE
\fBwindow.\&inactive.\&label.\&text.\&color\fR
.RS 4
Text color non-focused windows'\& titlebars.\& Default is #000000.\&
.PP
.RE
\fBwindow.\&label.\&text.\&justify\fR
.RS 4
Specifies how window titles are aligned in the titlebar for both
focused and unfocused windows.\& Type justification.\& Default is Center.\&
.PP
.RE
\fBwindow.\&button.\&width\fR
.RS 4
Width of a titlebar button, in pixels.\&
Default is 26.\&
.PP
.RE
\fBwindow.\&button.\&height\fR
.RS 4
Height of a titlebar button, in pixels.\&
Default is 26.\&
.PP
.RE
\fBwindow.\&button.\&spacing\fR
.RS 4
Space between titlebar buttons, in pixels.\&
Default is 0.\&
.PP
.RE
\fBwindow.\&button.\&hover.\&bg.\&corner-radius\fR
.RS 4
Radius of the hover effect of a titlebar button, in pixels.\&
Default is 0.\&
.PP
Note: for a circular hover effect, set \fBwindow.\&button.\&width\fR and
\fBwindow.\&button.\&height\fR equal and \fBwindow.\&button.\&hover.\&bg.\&corner-radius\fR
half of them.\&
.PP
.RE
\fBwindow.\&active.\&button.\&unpressed.\&image.\&color\fR
.RS 4
Color of the images in titlebar buttons in their default, unpressed,
state.\& This element is for the focused window.\& Default is #000000.\&
.PP
.RE
\fBwindow.\&inactive.\&button.\&unpressed.\&image.\&color\fR
.RS 4
Color of the images in titlebar buttons in their default, unpressed,
state.\& This element is for non-focused windows.\& Default is #000000.\&
.PP
.RE
Note: Button elements (i.\&e.\& window.\&[in]active.\&button.\&*) may be defined uniquely
for each type of button ("menu", "iconify", "max", "shade", "desk" or "close")
by appending the type after the "button" node.\& For example:
.PP
.PD 0
.IP \(bu 4
window.\&active.\&button.\&iconify.\&unpressed.\&image.\&color indicates the color of the
.PD
iconify button for active windows; while
.PP
.PD 0
.IP \(bu 4
window.\&inactive.\&button.\&close.\&unpressed.\&image.\&color indicates the color of the
.PD
close button for inactive windows.\&
.PP
This syntax is not documented by Openbox, but is supported and is used by many
popular themes.\& For the sake of brevity, these elements are not listed here, but
all are supported.\&
.PP
\fBwindow.\&active.\&shadow.\&size\fR
.RS 4
Size of the drop-shadow for the focused window, in pixels.\&
Default is 60.\&
.PP
.RE
\fBwindow.\&inactive.\&shadow.\&size\fR
.RS 4
Size of drop-shadows for non-focused windows, in pixels.\&
Default is 40.\&
.PP
.RE
\fBwindow.\&active.\&shadow.\&color\fR
.RS 4
Color of the drop-shadow for the focused window, including opacity.\&
Default is #00000060 (black with 38% opacity).\&
.PP
.RE
\fBwindow.\&inactive.\&shadow.\&color\fR
.RS 4
Color of drop-shadows for non-focused windows, including opacity.\&
Default is #00000040 (black with 25% opacity).\&
.PP
.RE
\fBmenu.\&overlap.\&x\fR
.RS 4
Horizontal overlap in pixels between submenus and their parents.\& A
positive value move submenus over the top of their parents, whereas a
negative value creates a gap between submenus and their parents.\&
Default is 0.\&
.PP
.RE
\fBmenu.\&overlap.\&y\fR
.RS 4
Vertical offset in pixels between submenus and their parents.\& Positive
values for downwards and negative for upwards.\& Default is 0.\&
.PP
.RE
\fBmenu.\&width.\&min\fR
.RS 4
Minimal width for menus.\& Default is 20.\&
A fixed width can be achieved by setting .\&min and .\&max to the same
value.\&
.PP
.RE
\fBmenu.\&width.\&max\fR
.RS 4
Maximal width for menus.\& Default is 200.\&
A fixed width can be achieved by setting .\&min and .\&max to the same
value.\&
.PP
.RE
\fBmenu.\&border.\&width\fR
.RS 4
Border width of menus in pixels.\& Inherits \fBborder.\&width\fR if not set.\&
.PP
.RE
\fBmenu.\&border.\&color\fR
.RS 4
Border color of menus.\& Inherits \fBwindow.\&active.\&border.\&color\fR if not set.\&
.PP
.RE
\fBmenu.\&items.\&padding.\&x\fR
.RS 4
Horizontal padding of menu text entries in pixels.\&
Default is 7.\&
.PP
.RE
\fBmenu.\&items.\&padding.\&y\fR
.RS 4
Vertical padding of menu text entries in pixels.\&
Default is 4.\&
.PP
.RE
\fBmenu.\&items.\&bg.\&color\fR
.RS 4
Background color of inactive menu items.\& Default is #fcfbfa.\&
.PP
.RE
\fBmenu.\&items.\&text.\&color\fR
.RS 4
Text color of inactive menu item.\& Default is #000000.\&
.PP
.RE
\fBmenu.\&items.\&active.\&bg.\&color\fR
.RS 4
Background color of active menu items.\& Default is #e1dedb.\&
.PP
.RE
\fBmenu.\&items.\&active.\&text.\&color\fR
.RS 4
Text color of active menu item.\& Default is #000000.\&
.PP
.RE
\fBmenu.\&separator.\&width\fR
.RS 4
Line thickness of menu separators.\& Default is 1.\&
.PP
.RE
\fBmenu.\&separator.\&padding.\&width\fR
.RS 4
Space on the left and right side of each separator line.\& Default is 6.\&
.PP
.RE
\fBmenu.\&separator.\&padding.\&height\fR
.RS 4
Space above and below each separator line.\& Default is 3.\&
.PP
.RE
\fBmenu.\&separator.\&color\fR
.RS 4
Menu separator color.\& Default is #888888.\&
.PP
.RE
\fBmenu.\&title.\&bg.\&color\fR
.RS 4
Menu title color.\& Default is #589bda.\&
Note: A menu title is a separator with a label.\&
.PP
.RE
\fBmenu.\&title.\&text.\&justify\fR
.RS 4
Specifies how menu titles are aligned in the titlebar.\&
Type justification.\& Default is Center.\&
.PP
.RE
\fBmenu.\&title.\&text.\&color\fR
.RS 4
Text color of separator label.\& Default is #ffffff.\&
.PP
.RE
\fBosd.\&bg.\&color\fR
.RS 4
Background color of on-screen-display.\& Inherits
\fBwindow.\&active.\&title.\&bg.\&color\fR if not set.\&
.PP
.RE
\fBosd.\&border.\&color\fR
.RS 4
Border color of on-screen-display.\& Inherits \fBosd.\&label.\&text.\&color\fR if
not set.\&
.PP
.RE
\fBosd.\&border.\&width\fR
.RS 4
Border width of on-screen-display.\& Inherits \fBborder.\&width\fR if not set.\&
.PP
.RE
\fBosd.\&label.\&text.\&color\fR
.RS 4
Text color of on-screen-display.\& Inherits
\fBwindow.\&active.\&label.\&text.\&color\fR if not set.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic\fR
.RS 4
Theme for window switcher when using <windowSwitcher style="classic" />.\&
See below for details.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic.\&width\fR
.RS 4
Width of window switcher in pixels.\& Width can also be a percentage of
the monitor width by adding '\&%'\& as suffix (e.\&g.\& 70%).\& Default is 600.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic.\&padding\fR
.RS 4
Padding of window switcher in pixels.\& This is the space between the
window-switcher border and its items.\& Default is 4.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic.\&item.\&padding.\&x\fR
.RS 4
Horizontal padding of window switcher entries in pixels.\&
Default is 10.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic.\&item.\&padding.\&y\fR
.RS 4
Vertical padding of window switcher entries in pixels.\&
Default is 1.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic.\&item.\&active.\&border.\&width\fR
.RS 4
Border width of the selection box in the window switcher in pixels.\&
Default is 2.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic.\&item.\&active.\&border.\&color\fR
.RS 4
Border color around the selected window switcher item.\&
Default is \fBosd.\&label.\&text.\&color\fR with 50% opacity.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic.\&item.\&active.\&bg.\&color\fR
.RS 4
Background color of the selected window switcher item.\&
Default is \fBosd.\&label.\&text.\&color\fR with 15% opacity.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-classic.\&item.\&icon.\&size\fR
.RS 4
Size of the icon in window switcher, in pixels.\&
If not set, the font size derived from
<theme><font place="OnScreenDisplay"> is used.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail\fR
.RS 4
Theme for window switcher when using
<windowSwitcher style="thumbnail" />.\& See below for details.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&width.\&max\fR
.RS 4
Maximum width of window switcher in pixels.\& Width can also be a
percentage of the monitor width by adding '\&%'\& as suffix (e.\&g.\& 70%).\&
Default is 80%.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&padding\fR
.RS 4
Padding of window switcher in pixels.\& This is the space between the
window-switcher border and its items.\& Default is 4.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&item.\&width\fR
.RS 4
Width of window switcher items in pixels.\& Default is 300.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&item.\&height\fR
.RS 4
Height of window switcher items in pixels.\& Default is 250.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&item.\&padding\fR
.RS 4
Padding of window switcher items in pixels.\& This is the space between
the border around selected items and window thumbnail.\& Default is 2.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&item.\&active.\&border.\&width\fR
.RS 4
Border width of selected window switcher items in pixels.\& Default is 2.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&item.\&active.\&border.\&color\fR
.RS 4
Color of border around selected window switcher items.\&
Default is \fBosd.\&label.\&text.\&color\fR with 50% opacity.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&item.\&active.\&bg.\&color\fR
.RS 4
Color of selected window switcher items.\&
Default is \fBosd.\&label.\&text.\&color\fR with 15% opacity.\&
.PP
.RE
\fBosd.\&window-switcher.\&style-thumbnail.\&item.\&icon.\&size\fR
.RS 4
Size of window icons in window switcher items in pixels.\& Default is 60.\&
.PP
.RE
\fBosd.\&window-switcher.\&preview.\&border.\&width\fR
.RS 4
Border width of the outlines shown as the preview of the window selected
by window switcher.\& Inherits \fBosd.\&border.\&width\fR if not set.\&
.PP
.RE
\fBosd.\&window-switcher.\&preview.\&border.\&color\fR
.RS 4
Color(s) of the outlines shown as the preview of the window selected by
window switcher.\& Possible value is a color or up to 3 colors separated
by commas (e.\&g.\& "#ffffff,#000000,#ffffff").\& When multiple colors are
specified, a multi-line rectangle with each line having the specified
color is drawn.\& If not set, this inherits the on-screen-display theme
("[\fBosd.\&bg.\&color\fR],[\fBosd.\&label.\&text.\&color\fR],[\fBosd.\&bg.\&color\fR]").\&
.PP
.RE
\fBosd.\&workspace-switcher.\&boxes.\&width\fR
.RS 4
Width of boxes in workspace switcher in pixels.\& Setting to 0 disables
boxes.\& Default is 20.\&
.PP
.RE
\fBosd.\&workspace-switcher.\&boxes.\&height\fR
.RS 4
Height of boxes in workspace switcher in pixels.\& Setting to 0 disables
boxes.\& Default is 20.\&
.PP
.RE
\fBosd.\&workspace-switcher.\&boxes.\&border.\&width\fR
.RS 4
Border width of boxes in workspace switcher in pixels.\& Default is 2.\&
.PP
.RE
\fBsnapping.\&overlay.\&region.\&bg.\&enabled\fR [yes|no]
.RS 4
Show a filled rectangle as an overlay when a window is snapped to a
region.\& Default is yes for hardware-based renderers and no for
software-based renderers.\&
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&bg.\&enabled\fR [yes|no]
.RS 4
Show a filled rectangle as an overlay when a window is snapped to an
edge.\& Default is yes for hardware-based renderer and no for
software-based renderers.\&
.PP
.RE
\fBsnapping.\&overlay.\&region.\&border.\&enabled\fR [yes|no]
.RS 4
Show an outlined rectangle as an overlay when a window is snapped to a
region.\& Default is no for hardware-based renderers and yes for
software-based renderers.\&
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&border.\&enabled\fR [yes|no]
.RS 4
Show an outlined rectangle as an overlay when a window is snapped to an
edge.\& Default is no for hardware-based renderer and yes for
software-based renderers.\&
.PP
.RE
\fBsnapping.\&overlay.\&region.\&bg.\&color\fR
.RS 4
Color of a filled rectangle shown as an overlay when a window is snapped
to a region.\& Default is #8080b380.\&
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&bg.\&color\fR
.RS 4
Color of a filled rectangle shown as an overlay when a window is snapped
to an edge.\& Default is #8080b380.\&
.PP
.RE
\fBsnapping.\&overlay.\&region.\&border.\&width\fR
.RS 4
Border width of an outlined rectangle shown as an overlay when a window
is snapped to a region.\& Inherits `osd.\&border.\&width` if not set.\&
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&border.\&width\fR
.RS 4
Border width of an outlined rectangle shown as an overlay when a window
is snapped to an edge.\& Inherits `osd.\&border.\&width` if not set.\&
.PP
.RE
\fBsnapping.\&overlay.\&region.\&border.\&color\fR
.RS 4
Color(s) of an outlined rectangle shown as an overlay when a window is
snapped to a region.\& Possible values and the default value are the same
as those of \fBosd.\&window-switcher.\&preview.\&border.\&color\fR.\&
.PP
.RE
\fBsnapping.\&overlay.\&edge.\&border.\&color\fR
.RS 4
Color(s) of an outlined rectangle shown as an overlay when a window is
snapped to an edge.\& Possible values and the default value are the same
as those of \fBosd.\&window-switcher.\&preview.\&border.\&color\fR.\&
.PP
.RE
\fBborder.\&color\fR
.RS 4
Set both \fBwindow.\&active.\&border.\&color\fR and
\fBwindow.\&inactive.\&border.\&color\fR.\& This is obsolete, but supported for
backward compatibility as some themes still contain it.\&
.PP
.RE
\fBmagnifier.\&border.\&width\fR
.RS 4
Width of magnifier window border in pixels.\& Default is 1.\&
.PP
.RE
\fBmagnifier.\&border.\&color\fR
.RS 4
Color of the magnfier window border.\& Default is #ff0000 (red).\&
.PP
.RE
.SH BUTTONS
.PP
The images used for the titlebar icons are referred to as buttons.\&
.PP
The image formats listed below are supported.\& They are listed in order of
precedence, where the first format in the list is searched for first.\&
.PP
.PD 0
.IP \(bu 4
png
.IP \(bu 4
svg
.IP \(bu 4
xbm
.PD
.PP
By default, buttons are 1-bit xbm (X Bitmaps).\& These are masks where 0=clear and
1=colored.\& The xbm image files are placed in the same directory as the themerc
file within a particular theme.\& The following xbm buttons are supported:
.PP
.PD 0
.IP \(bu 4
max.\&xbm
.IP \(bu 4
iconify.\&xbm
.IP \(bu 4
close.\&xbm
.IP \(bu 4
menu.\&xbm
.IP \(bu 4
max_toggled.\&xbm
.IP \(bu 4
desk.\&xbm
.IP \(bu 4
desk_toggled.\&xbm
.IP \(bu 4
shade.\&xbm
.IP \(bu 4
shade_toggled.\&xbm
.PD
.PP
Additional icons can be defined to be shown when the mouse pointer is hovering
over the button in question:
.PP
.PD 0
.IP \(bu 4
max_hover.\&xbm
.IP \(bu 4
iconify_hover.\&xbm
.IP \(bu 4
close_hover.\&xbm
.IP \(bu 4
menu_hover.\&xbm
.IP \(bu 4
max_toggled_hover.\&xbm
.IP \(bu 4
desk_hover.\&xbm
.IP \(bu 4
desk_toggle_hover.\&xbm
.IP \(bu 4
shade_hover.\&xbm
.IP \(bu 4
shade_toggle_hover.\&xbm
.PD
.PP
One advantage of xbm buttons over other formats is that they change color based
on the theme.\& Other formats use the suffices "-active" and "-inactive" to align
with the respective titlebar colors.\& For example: "close-active.\&png"
.PP
For compatibility reasons, the following alternative names are supported
for xbm files:
.PP
.PD 0
.IP \(bu 4
max_hover_toggled.\&xbm for max_toggled_hover.\&xbm
.PD
.PP
When using png or svg icons, for a full theme experience all of the
following icons should be added:
.PP
.PD 0
.IP \(bu 4
close-active.\&[png|svg]
.IP \(bu 4
close_hover-active.\&[png|svg]
.IP \(bu 4
close_hover-inactive.\&[png|svg]
.IP \(bu 4
close-inactive.\&[png|svg]
.IP \(bu 4
iconify-active.\&[png|svg]
.IP \(bu 4
iconify_hover-active.\&[png|svg]
.IP \(bu 4
iconify_hover-inactive.\&[png|svg]
.IP \(bu 4
iconify-inactive.\&[png|svg]
.IP \(bu 4
max-active.\&[png|svg]
.IP \(bu 4
max_hover-active.\&[png|svg]
.IP \(bu 4
max_hover-inactive.\&[png|svg]
.IP \(bu 4
max-inactive.\&[png|svg]
.IP \(bu 4
max_toggled-active.\&[png|svg]
.IP \(bu 4
max_toggled_hover-active.\&[png|svg]
.IP \(bu 4
max_toggled_hover-inactive.\&[png|svg]
.IP \(bu 4
max_toggled-inactive.\&[png|svg]
.IP \(bu 4
menu-active.\&[png|svg]
.IP \(bu 4
menu_hover-active.\&[png|svg]
.IP \(bu 4
menu_hover-inactive.\&[png|svg]
.IP \(bu 4
menu-inactive.\&[png|svg]
.IP \(bu 4
shade-active.\&[png|svg]
.IP \(bu 4
shade_hover-active.\&[png|svg]
.IP \(bu 4
shade_hover-inactive.\&[png|svg]
.IP \(bu 4
shade-inactive.\&[png|svg]
.IP \(bu 4
shade_toggled-active.\&[png|svg]
.IP \(bu 4
shade_toggled-inactive.\&[png|svg]
.IP \(bu 4
shade_toggled_hover-active.\&[png|svg]
.IP \(bu 4
shade_toggled_hover-inactive.\&[png|svg]
.IP \(bu 4
desk-active.\&[png|svg]
.IP \(bu 4
desk_hover-active.\&[png|svg]
.IP \(bu 4
desk_hover-inactive.\&[png|svg]
.IP \(bu 4
desk-inactive.\&[png|svg]
.IP \(bu 4
desk_toggled-active.\&[png|svg]
.IP \(bu 4
desk_toggled-inactive.\&[png|svg]
.IP \(bu 4
desk_toggled_hover-active.\&[png|svg]
.IP \(bu 4
desk_toggled_hover-inactive.\&[png|svg]
.PD
.PP
.SH DEFINITIONS
.PP
The handle is the window edge decoration at the bottom of the window.\&
.PP
.SH SEE ALSO
.PP
labwc(1), labwc-config(5), labwc-actions(5)