mirror of
https://github.com/Llewellynvdm/conky.git
synced 2024-11-15 17:47:09 +00:00
475b859e3f
This should help with #1061. Also added a warning about the default port being blocked by browsers.
1141 lines
36 KiB
XML
1141 lines
36 KiB
XML
<variablelist>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>alignment</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Aligned position on screen, may be top_left, top_right,
|
|
top_middle, bottom_left, bottom_right, bottom_middle, middle_left,
|
|
middle_middle, middle_right, or none (also can be abbreviated as tl,
|
|
tr, tm, bl, br, bm, ml, mm, mr). See also gap_x and gap_y.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>append_file</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Append the file given as argument.
|
|
<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 /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>forced_redraw</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Boolean value, if true, Conky will redraw everything when you switch the workspace. This may cause delays/flickering on some WMs.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>border_inner_margin</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Inner border margin in pixels (the margin between the border
|
|
and text).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>border_outer_margin</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Outer border margin in pixels (the margin between the border
|
|
and the edge of the window).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>border_width</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Border width in pixels.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>colorN</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Predefine a color for use inside conky.text segments.
|
|
Substitute N by a digit between 0 and 9, inclusively. When specifying
|
|
the color value in hex, omit the leading hash (#).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>console_bar_fill</option>
|
|
</command>
|
|
</term>
|
|
<listitem>A character to fill the console bars. (default: '#')
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>console_bar_unfill</option>
|
|
</command>
|
|
</term>
|
|
<listitem>A character to unfill the console bars. (default: '.')
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>console_graph_ticks</option>
|
|
</command>
|
|
</term>
|
|
<listitem>A comma-separated list of strings to use as the bars of a
|
|
graph output to console/shell. The first list item is used for the
|
|
minimum bar height and the last item is used for the maximum, e.g. "
|
|
,_,=,#".
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>cpu_avg_samples</option>
|
|
</command>
|
|
</term>
|
|
<listitem>The number of samples to average for CPU monitoring.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_bar_height</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify a default height for bars. If not specified, the
|
|
default value is 6.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_bar_width</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify a default width for bars. If not specified, the
|
|
default value is 0, which causes the bar to expand to fit the width of
|
|
your Conky window. If you set out_to_console = true, the default value
|
|
will be 10 for the text version of the bar.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_color</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Default color and border color.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_gauge_height</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify a default height for gauges. If not specified, the
|
|
default value is 25.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_gauge_width</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify a default width for gauges. If not specified, the
|
|
default value is 40.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_graph_height</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify a default height for graphs. If not specified, the
|
|
default value is 25.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_graph_width</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify a default width for graphs. If not specified, the
|
|
default value is 0, which causes the graph to expand to fit the width
|
|
of your Conky window. If you set out_to_console = true, the text
|
|
version of the graph will actually have no width and you will need to
|
|
set a sensible default or set the height and width of each graph
|
|
individually.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_outline_color</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Default outline color.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>default_shade_color</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Default shading color and border's shading color.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>disable_auto_reload</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Enable to disable the inotify-based auto config reload
|
|
feature.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>diskio_avg_samples</option>
|
|
</command>
|
|
</term>
|
|
<listitem>The number of samples to average for disk I/O monitoring.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>display</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify an X display to connect to.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>xinerama_head</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify a Xinerama head.
|
|
<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 /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>draw_blended</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Boolean, blend when rendering drawn image? Some images blend
|
|
incorrectly breaking alpha with ARBG visuals. This provides a possible
|
|
work around by disabling blending. Defaults to true.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>draw_borders</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Draw borders around text.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>draw_graph_borders</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Draw borders around graphs.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>draw_outline</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Draw outlines.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>draw_shades</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Draw shades.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>extra_newline</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Put an extra newline at the end when writing to stdout,
|
|
useful for writing to awesome's wiboxes.
|
|
<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 /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>fontN</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Predefine a font to be used in conky.text segments.
|
|
Substitute N by a number between 0 and 9 inclusive. Use the same
|
|
format as a font variable.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>format_human_readable</option>
|
|
</command>
|
|
</term>
|
|
<listitem>If enabled, values which are in bytes will be printed in
|
|
human readable format (i.e., KiB, MiB, etc). If disabled, the number
|
|
of bytes is printed instead.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>gap_x</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Gap, in pixels, between right or left border of screen, same
|
|
as passing -x at command line, e.g. gap_x 10. For other position
|
|
related stuff, see 'alignment'.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>gap_y</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Gap, in pixels, between top or bottom border of screen, same
|
|
as passing -y at command line, e.g. gap_y 10. For other position
|
|
related stuff, see 'alignment'.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>github_token</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Specify API token for GitHub notifications.
|
|
<simplelist>
|
|
<member>
|
|
https://github.com/settings/tokens/new?scopes=notifications&description=conky</member>
|
|
</simplelist>
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>hddtemp_host</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Hostname to connect to for hddtemp objects. Defaults to
|
|
"127.0.0.1".
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>hddtemp_port</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Port to use for hddtemp connections. Defaults to 7634.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>http_port</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Port to listen to for HTTP connections. Default value is
|
|
10080, but is blocked by Firefox and Chrome, so you really want to
|
|
change it.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>http_refresh</option>
|
|
</command>
|
|
</term>
|
|
<listitem>When this is set the page generated with out_to_http will
|
|
automatically refresh each interval. Default value is no.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>if_up_strictness</option>
|
|
</command>
|
|
</term>
|
|
<listitem>How strict should if_up be when testing an interface for
|
|
being up? The value is one of up, link or address, to check for the
|
|
interface being solely up, being up and having link or being up,
|
|
having link and an assigned IP address.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>imap</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Default global IMAP server. Arguments are: "host user pass
|
|
[-i interval (in seconds)] [-f 'folder'] [-p port] [-e 'command'] [-r
|
|
retries]". Default port is 143, default folder is 'INBOX', default
|
|
interval is 5 minutes, and default number of retries before giving up
|
|
is 5. If the password is supplied as '*', you will be prompted to
|
|
enter the password when Conky starts.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>imlib_cache_flush_interval</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Interval (in seconds) to flush Imlib2 cache.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>imlib_cache_size</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Imlib2 image cache size, in bytes. Defaults to 4MiB.
|
|
Increase this value if you use $image lots. Set to 0 to disable the
|
|
image cache.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>lua_draw_hook_post</option>
|
|
</command>
|
|
<option>function_name [function arguments]</option>
|
|
</term>
|
|
<listitem>This function, if defined, will be called by Conky through
|
|
each iteration after drawing to the window. Requires X support. Takes
|
|
any number of optional arguments. Use this hook for drawing things on
|
|
top of what Conky draws. Conky puts 'conky_' in front of function_name
|
|
to prevent accidental calls to the wrong function unless you place
|
|
'conky_' in front of it yourself.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>lua_draw_hook_pre</option>
|
|
</command>
|
|
<option>function_name [function arguments]</option>
|
|
</term>
|
|
<listitem>This function, if defined, will be called by Conky through
|
|
each iteration before drawing to the window. Requires X support. Takes
|
|
any number of optional arguments. Use this hook for drawing things on
|
|
top of what Conky draws. Conky puts 'conky_' in front of function_name
|
|
to prevent accidental calls to the wrong function unless you place
|
|
'conky_' in front of it yourself.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>lua_load</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Loads the Lua scripts separated by spaces.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>lua_shutdown_hook</option>
|
|
</command>
|
|
<option>function_name [function arguments]</option>
|
|
</term>
|
|
<listitem>This function, if defined, will be called by Conky at
|
|
shutdown or when the configuration is reloaded. Use this hook to clean
|
|
up after yourself, such as freeing memory which has been allocated by
|
|
external libraries via Lua. Conky puts 'conky_' in front of
|
|
function_name to prevent accidental calls to the wrong function unless
|
|
you place 'conky_' in front of it yourself.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>lua_startup_hook</option>
|
|
</command>
|
|
<option>function_name [function arguments]</option>
|
|
</term>
|
|
<listitem>This function, if defined, will be called by Conky at
|
|
startup or when the configuration is reloaded. Use this hook to
|
|
initialize values, or for any run-once applications. Conky puts
|
|
'conky_' in front of function_name to prevent accidental calls to the
|
|
wrong function unless you place 'conky_' in front of it yourself.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mail_spool</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Mail spool for mail checking.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>max_port_monitor_connections</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Allow each port monitor to track at most this many
|
|
connections (if 0 or not set, default is 256).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>max_text_width</option>
|
|
</command>
|
|
<option>width</option>
|
|
</term>
|
|
<listitem>When a line in the output contains 'width' chars and the end
|
|
isn't reached, the next char will start on a new line. If you want to
|
|
make sure that lines don't get broken, set 'width' to 0.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>max_user_text</option>
|
|
</command>
|
|
<option>bytes</option>
|
|
</term>
|
|
<listitem>Maximum size of user text buffer, i.e. text inside
|
|
conky.text section in config file (default is 16384 bytes).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>maximum_width</option>
|
|
</command>
|
|
<option>pixels</option>
|
|
</term>
|
|
<listitem>Maximum width of window.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>minimum_height</option>
|
|
</command>
|
|
<option>height</option>
|
|
</term>
|
|
<listitem>Minimum height of the window.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>minimum_width</option>
|
|
</command>
|
|
<option>width</option>
|
|
</term>
|
|
<listitem>Minimum width of window.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mpd_host</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Host of MPD server.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mpd_password</option>
|
|
</command>
|
|
</term>
|
|
<listitem>MPD server password.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mpd_port</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Port of MPD server.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mysql_host</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Host of MySQL server. Defaults to localhost.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mysql_port</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Port of MySQL server. Defaults to the default mysql port.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mysql_user</option>
|
|
</command>
|
|
</term>
|
|
<listitem>MySQL user name to use when connecting to the server.
|
|
Defaults to your username.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mysql_password</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Password of the MySQL user. Place it between "-chars. When
|
|
this is not set there is no password used.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>mysql_db</option>
|
|
</command>
|
|
</term>
|
|
<listitem>MySQL database to use. Defaults to mysql.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>music_player_interval</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Music player thread update interval (defaults to Conky's
|
|
update interval).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>net_avg_samples</option>
|
|
</command>
|
|
</term>
|
|
<listitem>The number of samples to average for net data.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>no_buffers</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Subtract (file system) buffers from used memory.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>nvidia_display</option>
|
|
</command>
|
|
</term>
|
|
<listitem>The display that the nvidia variable will use (defaults to
|
|
the value of the display variable).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>out_to_console</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Print text to stdout.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>out_to_http</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Let conky act as a small http-server serving its text.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>out_to_ncurses</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Print text in the console, but use ncurses so that conky can
|
|
print the text of a new update over the old text. (In the future this
|
|
will provide more useful things).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>out_to_stderr</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Print text to stderr.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>out_to_x</option>
|
|
</command>
|
|
</term>
|
|
<listitem>When set to no, there will be no output in X (useful when
|
|
you also use things like out_to_console). If you set it to no, make
|
|
sure that it's placed before all other X-related setting (take the
|
|
first line of your configfile to be sure). Default value is yes.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>override_utf8_locale</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Force UTF8. Requires XFT.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>overwrite_file</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Overwrite the file given as argument.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>own_window</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Boolean, create own window to draw.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>own_window_class</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Manually set the WM_CLASS name. Defaults to "Conky".
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<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 (e.g. '#ffffff'),
|
|
a shorthand hex value (e.g. '#fff'), or a valid RGB name (see
|
|
<filename>/usr/lib/X11/rgb.txt</filename>).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>own_window_hints</option>
|
|
</command>
|
|
<option>
|
|
undecorated,below,above,sticky,skip_taskbar,skip_pager</option>
|
|
</term>
|
|
<listitem>If own_window is yes, you may use these window manager hints
|
|
to affect the way Conky displays. 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.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>own_window_title</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Manually set the window name. Defaults to "conky
|
|
(<hostname>)".
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>own_window_argb_visual</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Boolean, use ARGB visual? ARGB can be used for real
|
|
transparency, note that a composite manager is required for real
|
|
transparency. This option will not work as desired (in most cases) in
|
|
conjunction with 'own_window_type override'.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>own_window_argb_value</option>
|
|
</command>
|
|
</term>
|
|
<listitem>When ARGB visuals are enabled, this use this to modify the
|
|
alpha value used. Valid range is 0-255, where 0 is 0% opacity, and 255
|
|
is 100% opacity.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>own_window_transparent</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Boolean, set transparency? If ARGB visual is enabled, sets
|
|
background opacity to 0%.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>own_window_type</option>
|
|
</command>
|
|
</term>
|
|
<listitem>if own_window is yes, you may specify type normal, desktop,
|
|
dock, panel or override (default: normal). 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. Panel windows reserve space along a desktop edge, just
|
|
like panels and taskbars, preventing maximized windows from
|
|
overlapping them. The edge is chosen based on the alignment option.
|
|
Override windows are not under the control of the window manager.
|
|
Hints are ignored. This type of window can be useful for certain
|
|
situations.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>pad_percents</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Pad percentages to this many decimals (0 = no padding).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>pop3</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Default global POP3 server. Arguments are: "host user pass
|
|
[-i interval (in seconds)] [-p port] [-e 'command'] [-r retries]".
|
|
Default port is 110, default interval is 5 minutes, and default number
|
|
of retries before giving up is 5. If the password is supplied as '*',
|
|
you will be prompted to enter the password when Conky starts.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>short_units</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Shortens units to a single character (kiB->k, GiB->G,
|
|
etc.). Default is off.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>show_graph_range</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Shows the time range covered by a graph.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>show_graph_scale</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Shows the maximum value in scaled graphs.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>stippled_borders</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Border stippling (dashing) in pixels.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>temperature_unit</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Desired output unit of all objects displaying a temperature.
|
|
Parameters are either "fahrenheit" or "celsius". The default unit is
|
|
degree Celsius.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>templateN</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Define a template for later use inside conky.text segments.
|
|
Substitute N by a digit between 0 and 9, inclusively. The value of the
|
|
variable is being inserted into the stuff inside conky.text at the
|
|
corresponding position, but before some substitutions are applied:
|
|
<simplelist>
|
|
<member>'\n' -> newline</member>
|
|
<member>'\\' -> backslash</member>
|
|
<member>'\ ' -> space</member>
|
|
<member>'\N' -> template argument N (starting from 1)</member>
|
|
</simplelist>
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>text_buffer_size</option>
|
|
</command>
|
|
<option>bytes</option>
|
|
</term>
|
|
<listitem>Size of the standard text buffer (default is 256 bytes).
|
|
This buffer is used for intermediary text, such as individual lines,
|
|
output from $exec vars, and various other variables. Increasing the
|
|
size of this buffer can drastically reduce Conky's performance, but
|
|
will allow for more text display per variable. The size of this buffer
|
|
cannot be smaller than the default value of 256 bytes.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>times_in_seconds</option>
|
|
</command>
|
|
</term>
|
|
<listitem>If true, variables that output times output a number that
|
|
represents seconds. This doesn't affect $time, $tztime and $utime.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>top_cpu_separate</option>
|
|
</command>
|
|
</term>
|
|
<listitem>If true, cpu in top will show usage of one processor's
|
|
power. If false, cpu in top will show the usage of all processors'
|
|
power combined.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>top_name_verbose</option>
|
|
</command>
|
|
</term>
|
|
<listitem>If true, top name shows the full command line of each
|
|
process, including arguments (whenever possible). Otherwise, only the
|
|
basename is displayed. Default value is false.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>top_name_width</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Width for $top name value (defaults to 15 characters).
|
|
<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 /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>units_spacer</option>
|
|
</command>
|
|
</term>
|
|
<listitem>String to place between values and units. (default: empty)
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>update_interval</option>
|
|
</command>
|
|
<option>seconds</option>
|
|
</term>
|
|
<listitem>Update interval.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>update_interval_on_battery</option>
|
|
</command>
|
|
<option>seconds</option>
|
|
</term>
|
|
<listitem>Update interval when running on battery power.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>detect_battery</option>
|
|
</command>
|
|
</term>
|
|
<listitem>One or more batteries to check in order to use
|
|
update_interval_on_battery (comma separated, BAT0 default).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>uppercase</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Boolean value, if true, text is rendered in upper case.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>lowercase</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Boolean value, if true, text is rendered in lower case.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>use_spacer</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Adds spaces around certain objects to stop them from moving
|
|
other things around. Arguments are left, right, and none (default).
|
|
The old true/false values are deprecated and default to right/none
|
|
respectively. Note that this only helps if you are using a mono font,
|
|
such as Bitstream Vera Sans Mono.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>use_xft</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Use Xft (anti-aliased font and stuff).
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>
|
|
<command>
|
|
<option>xftalpha</option>
|
|
</command>
|
|
</term>
|
|
<listitem>Alpha of Xft font. Must be a value at or between 1 and 0.
|
|
<para /></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|