labwc-theme - Man Page

The theme engine aims to be compatible with openbox and themes will be searched for in the following order:

Choosing a theme is done by editing the <name> key in the <theme> section of the rc.xml configuration file (labwc-config(5)).

A theme consists of a themerc file and optionally some titlebar icons (referred to as buttons).

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).

color

Colors can be specified by either of the following:

• #rrggbb (hexadecimal RGB values)
• #rrggbb aaa (same but with decimal alpha value)

justification

Justification determines the horizontal alignment of text. Valid options are Left, Center and Right.

border.width

Line width (integer) of border border drawn around window frames. Default is 1.

padding.height

Vertical padding size, used for spacing out elements in the window decorations. Default is 3.

menu.items.padding.x

Horizontal padding of menu text entries in pixels. Default is 7.

menu.items.padding.y

Vertical padding of menu text entries in pixels. Default is 4.

menu.overlap.x

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.

menu.overlap.y

Vertical offset in pixels between submenus and their parents. Positive values for downwards and negative for upwards. Default is 0.

menu.width.min

Minimal width for menus. Default is 20. A fixed width can be achieved by setting .min and .max to the same value.

menu.width.max

Maximal width for menus. Default is 200. A fixed width can be achieved by setting .min and .max to the same value.

window.active.border.color

Border color of active window

window.inactive.border.color

Border color of inactive window

window.active.indicator.toggled-keybind.color

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.

window.active.title.bg.color

Background color for the focused window's titlebar

window.inactive.title.bg.color

Background color for non-focused windows' titlebars

window.active.label.text.color

Text color for the focused window's titlebar

window.inactive.label.text.color

Text color non-focused windows' titlebars

window.label.text.justify

Specifies how window titles are aligned in the titlebar for both focused and unfocused windows. Type justification. Default Left.

window.active.button.unpressed.image.color

Color of the images in titlebar buttons in their default, unpressed, state. This element is for the focused window.

window.inactive.button.unpressed.image.color

Color of the images in titlebar buttons in their default, unpressed, state. This element is for non-focused windows.

Note: The button elements (i.e. window.[in]active.button.*) support defining different types of buttons individually by inserting the type ("menu", "iconify", "max" and "close") after the button node. For example: window.active.button.iconify.unpressed.image.color This syntax is not documented on the openbox.org wiki, but is supported by openbox and is used by many popular themes. For the sake of brevity, these elements are not listed here, but are supported.

menu.items.bg.color

Background color of inactive menu items

menu.items.text.color

Text color of inactive menu item

menu.items.active.bg.color

Background color of active menu items

menu.items.active.text.color

Text color of active menu item

menu.separator.width

Line thickness of menu separators. Default 1.

menu.separator.padding.width

Space on the left and right side of each separator line. Default 6.

menu.separator.padding.height

Space above and below each separator line. Default 3.

menu.separator.color

Menu separator color. Default #888888.

osd.bg.color

Background color of on-screen-display

osd.border.color

Border color of on-screen-display

osd.border.width

Border width of on-screen-display. Inherits border.width if not set.

osd.label.text.color

Text color of on-screen-display

osd.window-switcher.width

Width of window switcher in pixels. Default is 600.

osd.window-switcher.padding

Padding of window switcher in pixels. This is the space between the window-switcher border and its items. Default is 4.

osd.window-switcher.item.padding.x

Horizontal padding of window switcher entries in pixels. Default is 10.

osd.window-switcher.item.padding.y

Vertical padding of window switcher entries in pixels. Default is 1.

osd.window-switcher.item.active.border.width

Border width of the selection box in the window switcher in pixels. Default is 2.

border.color

Set all border colors. This is obsolete, but supported for backward compatibility as some themes still contain it.

The images used for the titlebar icons are referred to as buttons.

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.

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:

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"

The handle is the window edge decoration at the bottom of the window.

The window title bar height is equal to the vertical font extents of the title. Padding will be added to this later.

labwc(1), labwc-config(5), labwc-actions(5)

labwc(1), labwc-actions(5), labwc-config(5), labwc-menu(5).