2005-08-19 05:37:58 +00:00
<variablelist >
<varlistentry >
<term > <command > <option > alignment</option> </command> </term>
<listitem >
2005-08-21 05:04:22 +00:00
Aligned position on screen, may be top_left, top_right, bottom_left, bottom_right, or none
2005-08-19 05:37:58 +00:00
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > background</option> </command> </term>
<listitem >
Boolean value, if true, Conky will be forked to background when started
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > on_bottom</option> </command> </term>
<listitem >
2006-05-08 22:34:38 +00:00
Set Conky on the bottom of all other applications
2005-08-19 05:37:58 +00:00
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > border_margin</option> </command> </term>
<listitem >
Border margin in pixels
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > border_width</option> </command> </term>
<listitem >
Border width in pixels
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > cpu_avg_samples</option> </command> </term>
<listitem >
The number of samples to average for CPU monitoring
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > default_color</option> </command> </term>
<listitem >
Default color and border color
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > default_shade_color</option> </command> </term>
<listitem >
Default shading color and border's shading color
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > default_outline_color</option> </command> </term>
<listitem >
Default outline color
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > double_buffer</option> </command> </term>
<listitem >
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.
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > draw_borders</option> </command> </term>
<listitem >
Draw borders around text?
<para > </para> </listitem>
</varlistentry>
2006-01-05 23:23:51 +00:00
<varlistentry >
<term > <command > <option > draw_graph_borders</option> </command> </term>
<listitem >
Draw borders around graphs?
<para > </para> </listitem>
</varlistentry>
2005-08-19 05:37:58 +00:00
<varlistentry >
<term > <command > <option > draw_shades</option> </command> </term>
<listitem >
Draw shades?
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > draw_outline</option> </command> </term>
<listitem >
Draw outlines?
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > font</option> </command> </term>
<listitem >
Font name in X, xfontsel can be used to get a nice font
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > gap_x</option> </command> </term>
<listitem >
Gap between right or left border of screen, same as passing -x at command line
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > gap_y</option> </command> </term>
<listitem >
Gap between top or bottom border of screen, same as passing -y at command line
<para > </para> </listitem>
</varlistentry>
2006-05-08 22:34:38 +00:00
<varlistentry >
<term > <command > <option > imap</option> </command> </term>
<listitem >
Default global IMAP server. Arguments are: "host user pass [-i interval] [-f folder] [-p port] [-e command]". Default port is 143, default folder is 'INBOX', default interval is 5 minutes. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
<para > </para> </listitem>
</varlistentry>
2005-08-19 05:37:58 +00:00
<varlistentry >
<term > <command > <option > no_buffers</option> </command> </term>
<listitem >
Substract (file system) buffers from used memory?
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > mail_spool</option> </command> </term>
<listitem >
Mail spool for mail checking
<para > </para> </listitem>
</varlistentry>
<varlistentry >
2005-08-24 06:21:50 +00:00
<term > <command > <option > maximum_width</option> </command>
<option > pixels</option>
</term>
<listitem >
Maximum width of window
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > minimum_size</option> </command>
<option > width (height)</option>
</term>
2005-08-19 05:37:58 +00:00
<listitem >
Minimum size of window
<para > </para> </listitem>
</varlistentry>
2006-01-11 17:03:45 +00:00
<varlistentry >
<term > <command > <option > min_port_monitors</option> </command> </term>
<listitem >
Allow for the creation of at least this number of port monitors (if 0 or not set, default is 16)
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > min_port_monitor_connections</option> </command> </term>
<listitem >
Allow each port monitor to track at least this many connections (if 0 or not set, default is 256)
<para > </para> </listitem>
</varlistentry>
2005-08-19 05:37:58 +00:00
<varlistentry >
<term > <command > <option > mldonkey_hostname</option> </command> </term>
<listitem >
Hostname for mldonkey stuff, defaults to localhost
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > mldonkey_port</option> </command> </term>
<listitem >
Mldonkey port, 4001 default
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > mldonkey_login</option> </command> </term>
<listitem >
Mldonkey login, default none
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > mldonkey_password</option> </command> </term>
<listitem >
Mldonkey password, default none
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > mpd_host</option> </command> </term>
<listitem >
Host of MPD server
<para > </para> </listitem>
</varlistentry>
<varlistentry >
2005-08-27 21:04:37 +00:00
<term > <command > <option > mpd_port</option> </command> </term>
2005-08-19 05:37:58 +00:00
<listitem >
Port of MPD server
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > mpd_password</option> </command> </term>
<listitem >
MPD server password
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > net_avg_samples</option> </command> </term>
<listitem >
The number of samples to average for net data
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > override_utf8_locale</option> </command> </term>
<listitem >
Force UTF8? requires XFT
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > own_window</option> </command> </term>
<listitem >
Boolean, create own window to draw?
<para > </para> </listitem>
</varlistentry>
2005-08-25 09:24:26 +00:00
<varlistentry >
<term > <command > <option > own_window_transparent</option> </command> </term>
<listitem >
Boolean, set pseudo-transparency?
<para > </para> </listitem>
</varlistentry>
2006-03-08 22:17:27 +00:00
<varlistentry >
<term > <command > <option > own_window_type</option> </command> </term>
<listitem >
2006-03-09 02:28:38 +00:00
if own_window is yes, you may specify type normal, desktop or override (default: normal).
2006-03-08 22:17:27 +00:00
Desktop windows are special windows that have no window decorations; are always visible
on your desktop; do not appear in your pager or taskbar; and are sticky across all workspaces.
2006-03-09 19:03:20 +00:00
Override windows are not under the control of the window manager. Hints are ignored. This type
of window can be useful for certain situations.
2006-03-08 22:17:27 +00:00
<para > </para> </listitem>
</varlistentry>
2005-08-25 09:24:26 +00:00
<varlistentry >
<term > <command > <option > own_window_colour</option> </command>
<option > colour</option>
</term>
<listitem >
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)
<para > </para> </listitem>
</varlistentry>
2006-03-06 23:35:41 +00:00
<varlistentry >
<term > <command > <option > own_window_hints</option> </command>
<option > undecorated,below,above,sticky,skip_taskbar,skip_pager</option>
</term>
<listitem >
2006-05-08 22:34:38 +00:00
If own_window is yes, you may use these window manager hints to affect the way Conky displays.
2006-03-09 19:03:20 +00:00
Notes: Use own_window_type desktop as another way to implement many of these hints implicitly.
If you use own_window_type override, window manager hints have no meaning and are ignored.
2006-03-06 23:35:41 +00:00
<para > </para> </listitem>
</varlistentry>
2005-11-24 15:36:46 +00:00
<varlistentry >
<term > <command > <option > out_to_console</option> </command>
</term>
<listitem >
Print text to stdout.
<para > </para> </listitem>
</varlistentry>
2005-08-19 05:37:58 +00:00
<varlistentry >
<term > <command > <option > pad_percents</option> </command> </term>
<listitem >
Pad percentages to this many decimals (0 = no padding)
<para > </para> </listitem>
</varlistentry>
2006-05-08 22:34:38 +00:00
<varlistentry >
<term > <command > <option > pop3</option> </command> </term>
<listitem >
Default global POP3 server. Arguments are: "host user pass [-i interval] [-p port] [-e command]". Default port is 110, default interval is 5 minutes. If the password is supplied as '*', you will be prompted to enter the password when Conky starts.
<para > </para> </listitem>
</varlistentry>
2005-08-19 05:37:58 +00:00
<varlistentry >
<term > <command > <option > stippled_borders</option> </command> </term>
<listitem >
Border stippling (dashing) in pixels
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > total_run_times</option> </command> </term>
<listitem >
Total number of times for Conky to update before quitting. Zero makes Conky run forever
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > update_interval</option> </command> </term>
<listitem >
Update interval in seconds
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > uppercase</option> </command> </term>
<listitem >
Boolean value, if true, text is rendered in upper case
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > use_spacer</option> </command> </term>
<listitem >
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.
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > use_xft</option> </command> </term>
<listitem >
Use Xft (anti-aliased font and stuff)
<para > </para> </listitem>
</varlistentry>
2006-01-21 08:54:58 +00:00
<varlistentry >
<term > <command > <option > wm_class_name</option> </command> </term>
<listitem >
Manually set the WM_CLASS name. Defaults to "conky".
<para > </para> </listitem>
</varlistentry>
2006-04-15 18:00:39 +00:00
<varlistentry >
<term > <command > <option > xftalpha</option> </command> </term>
<listitem >
Alpha of Xft font. Must be a value at or between 1 and 0.
<para > </para> </listitem>
</varlistentry>
<varlistentry >
<term > <command > <option > xftfont</option> </command> </term>
<listitem >
Xft font to use.
<para > </para> </listitem>
</varlistentry>
2005-11-11 03:28:24 +00:00
<varlistentry >
2006-01-11 17:03:45 +00:00
<term > <command > <option > xmms_player</option> </command> </term>
2005-11-11 03:28:24 +00:00
<listitem >
2006-01-11 17:03:45 +00:00
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.
2005-11-11 03:28:24 +00:00
<para > </para> </listitem>
</varlistentry>
2005-08-19 05:37:58 +00:00
<varlistentry >
2005-08-30 02:45:09 +00:00
<term > <command > <option > TEXT</option> </command> </term>
2005-08-19 05:37:58 +00:00
<listitem >
After this begins text to be formatted on screen
<para > </para> </listitem>
</varlistentry>
2005-11-11 03:28:24 +00:00
</variablelist>