new build system without automake
[dana/openbox.git] / doc / themerc.txt
1 The themerc file dictates which engine and theme openbox will use, as well as
2 parameters for the engine.
3
4 ----
5
6 Options for the themerc file are specified as:
7 option = value
8
9 Lines that begin with # are considered comments.
10
11 ----
12
13 These are the valid options:
14
15 engine
16         String value, containing the name of the engine to load.
17         example: 'openbox'
18         default: 'openbox'
19
20 theme
21         String value containing the theme to load in the engine. This can be
22         an absolute path to the theme, or simply the theme's name in which case
23         the appropriate paths will be searched for the theme.
24         example: 'mytheme'
25         default: engine-dependant
26
27 font
28         String value containing the font to use in the window titlebars. The
29         format of this string is described in:
30         http://keithp.com/~keithp/render/Xft.tutorial
31         example: 'times-12:bold:slant=italic,oblique'
32         default: 'sans-8'
33
34 titlebarlayout
35         The layout of the titlebar of windows. This is a string that can
36         consist of only valid characters. The characters are:
37                 I - iconify button
38                 M - maximize button
39                 C - close button
40                 D - all-desktops button
41                 N - window icon
42                 L - text label (window title)
43         example: 'ILMC'
44         default: 'NDLIMC'
45
46 ----
47
48 example themerc:
49
50 # My themerc file!
51 engine='openbox'
52 theme='nyz'
53 titlebarlayout='ILMC'
54 font='arial,sans-9:bold'