labwc-theme(5)

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

NAME

6       labwc - theme files
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       menu.separator.width
104           Line thickness of menu separators. Default 1.
105
106       menu.separator.padding.width
107           Space on the left and right side of each separator line. Default 6.
108
109       menu.separator.padding.height
110           Space above and below each separator line. Default 3.
111
112       menu.separator.color
113           Menu separator color. Default #888888.
114
115       osd.bg.color
116           Background color of on-screen-display
117
118       osd.border.color
119           Border color of on-screen-display
120
121       osd.border.width
122           Border width of on-screen-display
123
124       osd.label.text.color
125           Text color of on-screen-display
126
127       border.color
128           Set all border colors. This is obsolete, but supported for backward
129           compatibility as some themes still contain it.
130

BUTTONS

132       The images used for the titlebar buttons are 1-bit xbm (X Bitmaps).
133       These are masks where 0=clear and 1=colored. The xbm image files are
134       placed in the same directory within your theme as the themerc file.
135       Here are all the possible xbm files looked for:
136
137       •   max.xbm
138       •   iconify.xbm
139       •   close.xbm
140       •   menu.xbm
141
142
143       More will be supported later.
144
145       Note: menu.xbm is not part of openbox-3.6 spec
146

DEFINITIONS

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

DERIVED DIMENSIONS

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