theme.conf.5 (8040B)
1 .TH WMI 5 User Manuals 2 .SH NAME 3 WMI \- Window Manager Improved, a X11 window manager for hackers 4 .SH DESCRIPTION 5 The file \fItheme.conf\f1 is used to define the look and feel of WMI. 6 .SH FORMAT 7 The basic format of all \fI.conf\f1 and \fI.session\f1 files is as follows: 8 9 key=value 10 11 # comment 12 13 key=\\#value # '\\' escapes special characters 14 15 # special characters are: ", =, \\ and # 16 17 If you've whitespaces within values, you've to quote them with '"' characters. You're free to let empty lines or whitespaces before and after keys, the '=' operator and the value. If you need a special character, you've to escape it using the '\\' character, e.g. \\=. 18 .SH COLOR FORMAT 19 Note that you can vary the syntax for color triplet definitions as follows: 20 21 key=\\#nnnnnn 22 23 or 24 25 key="#nnnnnn" 26 27 or 28 29 key=blue 30 31 This shows different escaping possibilities, the last case is useful for predefined X11 colors. 32 33 The syntax: key=rgb:/nn/nn/nn 34 is NOT supported. 35 .SH TERMINOLOGY 36 All color definitions begin with prefix 'color.', afterwards the object is appended to this prefix, e.g. 'label', 'button'. 37 38 There are four types of colors per object (note that some have only three colors): 'background', 'text', 'shine' and 'shadow'. Background means the background filling color of the object, text means the color of text, if any, shine and shadow means the color of the objects border, where top-left border is the shine border and bottom-right is the shadow border. 39 40 If an object is distinguished into active and inactive it may have the focus, like frames or tabs. 41 .SH FORMAT 42 Following look and feel option keys are defined: 43 .SH OPTIONS 44 .TP 45 \fBcolor.bar.background=\f1 46 Background color of float and status bar and input mode. 47 .TP 48 \fBcolor.bar.shadow=\f1 49 Shadow border of the float and status bar. 50 .TP 51 \fBcolor.bar.shine=\f1 52 Shine border of the float and status bar. 53 .TP 54 \fBcolor.bar.text=\f1 55 Text color of the status text within status bar and the input mode prompt. 56 .TP 57 \fBcolor.button.background.normal=\f1 58 Background color of not pressed buttons. 59 .TP 60 \fBcolor.button.background.pressed=\f1 61 Background color of pressed buttons. 62 .TP 63 \fBcolor.button.border.shadow.normal=\f1 64 Border shadow color of not pressed buttons. 65 .TP 66 \fBcolor.button.border.shadow.pressed=\f1 67 Border shadow color of pressed buttons. 68 .TP 69 \fBcolor.button.border.shine.normal=\f1 70 Border shine color of not pressed buttons. 71 .TP 72 \fBcolor.button.border.shine.pressed=\f1 73 Border shine color of pressed buttons. 74 .TP 75 \fBcolor.button.figure.shadow.normal=\f1 76 Figure shadow color of not pressed buttons. 77 .TP 78 \fBcolor.button.figure.shadow.pressed=\f1 79 Figure shadow color of pressed buttons. 80 .TP 81 \fBcolor.button.figure.shine.normal=\f1 82 Figure shine color of not pressed buttons. 83 .TP 84 \fBcolor.focusreq.background=\f1 85 Background color of an item which requests for focus. 86 .TP 87 \fBcolor.focusreq.text=\f1 88 Text color of an item which requests for focus. 89 .TP 90 \fBcolor.focusreq.shine=\f1 91 Shine border color of an item which requests for focus. 92 .TP 93 \fBcolor.focusreq.shadow=\f1 94 Shadow border color of an item which requests for focus. 95 .TP 96 \fBcolor.button.figure.shine.pressed=\f1 97 Figure shine color of pressed buttons. 98 .TP 99 \fBcolor.frame.background.focussed=\f1 100 Background color of the focussed frame. 101 .TP 102 \fBcolor.frame.background.normal=\f1 103 Background color of not focussed frames. 104 .TP 105 \fBcolor.frame.pseudo=\f1 106 XORed color of frame/client movements. 107 .TP 108 \fBcolor.frame.shadow.focussed=\f1 109 Shadow color of the focussed frame. 110 .TP 111 \fBcolor.frame.shadow.normal=\f1 112 Shadow color of not focussed frames. 113 .TP 114 \fBcolor.frame.shine.focussed=\f1 115 Shine color of the focussed frame. 116 .TP 117 \fBcolor.frame.shine.normal=\f1 118 Shine color of not focussed frames. 119 .TP 120 \fBcolor.label.background.focussed=\f1 121 Background color of focussed labels (workspace and group pager labels or focussed entry within input mode). 122 .TP 123 \fBcolor.label.background.normal=\f1 124 Background color of not focussed labels (workspace and group pager labels or focussed entry within input mode). 125 .TP 126 \fBcolor.label.shadow.focussed=\f1 127 Shadow border color of focussed labels (workspace and group pager labels or focussed entry within input mode). 128 .TP 129 \fBcolor.label.shadow.normal=\f1 130 Shadow border color of not focussed labels (workspace and group pager labels or focussed entry within input mode). 131 .TP 132 \fBcolor.label.shine.focussed=\f1 133 Shine border color of focussed labels (workspace and group pager labels or focussed entry within input mode). 134 .TP 135 \fBcolor.label.shine.normal=\f1 136 Shine border color of not focussed labels (workspace and group pager labels or focussed entry within input mode). 137 .TP 138 \fBcolor.label.text.focussed=\f1 139 Text color of focussed labels (workspace and group pager labels or focussed entry within input mode). 140 .TP 141 \fBcolor.label.text.normal=\f1 142 Text color of not focussed labels (workspace and group pager labels or focussed entry within input mode). 143 .TP 144 \fBcolor.meter.background=\f1 145 Background color of a meter. 146 .TP 147 \fBcolor.meter.figure.high=\f1 148 High color of a meter. 149 .TP 150 \fBcolor.meter.figure.normal=\f1 151 Normal color of a meter. 152 .TP 153 \fBcolor.meter.figure.low=\f1 154 Low color of a meter. 155 .TP 156 \fBcolor.meter.border.shine=\f1 157 Shine border color of a meter. 158 .TP 159 \fBcolor.meter.border.shadow=\f1 160 Shadow border color of a meter. 161 .TP 162 \fBcolor.meter.text=\f1 163 Text color of a meter. 164 .TP 165 \fBcolor.tab.background.active.focussed=\f1 166 Background color of active tab within focussed frame. 167 .TP 168 \fBcolor.tab.background.active.normal=\f1 169 Background color of active tab within not focussed frame. 170 .TP 171 \fBcolor.tab.background.inactive.focussed=\f1 172 Background color of inactive tab within focussed frame. 173 .TP 174 \fBcolor.tab.background.inactive.normal=\f1 175 Background color of inactive tab within not focussed frame. 176 .TP 177 \fBcolor.tab.shadow.active.focussed=\f1 178 Shadow color of active tab within focussed frame. 179 .TP 180 \fBcolor.tab.shadow.active.normal=\f1 181 Shadow color of active tab within not focussed frame. 182 .TP 183 \fBcolor.tab.shadow.inactive.focussed=\f1 184 Shadow color of inactive tab within focussed frame. 185 .TP 186 \fBcolor.tab.shadow.inactive.normal=\f1 187 Shadow color of inactive tab within not focussed frame. 188 .TP 189 \fBcolor.tab.shine.active.focussed=\f1 190 Shine color of active tab within focussed frame. 191 .TP 192 \fBcolor.tab.shine.active.normal=\f1 193 Shine color of active tab within not focussed frame. 194 .TP 195 \fBcolor.tab.shine.inactive.focussed=\f1 196 Shine color of inactive tab within focussed frame. 197 .TP 198 \fBcolor.tab.shine.inactive.normal=\f1 199 Shine color of inactive tab within not focussed frame. 200 .TP 201 \fBcolor.tab.text.active.focussed=\f1 202 Text color of active tab within focussed frame. 203 .TP 204 \fBcolor.tab.text.active.normal=\f1 205 Text color of active tab within not focussed frame. 206 .TP 207 \fBcolor.tab.text.inactive.focussed=\f1 208 Text color of inactive tab within focussed frame. 209 .TP 210 \fBcolor.tab.text.inactive.normal=\f1 211 Text color of inactive tab within not focussed frame. 212 .TP 213 \fBcolor.tiled.shine.focussed=\f1 214 Shine border color of focussed tiled clients. 215 .TP 216 \fBcolor.tiled.shadow.focussed=\f1 217 Shadow border color of focussed tiled clients. 218 .TP 219 \fBcolor.tiled.shine.normal=\f1 220 Shine border color of unfocussed tiled clients. 221 .TP 222 \fBcolor.tiled.shadow.normal=\f1 223 Shine border color of unfocussed tiled clients. 224 .TP 225 \fBexec=\f1 226 Execution of a command, e.g. setting the background wallpaper which is invoked while loading the theme (while startup of WMI). 227 .TP 228 \fBfont=\f1 229 The font of labels, tabs and bars. Note that the height of buttons and bars is scaled to match with the font size of the defined font. If you want to have bigger or smaller bars and buttons simply choose a bigger or smaller font. 230 .SH AUTHOR 231 WMI was written by Anselm R. Garbe < anselm@garbe.us > and others (see AUTHORS or the WMI site for further information) 232 233 You will find the newest version of WMI at \fBhttp://wmi.suckless.org/\f1. There is also a mailing list. 234 .SH BUGS 235 You should report them to the mailing list. 236 .SH SEE ALSO 237 \fBwmi(1)\f1, \fBwmiremote(1)\f1, \fBactions.conf(5)\f1, \fBcommon.conf(5)\f1 \fBsession.conf(5)\f1,