labwc-theme(5)

1labwc-theme(5)                File Formats Manual               labwc-theme(5)
2
3
4

NAME

6       labwc - Theme specification
7

THEME

9       The theme engine aims to be compatible with openbox and themes will be
10       searched for in the following order:
11
12       •   ${XDG_DATA_HOME:-$HOME/.local/share}/themes/<theme-name>/openbox-3/
13       •   $HOME/.themes/<theme-name>/openbox-3/
14       •   /usr/share/themes/<theme-name>/openbox-3/
15       •   /usr/local/share/themes/<theme-name>/openbox-3/
16       •   /opt/share/themes/<theme-name>/openbox-3/
17
18
19       Choosing a theme is done by editing the <name> key in the <theme> sec‐
20       tion of the rc.xml configuration file (labwc-config(5)).
21
22       A theme consists of a themerc file and optionally some xbm icons.
23

DATA TYPES

25       color RGB values
26           Colors can be specified by hexadecimal RGB values in the format
27           #rrggbb. Other formats will be supported later for better openbox
28           theme compatibility.
29
30       justification
31           Justification determines the horizontal alignment of text. Valid
32           options are Left, Center and Right.
33

THEME ELEMENTS

35       border.width
36           Line width (integer) of border border drawn around window frames.
37           Default is 1.
38
39       padding.height
40           Vertical padding size, used for spacing out elements in the window
41           decorations. Default is 3.
42
43       menu.overlap.x
44           Horizontal overlap in pixels between submenus and their parents. A
45           positive value move submenus over the top of their parents, whereas
46           a negative value creates a gap between submenus and their parents.
47           Default is 0.
48
49       menu.overlap.y
50           Vertical offset in pixels between submenus and their parents. Posi‐
51           tive values for downwards and negative for upwards. Default is 0.
52
53       window.active.border.color
54           Border color of active window
55
56       window.inactive.border.color
57           Border color of inactive window
58
59       window.active.title.bg.color
60           Background color for the focussed window's titlebar
61
62       window.inactive.title.bg.color
63           Background color for non-focussed windows' titlebars
64
65       window.active.label.text.color
66           Text color for the focussed window's titlebar
67
68       window.inactive.label.text.color
69           Text color non-focussed windows' titlebars
70
71       window.label.text.justify
72           Specifies how window titles are aligned in the titlebar for both
73           focused and unfocused windows. Type justification. Default Left.
74
75       window.active.button.unpressed.image.color
76           Color of the images in titlebar buttons in their default, un‐
77           pressed, state. This element is for the focused window.
78
79       window.inactive.button.unpressed.image.color
80           Color of the images in titlebar buttons in their default, un‐
81           pressed, state. This element is for non-focused windows.
82
83       Note: The button elements (i.e. window.[in]active.button.*) support
84       defining different types of buttons individually by inserting the type
85       ("iconify", "max" and "close") after the button node. For example: win‐
86       dow.active.button.iconify.unpressed.image.color This syntax is not not
87       documented on the openbox.org wiki, but is supported by openbox and is
88       used by many popular themes. For the sake of brevity, these elements
89       are not listed here, but are supported.
90
91       menu.items.bg.color
92           Background color of inactive menu items
93
94       menu.items.text.color
95           Text color of inactive menu item
96
97       menu.items.active.bg.color
98           Background color of active menu items
99
100       menu.items.active.text.color
101           Text color of active menu item
102
103       osd.bg.color
104           Background color of on-screen-display
105
106       osd.label.text.color
107           Text color of on-screen-display
108
109       border.color
110           Set all border colors. This is obsolete, but supported for backward
111           compatibility as some themes still contain it.
112

BUTTONS

114       The images used for the titlebar buttons are 1-bit xbm (X Bitmaps).
115       These are masks where 0=clear and 1=colored. The xbm image files are
116       placed in the same directory within your theme as the themerc file.
117       Here are all the possible xbm files looked for:
118
119       •   max.xbm
120       •   iconify.xbm
121       •   close.xbm
122
123
124       More will be supported later.
125

DEFINITIONS

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

DERIVED DIMENSIONS

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