conky/doc/config_settings.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>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&amp;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 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
        (&lt;hostname&gt;)".
        <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-&gt;k, GiB-&gt;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' -&gt; newline</member>
            <member>'\\' -&gt; backslash</member>
            <member>'\ ' -&gt; space</member>
            <member>'\N' -&gt; 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 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>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>