mirror of
https://github.com/Llewellynvdm/conky.git
synced 2024-09-29 21:49:07 +00:00
c1ef8c5cd4
* Add config option to disable blending This is intended to work around issues with some images blending incorrectly with ARGB visuals. * Fix order of config documentation. * Update configuration variable name to simply "draw_blended". * Fix for SonarCloud malloc warning. * Update free to delete as part of malloc change.
1139 lines
36 KiB
XML
1139 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 abreviated 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>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. Example: " ,_,=,#".
|
|
<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_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 it's 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 /usr/lib/X11/rgb.txt)
|
|
<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>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 batterypower
|
|
<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>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>
|