labwc-theme - Man Page

Theme specification

Theme

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

  • ${XDG_DATA_HOME:-$HOME/.local/share}/themes/<theme-name>/openbox-3/
  • $HOME/.themes/<theme-name>/openbox-3/
  • /usr/share/themes/<theme-name>/openbox-3/
  • /usr/local/share/themes/<theme-name>/openbox-3/
  • /opt/share/themes/<theme-name>/openbox-3/

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 xbm icons.

Data Types

color RGB values

Colors can be specified by hexadecimal RGB values in the format #rrggbb. Other formats will be supported later for better openbox theme compatibility.

Theme Elements

border.width

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

window.active.border.color

Border color of active window

window.active.title.bg.color

Background for the focussed window's titlebar

window.inactive.title.bg.color

Background for non-focussed windows' titlebars

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.

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

Definitions

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

Derived Dimensions

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

See Also

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

Referenced By

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

2021-07-22