added own_window_type config item
[monky] / doc / config_settings.xml
1 <variablelist>
2 <varlistentry>
3         <term><command><option>alignment</option></command></term>
4         <listitem>
5                 Aligned position on screen, may be top_left, top_right, bottom_left, bottom_right, or none
6         <para></para></listitem>
7 </varlistentry>
8
9 <varlistentry>
10         <term><command><option>background</option></command></term>
11         <listitem>
12                 Boolean value, if true, Conky will be forked to background when started
13         <para></para></listitem>
14 </varlistentry>
15
16 <varlistentry>
17         <term><command><option>on_bottom</option></command></term>
18         <listitem>
19                 Set conky on the bottom of all other applications
20         <para></para></listitem>
21 </varlistentry>
22
23 <varlistentry>
24         <term><command><option>border_margin</option></command></term>
25         <listitem>
26                 Border margin in pixels
27         <para></para></listitem>
28 </varlistentry>
29
30 <varlistentry>
31         <term><command><option>border_width</option></command></term>
32         <listitem>
33                 Border width in pixels
34         <para></para></listitem>
35 </varlistentry>
36
37 <varlistentry>
38         <term><command><option>cpu_avg_samples</option></command></term>
39         <listitem>
40                 The number of samples to average for CPU monitoring
41         <para></para></listitem>
42 </varlistentry>
43
44 <varlistentry>
45         <term><command><option>default_color</option></command></term>
46         <listitem>
47                 Default color and border color
48         <para></para></listitem>
49 </varlistentry>
50
51 <varlistentry>
52         <term><command><option>default_shade_color</option></command></term>
53         <listitem>
54                 Default shading color and border's shading color
55         <para></para></listitem>
56 </varlistentry>
57
58 <varlistentry>
59         <term><command><option>default_outline_color</option></command></term>
60         <listitem>
61                 Default outline color
62         <para></para></listitem>
63 </varlistentry>
64
65 <varlistentry>
66         <term><command><option>double_buffer</option></command></term>
67         <listitem>
68                 Use the Xdbe extension? (eliminates flicker) It is highly recommended to use own window with this one so double buffer won't be so big.
69         <para></para></listitem>
70 </varlistentry>
71
72 <varlistentry>
73         <term><command><option>draw_borders</option></command></term>
74         <listitem>
75                 Draw borders around text?
76         <para></para></listitem>
77 </varlistentry>
78
79 <varlistentry>
80         <term><command><option>draw_graph_borders</option></command></term>
81         <listitem>
82                 Draw borders around graphs?
83         <para></para></listitem>
84 </varlistentry>
85
86 <varlistentry>
87         <term><command><option>draw_shades</option></command></term>
88         <listitem>
89                 Draw shades?
90         <para></para></listitem>
91 </varlistentry>
92
93 <varlistentry>
94         <term><command><option>draw_outline</option></command></term>
95         <listitem>
96                 Draw outlines?
97         <para></para></listitem>
98 </varlistentry>
99
100 <varlistentry>
101         <term><command><option>font</option></command></term>
102         <listitem>
103                 Font name in X, xfontsel can be used to get a nice font
104         <para></para></listitem>
105 </varlistentry>
106
107 <varlistentry>
108         <term><command><option>gap_x</option></command></term>
109         <listitem>
110                 Gap between right or left border of screen, same as passing -x at command line
111         <para></para></listitem>
112 </varlistentry>
113
114 <varlistentry>
115         <term><command><option>gap_y</option></command></term>
116         <listitem>
117                 Gap between top or bottom border of screen, same as passing -y at command line
118         <para></para></listitem>
119 </varlistentry>
120
121 <varlistentry>
122         <term><command><option>no_buffers</option></command></term>
123         <listitem>
124                 Substract (file system) buffers from used memory?
125         <para></para></listitem>
126 </varlistentry>
127
128 <varlistentry>
129         <term><command><option>mail_spool</option></command></term>
130         <listitem>
131                 Mail spool for mail checking
132         <para></para></listitem>
133 </varlistentry>
134
135 <varlistentry>
136         <term><command><option>maximum_width</option></command>
137                 <option>pixels</option>
138         </term>
139         <listitem>
140                 Maximum width of window
141                 <para></para></listitem>
142 </varlistentry>
143
144 <varlistentry>
145         <term><command><option>minimum_size</option></command>
146         <option>width (height)</option>
147         </term>
148         <listitem>
149                 Minimum size of window
150         <para></para></listitem>
151 </varlistentry>
152
153 <varlistentry>
154         <term><command><option>min_port_monitors</option></command></term>
155         <listitem>
156                 Allow for the creation of at least this number of port monitors (if 0 or not set, default is 16) 
157         <para></para></listitem>
158 </varlistentry>
159
160 <varlistentry>
161         <term><command><option>min_port_monitor_connections</option></command></term>
162         <listitem>
163                 Allow each port monitor to track at least this many connections (if 0 or not set, default is 256)
164         <para></para></listitem>
165 </varlistentry>
166
167 <varlistentry>
168         <term><command><option>mldonkey_hostname</option></command></term>
169         <listitem>
170                 Hostname for mldonkey stuff, defaults to localhost
171         <para></para></listitem>
172 </varlistentry>
173
174 <varlistentry>
175         <term><command><option>mldonkey_port</option></command></term>
176         <listitem>
177                 Mldonkey port, 4001 default
178         <para></para></listitem>
179 </varlistentry>
180
181 <varlistentry>
182         <term><command><option>mldonkey_login</option></command></term>
183         <listitem>
184                 Mldonkey login, default none
185         <para></para></listitem>
186 </varlistentry>
187
188 <varlistentry>
189         <term><command><option>mldonkey_password</option></command></term>
190         <listitem>
191                 Mldonkey password, default none
192         <para></para></listitem>
193 </varlistentry>
194
195 <varlistentry>
196         <term><command><option>mpd_host</option></command></term>
197         <listitem>
198                 Host of MPD server
199         <para></para></listitem>
200 </varlistentry>
201
202 <varlistentry>
203         <term><command><option>mpd_port</option></command></term>
204         <listitem>
205                 Port of MPD server
206         <para></para></listitem>
207 </varlistentry>
208
209 <varlistentry>
210         <term><command><option>mpd_password</option></command></term>
211         <listitem>
212                 MPD server password
213         <para></para></listitem>
214 </varlistentry>
215
216 <varlistentry>
217         <term><command><option>net_avg_samples</option></command></term>
218         <listitem>
219                 The number of samples to average for net data
220         <para></para></listitem>
221 </varlistentry>
222
223 <varlistentry>
224         <term><command><option>override_utf8_locale</option></command></term>
225         <listitem>
226                 Force UTF8? requires XFT
227         <para></para></listitem>
228 </varlistentry>
229
230 <varlistentry>
231         <term><command><option>own_window</option></command></term>
232         <listitem>
233                 Boolean, create own window to draw?
234         <para></para></listitem>
235 </varlistentry>
236
237 <varlistentry>
238         <term><command><option>own_window_transparent</option></command></term>
239         <listitem>
240                 Boolean, set pseudo-transparency?
241                 <para></para></listitem>
242 </varlistentry>
243
244 <varlistentry>
245         <term><command><option>own_window_type</option></command></term>
246         <listitem>
247                 if own_window is yes, you may specify type normal or desktop (default: normal).
248                 Desktop windows are special windows that have no window decorations; are always visible 
249                 on your desktop; do not appear in your pager or taskbar; and are sticky across all workspaces.
250                 <para></para></listitem>
251 </varlistentry>
252
253 <varlistentry>
254         <term><command><option>own_window_colour</option></command>
255                 <option>colour</option>
256         </term>
257         <listitem>
258                 If own_window_transparent no, set a specified background colour (defaults to black).  Takes either a hex value (#ffffff) or a valid RGB name (see /usr/lib/X11/rgb.txt)
259                 <para></para></listitem>
260 </varlistentry>
261
262 <varlistentry>
263         <term><command><option>own_window_hints</option></command>
264                 <option>undecorated,below,above,sticky,skip_taskbar,skip_pager</option>
265         </term>
266         <listitem>
267                 If own_window is yes, you may use these window manager hints to affect the way conky displays.  
268                 Note: own_window_type desktop is another way to implement many of these hints.
269         <para></para></listitem>
270 </varlistentry>
271
272 <varlistentry>
273         <term><command><option>out_to_console</option></command>
274         </term>
275         <listitem>
276                 Print text to stdout.
277                 <para></para></listitem>
278 </varlistentry>
279 <varlistentry>
280         <term><command><option>pad_percents</option></command></term>
281         <listitem>
282                 Pad percentages to this many decimals (0 = no padding)
283         <para></para></listitem>
284 </varlistentry>
285
286 <varlistentry>
287         <term><command><option>stippled_borders</option></command></term>
288         <listitem>
289                 Border stippling (dashing) in pixels
290         <para></para></listitem>
291 </varlistentry>
292
293 <varlistentry>
294         <term><command><option>total_run_times</option></command></term>
295         <listitem>
296                 Total number of times for Conky to update before quitting. Zero makes Conky run forever
297         <para></para></listitem>
298 </varlistentry>
299
300 <varlistentry>
301         <term><command><option>update_interval</option></command></term>
302         <listitem>
303                 Update interval in seconds
304         <para></para></listitem>
305 </varlistentry>
306
307 <varlistentry>
308         <term><command><option>uppercase</option></command></term>
309         <listitem>
310                 Boolean value, if true, text is rendered in upper case
311         <para></para></listitem>
312 </varlistentry>
313
314 <varlistentry>
315         <term><command><option>use_spacer</option></command></term>
316         <listitem>
317                 Adds spaces after certain objects to stop them from moving other things around. Note that this only helps if you are using a mono font, such as Bitstream Vera Sans Mono.
318         <para></para></listitem>
319 </varlistentry>
320
321 <varlistentry>
322         <term><command><option>use_xft</option></command></term>
323         <listitem>
324                 Use Xft (anti-aliased font and stuff)
325         <para></para></listitem>
326 </varlistentry>
327
328 <varlistentry>
329         <term><command><option>wm_class_name</option></command></term>
330         <listitem>
331                 Manually set the WM_CLASS name.  Defaults to "conky".
332         <para></para></listitem>
333 </varlistentry>
334
335 <varlistentry>
336         <term><command><option>xmms_player</option></command></term>
337         <listitem>
338                 Use specified player/plugin for the xmms status variables.  Valid items are: none, xmms, bmp, audacious and infopipe. (default is none).  Note that bmpx is currently handled separately.
339         <para></para></listitem>
340 </varlistentry>
341
342 <varlistentry>
343         <term><command><option>TEXT</option></command></term>
344         <listitem>
345                 After this begins text to be formatted on screen
346         <para></para></listitem>
347 </varlistentry>
348
349 </variablelist>