<varlistentry>
<term>
<command>
- <option>alias</option>
- </command>
- </term>
- <listitem>Use this to create aliases of variables. The
- first argument is the new name, the second the old name,
- and the other arguments are passed on to the variable.
- Example: If you want to use $alpha instead of ${beta gamma
- delta} then you have to write the following: alias alpha
- beta gamma delta . PS: Instead of creating an alias in the
- config you can also use environment variables. Example:
- Start conky like this: alpha="beta gamma delta" conky
- <para /></listitem>
- </varlistentry>
- <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_right, or none (also can
- be abreviated as tl, tr, tm, bl, br, bm, ml, mr). See also
- gap_x and gap_y.
+ 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>
<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>
<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>
<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>if_up_strictness</option>
</command>
</term>
</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
+ 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
<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>
+ <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>
<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>
<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>
<option>no_buffers</option>
</command>
</term>
- <listitem>Substract (file system) buffers from used memory?
+ <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>
<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>
</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)
+ value (e.g. ffffff, note the lack of '#') or a valid RGB
+ name (see /usr/lib/X11/rgb.txt)
<para /></listitem>
</varlistentry>
<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. Note that if own_window_transparent is enabled, this value has no effect.
+ <para /></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <command>
<option>own_window_transparent</option>
</command>
</term>
- <listitem>Boolean, set pseudo-transparency?
+ <listitem>Boolean, set transparency? If ARGB visual is enabled, sets
+ background opacity to 0%.
<para /></listitem>
</varlistentry>
<varlistentry>
<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.
+ <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>
</command>
</term>
<listitem>Default global POP3 server. Arguments are: "host
- user pass [-i interval (in seconds)] [-p port] [-e command]
+ 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
<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>
<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 in seconds
+ <listitem>Update interval when running on batterypower
<para /></listitem>
</varlistentry>
<varlistentry>