2009-04-09 21:20:10 +00:00
|
|
|
|
conky(1) conky(1)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mNAME[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
conky - A system monitor for X originally based on the torsmo code, but
|
2009-04-09 21:20:10 +00:00
|
|
|
|
more kickass. It just keeps on given'er. Yeah.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mSYNOPSIS[0m
|
|
|
|
|
[1mconky [22m[[4moptions[24m]
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mDESCRIPTION[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
Conky is a system monitor for X originally based on torsmo. Since its
|
|
|
|
|
inception, Conky has changed significantly from its predecessor, while
|
2009-04-09 21:20:10 +00:00
|
|
|
|
maintaining simplicity and configurability. Conky can display just
|
|
|
|
|
about anything, either on your root desktop or in its own window. Not
|
|
|
|
|
only does Conky have many built-in objects, it can also display just
|
2008-12-09 04:26:12 +00:00
|
|
|
|
about any piece of information by using scripts and other external pro‐
|
|
|
|
|
grams.
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Conky has more than 250 built in objects, including support for a
|
|
|
|
|
plethora of OS stats (uname, uptime, CPU usage, mem usage, disk usage,
|
|
|
|
|
"top" like process stats, and network monitoring, just to name a few),
|
2008-12-09 04:26:12 +00:00
|
|
|
|
built in IMAP and POP3 support, built in support for many popular music
|
|
|
|
|
players (MPD, XMMS2, BMPx, Audacious), and much much more. Conky can
|
2009-04-09 21:20:10 +00:00
|
|
|
|
display this info either as text, or using simple progress bars and
|
2008-12-09 04:26:12 +00:00
|
|
|
|
graph widgets, with different fonts and colours.
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
We are always looking for help, whether its reporting bugs, writing
|
|
|
|
|
patches, or writing docs. Please use the facilities at SourceForge to
|
|
|
|
|
make bug reports, feature requests, and submit patches, or stop by
|
2008-12-09 04:26:12 +00:00
|
|
|
|
#conky on irc.freenode.net if you have questions or want to contribute.
|
|
|
|
|
|
|
|
|
|
Thanks for your interest in Conky.
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mCOMPILING[0m
|
|
|
|
|
For users compiling from source on a binary distro, make sure you have
|
|
|
|
|
the X development libraries installed. This should be a package along
|
|
|
|
|
the lines of "libx11-dev" or "xorg-x11-dev" for X11 libs, and similar
|
|
|
|
|
"-dev" format for the other libs required (depending on your configure
|
2008-12-09 04:26:12 +00:00
|
|
|
|
options).
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Conky has (for some time) been available in the repositories of most
|
|
|
|
|
popular distributions. Here are some installation instructions for a
|
2008-12-09 04:26:12 +00:00
|
|
|
|
few:
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Gentoo users -- Conky is in Gentoo's Portage... simply use "emerge app-
|
|
|
|
|
admin/conky" for installation. There is also usually an up-to-date
|
|
|
|
|
ebuild within Conky's package or in the git repo.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Debian, etc. users -- Conky should be in your repositories, and can be
|
2008-12-09 04:26:12 +00:00
|
|
|
|
installed by doing "aptitude install conky".
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Example to compile and run Conky with all optional components (note
|
2008-12-09 04:26:12 +00:00
|
|
|
|
that some configure options may differ for your system):
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1msh autogen.sh # Only required if building from the git repo[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m./configure --prefix=/usr --mandir=/usr/share/man --in‐[0m
|
|
|
|
|
[1mfodir=/usr/share/info --datadir=/usr/share --sysconfdir=/etc --local‐[0m
|
|
|
|
|
[1mstatedir=/var/lib --disable-own-window --enable-audacious[=yes|no|lega‐[0m
|
|
|
|
|
[1mcy] --enable-bmpx --disable-hddtemp --disable-mpd --enable-xmms2 --dis‐[0m
|
|
|
|
|
[1mable-portmon --disable-network --enable-debug --disable-x11 --dis‐[0m
|
|
|
|
|
[1mable-double-buffer --disable-xdamage --disable-xft[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmake[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmake install # Optional[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1msrc/conky[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
Conky has been tested to be compatible with C99 C, however it has not
|
|
|
|
|
been tested with anything other than gcc, and is not guaranteed to work
|
|
|
|
|
with other compilers.
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mYOU SHOULD KNOW[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
Conky is generally very good on resources. That said, the more you try
|
|
|
|
|
to make Conky do, the more resources it is going to consume.
|
|
|
|
|
|
|
|
|
|
An easy way to force Conky to reload your ~/.conkyrc: "killall -SIGUSR1
|
2009-04-09 21:20:10 +00:00
|
|
|
|
conky". Saves you the trouble of having to kill and then restart. You
|
2008-12-09 04:26:12 +00:00
|
|
|
|
can now also do the same with SIGHUP.
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mOPTIONS[0m
|
|
|
|
|
Command line options override configurations defined in configuration
|
2008-12-09 04:26:12 +00:00
|
|
|
|
file.
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-v | -V | --version[0m
|
|
|
|
|
Prints version and exits
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-q | --quiet[0m
|
|
|
|
|
Run Conky in 'quiet mode' (ie. no output)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-a | --alignment=ALIGNMENT[0m
|
|
|
|
|
Text alignment on screen, {top,bottom,middle}_{left,right,mid‐
|
|
|
|
|
dle} or none
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-b | --double-buffer[0m
|
|
|
|
|
Use double buffering (eliminates "flicker")
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-c | --config=FILE[0m
|
|
|
|
|
Config file to load instead of $HOME/.conkyrc
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-d | --daemonize[0m
|
|
|
|
|
Daemonize Conky, aka fork to background
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-f | --font=FONT[0m
|
|
|
|
|
Font to use
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-h | --help[0m
|
|
|
|
|
Prints command line help and exits
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-o | --own-window[0m
|
|
|
|
|
Create own window to draw
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-t | --text=TEXT[0m
|
|
|
|
|
Text to render, remember single quotes, like -t ' $uptime '
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-u | --interval=SECONDS[0m
|
|
|
|
|
Update interval
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-w | --window-id=WIN_ID[0m
|
|
|
|
|
Window id to draw
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-x X_COORDINATE[0m
|
|
|
|
|
X position
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-y Y_COORDINATE[0m
|
|
|
|
|
Y position
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1m-i COUNT[0m
|
|
|
|
|
Number of times to update Conky (and quit)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mCONFIGURATION SETTINGS[0m
|
|
|
|
|
Default configuration file location is $HOME/.conkyrc or
|
|
|
|
|
${sysconfdir}/conky/conky.conf. On most systems, sysconfdir is /etc,
|
|
|
|
|
and you can find the sample config file there (/etc/conky/conky.conf).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
You might want to copy it to $HOME/.conkyrc and then start modifying
|
2008-12-09 04:26:12 +00:00
|
|
|
|
it. Other configs can be found at http://conky.sf.net/
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1malias [22mUse 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 $al‐
|
|
|
|
|
pha instead of ${beta gamma delta} then you have to write the
|
|
|
|
|
following: alias alpha beta gamma delta . PS: Instead of creat‐
|
|
|
|
|
ing an alias in the config you can also use environment vari‐
|
|
|
|
|
ables. Example: Start conky like this: alpha="beta gamma delta"
|
|
|
|
|
conky
|
2009-03-07 14:12:09 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1malignment[0m
|
|
|
|
|
Aligned position on screen, may be top_left, top_right, top_mid‐
|
|
|
|
|
dle, bottom_left, bottom_right, bottom_middle, middle_left, mid‐
|
|
|
|
|
dle_right, or none (also can be abreviated as tl, tr, tm, bl,
|
|
|
|
|
br, bm, ml, mr)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbackground[0m
|
|
|
|
|
Boolean value, if true, Conky will be forked to background when
|
|
|
|
|
started
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mborder_margin[0m
|
|
|
|
|
Border margin in pixels
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mborder_width[0m
|
|
|
|
|
Border width in pixels
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcolorN [22mPredefine a color for use inside TEXT segments. Substitute N by
|
|
|
|
|
a digit between 0 and 9, inclusively. When specifying the color
|
|
|
|
|
value in hex, omit the leading hash (#).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcpu_avg_samples[0m
|
|
|
|
|
The number of samples to average for CPU monitoring
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtop_cpu_separate[0m
|
|
|
|
|
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.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 22:00:40 +00:00
|
|
|
|
[1mdefault_bar_size[0m
|
|
|
|
|
Specify a default width and height for bars. Example: 'de‐
|
|
|
|
|
fault_bar_size 0 6'. This is particularly useful for execbar and
|
|
|
|
|
execibar as they do not take size arguments
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[1mdefault_graph_size[0m
|
|
|
|
|
Specify a default width and height for graphs. Example: 'de‐
|
|
|
|
|
fault_graph_size 0 25'. This is particularly useful for exec‐
|
|
|
|
|
graph and execigraph as they do not take size arguments
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[1mdefault_gauge_size[0m
|
|
|
|
|
Specify a default width and height for gauges. Example: 'de‐
|
|
|
|
|
fault_gauge_size 25 25'. This is particularly useful for exec‐
|
|
|
|
|
gauge and execigauge as they do not take size arguments
|
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdefault_color[0m
|
|
|
|
|
Default color and border color
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdefault_outline_color[0m
|
|
|
|
|
Default outline color
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdefault_shade_color[0m
|
|
|
|
|
Default shading color and border's shading color
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdouble_buffer[0m
|
|
|
|
|
Use the Xdbe extension? (eliminates flicker) It is highly recom‐
|
|
|
|
|
mended to use own window with this one so double buffer won't be
|
|
|
|
|
so big.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdraw_borders[0m
|
|
|
|
|
Draw borders around text?
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdraw_graph_borders[0m
|
|
|
|
|
Draw borders around graphs?
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdraw_outline[0m
|
|
|
|
|
Draw outlines?
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdraw_shades[0m
|
|
|
|
|
Draw shades?
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfont [22mFont name in X, xfontsel can be used to get a nice font
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mgap_x [22mGap, in pixels, between right or left border of screen, same as
|
|
|
|
|
passing -x at command line, e.g. gap_x 10
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mgap_y [22mGap, in pixels, between top or bottom border of screen, same as
|
|
|
|
|
passing -y at command line, e.g. gap_y 10.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_up_strictness[0m
|
|
|
|
|
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.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mimap [22mDefault global IMAP server. Arguments are: "host user pass [-i
|
|
|
|
|
interval] [-f folder] [-p port] [-e command] [-r retries]". De‐
|
|
|
|
|
fault 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.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmail_spool[0m
|
|
|
|
|
Mail spool for mail checking
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmax_port_monitor_connections[0m
|
|
|
|
|
Allow each port monitor to track at most this many connections
|
|
|
|
|
(if 0 or not set, default is 256)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmax_specials[0m
|
|
|
|
|
Maximum number of special things, e.g. fonts, offsets, aligns,
|
|
|
|
|
etc. (default is 512)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmax_user_text bytes[0m
|
|
|
|
|
Maximum size of user text buffer, i.e. layout below TEXT line in
|
|
|
|
|
config file (default is 16384 bytes)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtext_buffer_size bytes[0m
|
|
|
|
|
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 perfor‐
|
|
|
|
|
mance, but will allow for more text display per variable. The
|
|
|
|
|
size of this buffer cannot be smaller than the default value of
|
|
|
|
|
256 bytes.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmaximum_width pixels[0m
|
|
|
|
|
Maximum width of window
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mminimum_size width (height)[0m
|
|
|
|
|
Minimum size of window
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_host[0m
|
|
|
|
|
Host of MPD server
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_port[0m
|
|
|
|
|
Port of MPD server
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_password[0m
|
|
|
|
|
MPD server password
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmusic_player_interval[0m
|
|
|
|
|
Music player thread update interval (defaults to Conky's update
|
|
|
|
|
interval)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mnet_avg_samples[0m
|
|
|
|
|
The number of samples to average for net data
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mno_buffers[0m
|
|
|
|
|
Substract (file system) buffers from used memory?
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1moverride_utf8_locale[0m
|
|
|
|
|
Force UTF8? requires XFT
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mown_window[0m
|
|
|
|
|
Boolean, create own window to draw?
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mown_window_class[0m
|
|
|
|
|
Manually set the WM_CLASS name. Defaults to "Conky".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mown_window_colour colour[0m
|
|
|
|
|
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)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mown_window_hints undecorated,below,above,sticky,skip_taskbar,skip_pager[0m
|
|
|
|
|
If own_window is yes, you may use these window manager hints to
|
|
|
|
|
affect the way Conky displays. Notes: Use own_window_type desk‐
|
|
|
|
|
top 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.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mown_window_title[0m
|
|
|
|
|
Manually set the window name. Defaults to "<hostname> - conky".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mown_window_transparent[0m
|
|
|
|
|
Boolean, set pseudo-transparency?
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mown_window_type[0m
|
|
|
|
|
if own_window is yes, you may specify type normal, desktop, dock
|
|
|
|
|
or override (default: normal). Desktop windows are special win‐
|
|
|
|
|
dows 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. Override windows are not under the con‐
|
|
|
|
|
trol of the window manager. Hints are ignored. This type of win‐
|
|
|
|
|
dow can be useful for certain situations.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mout_to_console[0m
|
|
|
|
|
Print text to stdout.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mout_to_stderr[0m
|
|
|
|
|
Print text to stderr.
|
2009-02-18 04:45:06 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mout_to_x[0m
|
|
|
|
|
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
|
2009-02-18 04:45:06 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1moverwrite_file[0m
|
|
|
|
|
Overwrite the file given as argument.
|
2009-02-18 04:45:06 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mappend_file[0m
|
|
|
|
|
Append the file given as argument.
|
2009-02-18 04:45:06 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mpad_percents[0m
|
|
|
|
|
Pad percentages to this many decimals (0 = no padding)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mpop3 [22mDefault global POP3 server. Arguments are: "host user pass [-i
|
|
|
|
|
interval] [-p port] [-e command] [-r retries]". Default port is
|
|
|
|
|
110, default interval is 5 minutes, and default number of re‐
|
|
|
|
|
tries before giving up is 5. If the password is supplied as '*',
|
|
|
|
|
you will be prompted to enter the password when Conky starts.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mshort_units[0m
|
|
|
|
|
Shortens units to a single character (kiB->k, GiB->G, etc.). De‐
|
|
|
|
|
fault is off.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mshow_graph_scale[0m
|
|
|
|
|
Shows the maximum value in scaled graphs.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mshow_graph_range[0m
|
|
|
|
|
Shows the time range covered by a graph.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mstippled_borders[0m
|
|
|
|
|
Border stippling (dashing) in pixels
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtemperature_unit[0m
|
|
|
|
|
Desired output unit of all objects displaying a temperature.
|
|
|
|
|
Parameters are either "fahrenheit" or "celsius". The default
|
|
|
|
|
unit is degree Celsius.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtemplateN[0m
|
|
|
|
|
Define a template for later use inside TEXT segments. Substitute
|
|
|
|
|
N by a digit between 0 and 9, inclusively. The value of the
|
|
|
|
|
variable is being inserted into the stuff below TEXT at the cor‐
|
|
|
|
|
responding position, but before some substitutions are applied:
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
'\n' -> newline
|
|
|
|
|
'\\' -> backslash
|
|
|
|
|
'\ ' -> space
|
|
|
|
|
'\N' -> template argument N
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtotal_run_times[0m
|
|
|
|
|
Total number of times for Conky to update before quitting. Zero
|
|
|
|
|
makes Conky run forever
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mupdate_interval[0m
|
|
|
|
|
Update interval in seconds
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muppercase[0m
|
|
|
|
|
Boolean value, if true, text is rendered in upper case
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muse_spacer[0m
|
|
|
|
|
Adds spaces around certain objects to stop them from moving oth‐
|
|
|
|
|
er 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.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muse_xft[0m
|
|
|
|
|
Use Xft (anti-aliased font and stuff)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxftalpha[0m
|
|
|
|
|
Alpha of Xft font. Must be a value at or between 1 and 0.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxftfont[0m
|
|
|
|
|
Xft font to use.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mTEXT [22mAfter this begins text to be formatted on screen. Backslash (\)
|
|
|
|
|
escapes newlines in the text section. This can be useful for
|
|
|
|
|
cleaning up config files where conky is used to pipe input to
|
|
|
|
|
dzen2.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mVARIABLES[0m
|
2009-03-16 04:14:07 +00:00
|
|
|
|
Colors are parsed using XParsecolor(), there might be a list of them:
|
2009-04-09 21:20:10 +00:00
|
|
|
|
/usr/share/X11/rgb.txt. Also, ⟨http://sedition.com/perl/rgb.html⟩.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
Color can be also in #rrggbb format (hex).
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maddr interface[0m
|
|
|
|
|
IP address for an interface, or "No Address" if no address is
|
|
|
|
|
assigned.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maddrs interface[0m
|
|
|
|
|
IP addresses for an interface (if one - works like addr). Linux
|
|
|
|
|
only.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1macpiacadapter[0m
|
|
|
|
|
ACPI ac adapter state.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1macpifan[0m
|
|
|
|
|
ACPI fan state
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1macpitemp[0m
|
|
|
|
|
ACPI temperature in C.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1madt746xcpu[0m
|
|
|
|
|
CPU temperature from therm_adt746x
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1madt746xfan[0m
|
|
|
|
|
Fan speed from therm_adt746x
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1malignr (num)[0m
|
|
|
|
|
Right-justify text, with space of N
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1malignc (num)[0m
|
|
|
|
|
Align text to centre
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mapm_adapter[0m
|
|
|
|
|
Display APM AC adapter status (FreeBSD only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mapm_battery_life[0m
|
|
|
|
|
Display APM battery life in percent (FreeBSD only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mapm_battery_time[0m
|
|
|
|
|
Display remaining APM battery life in hh:mm:ss or "unknown" if
|
|
|
|
|
AC adapterstatus is on-line or charging (FreeBSD only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_bar (height),(width)[0m
|
|
|
|
|
Progress bar
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_bitrate[0m
|
|
|
|
|
Bitrate of current tune
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_channels[0m
|
|
|
|
|
Number of audio channels of current tune
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_filename[0m
|
|
|
|
|
Full path and filename of current tune
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_frequency[0m
|
|
|
|
|
Sampling frequency of current tune
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_length[0m
|
|
|
|
|
Total length of current tune as MM:SS
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_length_seconds[0m
|
|
|
|
|
Total length of current tune in seconds
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_playlist_position[0m
|
|
|
|
|
Playlist position of current tune
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_playlist_length[0m
|
|
|
|
|
Number of tunes in playlist
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_position[0m
|
|
|
|
|
Position of current tune (MM:SS)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_position_seconds[0m
|
|
|
|
|
Position of current tune in seconds
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_status[0m
|
|
|
|
|
Player status (Playing/Paused/Stopped/Not running)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_title (max length)[0m
|
|
|
|
|
Title of current tune with optional maximum length specifier
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1maudacious_main_volume[0m
|
|
|
|
|
The current volume fetched from Audacious
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbattery (num)[0m
|
|
|
|
|
Battery status and remaining percentage capacity of ACPI or APM
|
|
|
|
|
battery. ACPI battery number can be given as argument (default
|
|
|
|
|
is BAT0).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbattery_short (num)[0m
|
|
|
|
|
Battery status and remaining percentage capacity of ACPI or APM
|
|
|
|
|
battery. ACPI battery number can be given as argument (default
|
|
|
|
|
is BAT0). This mode display a short status, which means that C
|
|
|
|
|
is displayed instead of charging and D is displayed instead of
|
|
|
|
|
discharging.
|
2009-02-18 04:49:45 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbattery_bar (height),(width) (num)[0m
|
|
|
|
|
Battery percentage remaining of ACPI battery in a bar. ACPI bat‐
|
|
|
|
|
tery number can be given as argument (default is BAT0).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbattery_percent (num)[0m
|
|
|
|
|
Battery percentage remaining for ACPI battery. ACPI battery num‐
|
|
|
|
|
ber can be given as argument (default is BAT0).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbattery_time (num)[0m
|
|
|
|
|
Battery charge/discharge time remaining of ACPI battery. ACPI
|
|
|
|
|
battery number can be given as argument (default is BAT0).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbmpx_artist[0m
|
|
|
|
|
Artist in current BMPx track
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbmpx_album[0m
|
|
|
|
|
Album in current BMPx track
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbmpx_title[0m
|
|
|
|
|
Title of the current BMPx track
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbmpx_track[0m
|
|
|
|
|
Track number of the current BMPx track
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbmpx_bitrate[0m
|
|
|
|
|
Bitrate of the current BMPx track
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbmpx_uri[0m
|
|
|
|
|
URI of the current BMPx track
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mbuffers[0m
|
|
|
|
|
Amount of memory buffered
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcached [22mAmount of memory cached
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcolor (color)[0m
|
|
|
|
|
Change drawing color to color
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcolorN [22mChange drawing color to colorN configuration option, where N is
|
|
|
|
|
a digit between 0 and 9, inclusively.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mconky_version[0m
|
|
|
|
|
Conky version
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mconky_build_date[0m
|
|
|
|
|
Date Conky was built
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mconky_build_arch[0m
|
|
|
|
|
CPU architecture Conky was built for
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcpu (cpuN)[0m
|
|
|
|
|
CPU usage in percents. For SMP machines, the CPU number can be
|
|
|
|
|
provided as an argument. ${cpu cpu0} is the total usage, and
|
|
|
|
|
${cpu cpuX} (X >= 1) are individual CPUs.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcpubar (cpuN) (height),(width)[0m
|
|
|
|
|
Bar that shows CPU usage, height is bar's height in pixels. See
|
|
|
|
|
$cpu for more info on SMP.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcpugauge (cpuN) (height),(width)[0m
|
|
|
|
|
Elliptical gauge that shows CPU usage, height and width are
|
|
|
|
|
gauge's vertical and horizontal axis respectively. See $cpu for
|
|
|
|
|
more info on SMP.
|
2009-03-18 05:26:56 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcpugraph (cpuN) ("normal"|"log") (height),(width) (gradient colour 1)[0m
|
|
|
|
|
[1m(gradient colour 2) (scale)[0m
|
|
|
|
|
CPU usage graph, with optional colours in hex, minus the #. See
|
|
|
|
|
$cpu for more info on SMP. Uses a logarithmic scale (to see
|
|
|
|
|
small numbers) when you use "log" instead of "normal".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdiskio (device)[0m
|
|
|
|
|
Displays current disk IO. Device is optional, and takes the form
|
|
|
|
|
of sda for /dev/sda. Individual partitions are allowed.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdiskiograph ("normal"|"log") (height),(width) (gradient colour 1) (gra‐[0m
|
|
|
|
|
[1mdient colour 2) (scale) (device)[0m
|
|
|
|
|
Disk IO graph, colours defined in hex, minus the #. If scale is
|
|
|
|
|
non-zero, it becomes the scale for the graph. Uses a logarithmic
|
|
|
|
|
scale (to see small numbers) when you use "log" instead of "nor‐
|
|
|
|
|
mal".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdiskio_read (device)[0m
|
|
|
|
|
Displays current disk IO for reads. Device as in diskio.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdiskiograph_read ("normal"|"log") (height),(width) (gradient colour 1)[0m
|
|
|
|
|
[1m(gradient colour 2) (scale) (device)[0m
|
|
|
|
|
Disk IO graph for reads, colours defined in hex, minus the #. If
|
|
|
|
|
scale is non-zero, it becomes the scale for the graph. Device as
|
|
|
|
|
in diskio. Uses a logarithmic scale (to see small numbers) when
|
|
|
|
|
you use "log" instead of "normal".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdiskio_write (device)[0m
|
|
|
|
|
Displays current disk IO for writes. Device as in diskio.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdiskiograph_write ("normal"|"log") (height),(width) (gradient colour 1)[0m
|
|
|
|
|
[1m(gradient colour 2) (scale) (device)[0m
|
|
|
|
|
Disk IO graph for writes, colours defined in hex, minus the #.
|
|
|
|
|
If scale is non-zero, it becomes the scale for the graph. Device
|
|
|
|
|
as in diskio. Uses a logarithmic scale (to see small numbers)
|
|
|
|
|
when you use "log" instead of "normal".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdisk_protect device[0m
|
|
|
|
|
Disk protection status, if supported (needs kernel-patch).
|
|
|
|
|
Prints either "frozen" or "free " (note the padding).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdownspeed net[0m
|
|
|
|
|
Download speed in KiB
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdownspeedf net[0m
|
|
|
|
|
Download speed in KiB with one decimal
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdownspeedgraph ("normal"|"log") (height),(width) (gradient colour 1)[0m
|
|
|
|
|
[1m(gradient colour 2) (scale) (net)[0m
|
|
|
|
|
Download speed graph, colours defined in hex, minus the #. If
|
|
|
|
|
scale is non-zero, it becomes the scale for the graph. Uses a
|
|
|
|
|
logarithmic scale (to see small numbers) when you use "log" in‐
|
|
|
|
|
stead of "normal".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1melse [22mText to show if any of the above are not true
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mentropy_avail[0m
|
|
|
|
|
Current entropy available for crypto freaks
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mentropy_bar (height),(width)[0m
|
|
|
|
|
Normalized bar of available entropy for crypto freaks
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mentropy_poolsize[0m
|
|
|
|
|
Total size of system entropy pool for crypto freaks
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1meval string[0m
|
|
|
|
|
Evalutates given string according to the rules of TEXT interpre‐
|
|
|
|
|
tation, i.e. parsing any contained text object specifications
|
|
|
|
|
into their output, any occuring '$$' into a single '$' and so
|
|
|
|
|
on. The output is then being parsed again.
|
2009-03-24 00:25:56 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexec command[0m
|
|
|
|
|
Executes a shell command and displays the output in conky. warn‐
|
|
|
|
|
ing: this takes a lot more resources than other variables. I'd
|
|
|
|
|
recommend coding wanted behaviour in C and posting a patch.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexecbar command[0m
|
|
|
|
|
Same as exec, except if the first value return is a value be‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
tween 0-100, it will use that number for a bar. The size for
|
|
|
|
|
bars can be controlled via the default_bar_size config setting.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexecgauge command[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Same as exec, except if the first value returned is a value be‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
tween 0-100, it will use that number for a gauge. The size for
|
2009-04-10 02:18:19 +00:00
|
|
|
|
gauges can be controlled via the default_gauge_size config set‐
|
|
|
|
|
ting.
|
2009-03-18 05:26:56 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexecgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
|
|
|
|
[1ment colour 2) (scale) command[0m
|
|
|
|
|
Same as execbar, but graphs values. Uses a logaritmic scale when
|
|
|
|
|
the log option is given (to see small numbers). Values still
|
2009-04-10 02:18:19 +00:00
|
|
|
|
have to be between 0 and 100. The size for graphs can be con‐
|
|
|
|
|
trolled via the default_graph_size config setting.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexeci interval command[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Same as exec but with specific interval. Interval can't be less
|
2009-04-09 21:20:10 +00:00
|
|
|
|
than update_interval in configuration. See also $texeci
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexecibar interval command[0m
|
|
|
|
|
Same as execbar, except with an interval
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexecigraph interval command[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Same as execgraph, but takes an interval arg and graphs values.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
[1mexecigauge interval command[0m
|
|
|
|
|
Same as execgauge, but takes an interval arg and gauges values.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexecp command[0m
|
|
|
|
|
Executes a shell command and displays the output in conky. warn‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
ing: this takes a lot more resources than other variables. I'd
|
2009-04-09 21:20:10 +00:00
|
|
|
|
recommend coding wanted behaviour in C and posting a patch. This
|
2009-04-10 02:18:19 +00:00
|
|
|
|
differs from $exec in that it parses the output of the command,
|
|
|
|
|
so you can insert things like ${color red}hi!${color} in your
|
|
|
|
|
script and have it correctly parsed by Conky. Caveats: Conky
|
|
|
|
|
parses and evaluates the output of $execp every time Conky
|
2009-04-09 21:20:10 +00:00
|
|
|
|
loops, and then destroys all the objects. If you try to use any‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
thing like $execi within an $execp statement, it will function‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
ally run at the same interval that the $execp statement runs, as
|
|
|
|
|
it is created and destroyed at every interval.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mexecpi interval command[0m
|
|
|
|
|
Same as execp but with specific interval. Interval can't be less
|
|
|
|
|
than update_interval in configuration. Note that the output from
|
2009-04-10 02:18:19 +00:00
|
|
|
|
the $execpi command is still parsed and evaluated at every in‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
terval.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfont (font)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Specify a different font. This new font will apply to the cur‐
|
|
|
|
|
rent line and everything following. You can use a $font with no
|
|
|
|
|
arguments to change back to the default font (much like with
|
2009-04-09 21:20:10 +00:00
|
|
|
|
$color)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfreq (n)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Returns CPU #n's frequency in MHz. CPUs are counted from 1. If
|
2009-04-09 21:20:10 +00:00
|
|
|
|
omitted, the parameter defaults to 1.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfreq_g (n)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Returns CPU #n's frequency in GHz. CPUs are counted from 1. If
|
2009-04-09 21:20:10 +00:00
|
|
|
|
omitted, the parameter defaults to 1.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfreq_dyn (n)[0m
|
|
|
|
|
Returns CPU #n's frequency in MHz (defaults to 1), but is calcu‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
lated by counting to clock cycles to complete an instruction.
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Only available for x86/amd64.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfreq_dyn_g (n)[0m
|
|
|
|
|
Returns CPU #n's frequency in GHz (defaults to 1), but is calcu‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
lated by counting to clock cycles to complete an instruction.
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Only available for x86/amd64.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfs_bar (height),(width) fs[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Bar that shows how much space is used on a file system. height
|
2009-04-09 21:20:10 +00:00
|
|
|
|
is the height in pixels. fs is any file on that file system.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfs_free (fs)[0m
|
|
|
|
|
Free space on a file system available for users.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfs_free_perc (fs)[0m
|
|
|
|
|
Free percentage of space on a file system available for users.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfs_size (fs)[0m
|
|
|
|
|
File system size
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfs_type (fs)[0m
|
|
|
|
|
File system type
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mfs_used (fs)[0m
|
|
|
|
|
File system used space
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mgoto x [22mThe next element will be printed at position 'x'.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mgw_iface[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Displays the default route's interface or "multiple"/"none" ac‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
cordingly.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-10 02:18:19 +00:00
|
|
|
|
[1mgw_ip [22mDisplays the default gateway's IP or "multiple"/"none" accord‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
ingly.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mhddtemp dev, (host,(port))[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Displays temperature of a selected hard disk drive as reported
|
|
|
|
|
by the hddtemp daemon running on host:port. Default host is
|
2009-04-09 21:20:10 +00:00
|
|
|
|
127.0.0.1, default port is 7634.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mhead logfile lines (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Displays first N lines of supplied text text file. If interval
|
|
|
|
|
is not supplied, Conky assumes 2x Conky's interval. Max of 30
|
2009-04-09 21:20:10 +00:00
|
|
|
|
lines can be displayed, or until the text buffer is filled.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mhr (height)[0m
|
|
|
|
|
Horizontal line, height is the height in pixels
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mhwmon (dev) type n[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Hwmon sensor from sysfs (Linux 2.6). Parameter dev may be omit‐
|
|
|
|
|
ted if you have only one hwmon device. Parameter type is either
|
2009-04-09 21:20:10 +00:00
|
|
|
|
'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning
|
2009-04-10 02:18:19 +00:00
|
|
|
|
temperature. Parameter n is number of the sensor. See
|
2009-04-09 21:20:10 +00:00
|
|
|
|
/sys/class/hwmon/ on your local computer.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1miconv_start codeset_from codeset_to[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Convert text from one codeset to another using GNU iconv. Needs
|
2009-04-09 21:20:10 +00:00
|
|
|
|
to be stopped with iconv_stop.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1miconv_stop[0m
|
|
|
|
|
Stop iconv codeset conversion.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi2c (dev) type n[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
I2C sensor from sysfs (Linux 2.6). Parameter dev may be omitted
|
|
|
|
|
if you have only one I2C device. Parameter type is either 'in'
|
2009-04-09 21:20:10 +00:00
|
|
|
|
or 'vol' meaning voltage; 'fan' meaning fan; 'temp' meaning tem‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
perature. Parameter n is number of the sensor. See
|
2009-04-09 21:20:10 +00:00
|
|
|
|
/sys/bus/i2c/devices/ on your local computer.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_ac_status[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
|
|
|
|
whether ac power is on, as listed in /proc/i8k (translated to
|
|
|
|
|
human-readable). Beware that this is by default not enabled by
|
2009-04-09 21:20:10 +00:00
|
|
|
|
i8k itself.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_bios[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2009-04-09 21:20:10 +00:00
|
|
|
|
the bios version as listed in /proc/i8k.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_buttons_status[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2009-04-09 21:20:10 +00:00
|
|
|
|
the volume buttons status as listed in /proc/i8k.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_cpu_temp[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2009-04-09 21:20:10 +00:00
|
|
|
|
the cpu temperature in Celsius, as reported by /proc/i8k.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_left_fan_rpm[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
|
|
|
|
the left fan's rate of rotation, in revolutions per minute as
|
2009-04-09 21:20:10 +00:00
|
|
|
|
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
|
|
|
|
in reverse order.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_left_fan_status[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2009-04-09 21:20:10 +00:00
|
|
|
|
the left fan status as listed in /proc/i8k (translated to human-
|
2009-04-10 02:18:19 +00:00
|
|
|
|
readable). Beware, some laptops i8k reports these fans in re‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
verse order.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_right_fan_rpm[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
|
|
|
|
the right fan's rate of rotation, in revolutions per minute as
|
2009-04-09 21:20:10 +00:00
|
|
|
|
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
|
|
|
|
in reverse order.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_right_fan_status[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
|
|
|
|
the right fan status as listed in /proc/i8k (translated to hu‐
|
|
|
|
|
man-readable). Beware, some laptops i8k reports these fans in
|
2009-04-09 21:20:10 +00:00
|
|
|
|
reverse order.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_serial[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2009-04-09 21:20:10 +00:00
|
|
|
|
your laptop serial number as listed in /proc/i8k.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mi8k_version[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2009-04-09 21:20:10 +00:00
|
|
|
|
the version formatting of /proc/i8k.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mibm_fan[0m
|
|
|
|
|
If running the IBM ACPI, displays the fan speed.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mibm_temps N[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the IBM ACPI, displays the temperatures from the IBM
|
2009-04-09 21:20:10 +00:00
|
|
|
|
temperature sensors (N=0..7) Sensor 0 is on the CPU, 3 is on the
|
|
|
|
|
GPU.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mibm_volume[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If running the IBM ACPI, displays the "master" volume, con‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
trolled by the volume keys (0-14).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mibm_brightness[0m
|
|
|
|
|
If running the IBM ACPI, displays the brigtness of the laptops's
|
|
|
|
|
LCD (0-7).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_empty (var)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
if conky variable VAR is empty, display everything between
|
2009-04-09 21:20:10 +00:00
|
|
|
|
$if_empty and the matching $endif
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_existing file (string)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
if FILE exists, display everything between if_existing and the
|
|
|
|
|
matching $endif. The optional second paramater checks for FILE
|
|
|
|
|
containing the specified string and prints everything between
|
2009-04-09 21:20:10 +00:00
|
|
|
|
$if_existing and the matching $endif.
|
2008-12-20 01:31:00 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_gw [22mif there is at least one default gateway, display everything be‐
|
|
|
|
|
tween $if_gw and the matching $endif
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_match expression[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Evaluates the given boolean expression, printing everything be‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
tween $if_match and the matching $endif depending on whether the
|
2009-04-10 02:18:19 +00:00
|
|
|
|
evaluation returns true or not. Valid expressions consist of a
|
|
|
|
|
left side, an operator and a right side. Left and right sides
|
|
|
|
|
are being parsed for contained text objects before evaluation.
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Recognised left and right side types are:
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdouble[22m: argument consists of only digits and a single dot.
|
|
|
|
|
[1mlong[22m: argument consists of only digits.
|
|
|
|
|
[1mstring[22m: argument is enclosed in quotation mark or the checks for
|
|
|
|
|
double and long failed before.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Valid operands are: '>', '<', '>=', '<=', '==', '!='.
|
2008-12-20 01:31:00 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_running (process)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
if PROCESS is running, display everything $if_running and the
|
|
|
|
|
matching $endif. This uses the ``pidof'' command, so the -x
|
2009-04-09 21:20:10 +00:00
|
|
|
|
switch is also supported.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_mounted (mountpoint)[0m
|
|
|
|
|
if MOUNTPOINT is mounted, display everything between $if_mounted
|
|
|
|
|
and the matching $endif
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_smapi_bat_installed (INDEX)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
when using smapi, if the battery with index INDEX is installed,
|
|
|
|
|
display everything between $if_smapi_bat_installed and the
|
2009-04-09 21:20:10 +00:00
|
|
|
|
matching $endif
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_up (interface)[0m
|
|
|
|
|
if INTERFACE exists and is up, display everything between $if_up
|
|
|
|
|
and the matching $endif
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_updatenr (updatenr)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
If it's the UPDATENR-th time that conky updates, display every‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
thing between $if_updatenr and the matching $endif. The counter
|
2009-04-10 02:18:19 +00:00
|
|
|
|
resets when the highest UPDATENR is reached. Example :
|
2009-04-09 21:20:10 +00:00
|
|
|
|
"{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr
|
2009-04-10 02:18:19 +00:00
|
|
|
|
4}$endif" shows foo 25% of the time followed by bar 25% of the
|
2009-04-09 21:20:10 +00:00
|
|
|
|
time followed by nothing the other half of the time.
|
2009-03-01 14:10:01 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mimap_messages (args)[0m
|
|
|
|
|
Displays the number of messages in your global IMAP inbox by de‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
fault. You can define individual IMAP inboxes seperately by
|
2009-04-09 21:20:10 +00:00
|
|
|
|
passing arguments to this object. Arguments are: "host user pass
|
|
|
|
|
[-i interval] [-p port] [-e command] [-r retries]". Default port
|
|
|
|
|
is 143, default interval is 5 minutes, and default number of re‐
|
|
|
|
|
tries before giving up is 5. If the password is supplied as '*',
|
|
|
|
|
you will be prompted to enter the password when Conky starts.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mimap_unseen (args)[0m
|
|
|
|
|
Displays the number of unseen messages in your global IMAP inbox
|
|
|
|
|
by default. You can define individual IMAP inboxes seperately by
|
|
|
|
|
passing arguments to this object. Arguments are: "host user pass
|
|
|
|
|
[-i interval] [-p port] [-e command] [-r retries]". Default port
|
|
|
|
|
is 143, default interval is 5 minutes, and default number of re‐
|
|
|
|
|
tries before giving up is 5. If the password is supplied as '*',
|
|
|
|
|
you will be prompted to enter the password when Conky starts.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mioscheduler disk[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Prints the current ioscheduler used for the given disk name
|
2009-04-09 21:20:10 +00:00
|
|
|
|
(i.e. e.g. "hda" or "sdb")
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mkernel [22mKernel version
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mlaptop_mode[0m
|
|
|
|
|
The value of /proc/sys/vm/laptop_mode
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mloadavg[0m
|
|
|
|
|
(1,2,3)> System load average, 1 is for past 1 minute, 2 for past
|
|
|
|
|
5 minutes and 3 for past 15 minutes.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mloadgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
|
|
|
|
[1ment colour 2) (scale)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Load1 average graph, similar to xload, with optional colours in
|
|
|
|
|
hex, minus the #. Uses a logarithmic scale (to see small num‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
bers) when you use "log" instead of "normal".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mlines textfile[0m
|
|
|
|
|
Displays the number of lines in the given file
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmachine[0m
|
|
|
|
|
Machine, i686 for example
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmails (mailbox) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Mail count in the specified mailbox or your mail spool if not.
|
|
|
|
|
Both mbox and maildir type mailboxes are supported. You can use
|
|
|
|
|
a program like fetchmail to get mails from some server using
|
2009-04-09 21:20:10 +00:00
|
|
|
|
your favourite protocol. See also new_mails.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mnew_mails (mailbox) (interval)[0m
|
|
|
|
|
Unread mail count in the specified mailbox or mail spool if not.
|
|
|
|
|
Both mbox and maildir type mailboxes are supported.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mseen_mails (maildir) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Number of mails marked as seen in the specified mailbox or mail
|
|
|
|
|
spool if not. Only maildir type mailboxes are supported, mbox
|
2009-04-09 21:20:10 +00:00
|
|
|
|
type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1munseen_mails (maildir) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Number of new or unseen mails in the specified mailbox or mail
|
|
|
|
|
spool if not. Only maildir type mailboxes are supported, mbox
|
2009-04-09 21:20:10 +00:00
|
|
|
|
type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mflagged_mails (maildir) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Number of mails marked as flagged in the specified mailbox or
|
|
|
|
|
mail spool if not. Only maildir type mailboxes are supported,
|
2009-04-09 21:20:10 +00:00
|
|
|
|
mbox type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1munflagged_mails (maildir) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Number of mails not marked as flagged in the specified mailbox
|
2009-04-09 21:20:10 +00:00
|
|
|
|
or mail spool if not. Only maildir type mailboxes are supported,
|
|
|
|
|
mbox type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mforwarded_mails (maildir) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Number of mails marked as forwarded in the specified mailbox or
|
|
|
|
|
mail spool if not. Only maildir type mailboxes are supported,
|
2009-04-09 21:20:10 +00:00
|
|
|
|
mbox type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1munforwarded_mails (maildir) (interval)[0m
|
|
|
|
|
Number of mails not marked as forwarded in the specified mailbox
|
|
|
|
|
or mail spool if not. Only maildir type mailboxes are supported,
|
|
|
|
|
mbox type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mreplied_mails (maildir) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Number of mails marked as replied in the specified mailbox or
|
|
|
|
|
mail spool if not. Only maildir type mailboxes are supported,
|
2009-04-09 21:20:10 +00:00
|
|
|
|
mbox type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1munreplied_mails (maildir) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Number of mails not marked as replied in the specified mailbox
|
2009-04-09 21:20:10 +00:00
|
|
|
|
or mail spool if not. Only maildir type mailboxes are supported,
|
|
|
|
|
mbox type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mdraft_mails (maildir) (interval)[0m
|
|
|
|
|
Number of mails marked as draft in the specified mailbox or mail
|
2009-04-10 02:18:19 +00:00
|
|
|
|
spool if not. Only maildir type mailboxes are supported, mbox
|
2009-04-09 21:20:10 +00:00
|
|
|
|
type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtrashed_mails (maildir) (interval)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Number of mails marked as trashed in the specified mailbox or
|
|
|
|
|
mail spool if not. Only maildir type mailboxes are supported,
|
2009-04-09 21:20:10 +00:00
|
|
|
|
mbox type will return -1.
|
2009-02-18 05:26:15 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmboxscan (-n number of messages to print) (-fw from width) (-sw subject[0m
|
|
|
|
|
[1mwidth) mbox[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Print a summary of recent messages in an mbox format mailbox.
|
|
|
|
|
mbox parameter is the filename of the mailbox (can be encapsu‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
lated using '"', ie. ${mboxscan -n 10 "/home/brenden/some box"}
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmem [22mAmount of memory in use
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmembar (height),(width)[0m
|
|
|
|
|
Bar that shows amount of memory in use
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmemgauge (height),(width)[0m
|
|
|
|
|
Gauge that shows amount of memory in use (see cpugauge)
|
2009-03-18 05:26:56 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-10 02:18:19 +00:00
|
|
|
|
[1mmemgraph ("normal"|"log") (height),(width) (gradient colour 1) (gradi‐[0m
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1ment colour 2) (scale)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Memory usage graph. Uses a logarithmic scale (to see small num‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
bers) when you use "log" instead of "normal".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmemeasyfree[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Amount of free memory including the memory that is very easily
|
2009-04-09 21:20:10 +00:00
|
|
|
|
freed (buffers/cache)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmemfree[0m
|
|
|
|
|
Amount of free memory
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmemmax [22mTotal amount of memory
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmemperc[0m
|
|
|
|
|
Percentage of memory in use
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmixer (device)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Prints the mixer value as reported by the OS. Default mixer is
|
|
|
|
|
"vol", but you can specify one of the following optional argu‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
ments: "vol", "bass", "treble", "synth", "pcm", "speaker",
|
2009-04-10 02:18:19 +00:00
|
|
|
|
"line", "mic", "cd", "mix", "pcm2", "rec", "igain", "ogain",
|
2009-04-09 21:20:10 +00:00
|
|
|
|
"line1", "line2", "line3", "dig1", "dig2", "dig3", "phin",
|
|
|
|
|
"phout", "video", "radio", "monitor". Refer to the definition of
|
2009-04-10 02:18:19 +00:00
|
|
|
|
SOUND_DEVICE_NAMES in <linux/soundcard.h> (on Linux), <sound‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
card.h> (on OpenBSD), or <sys/soundcard.h> to find the exact op‐
|
|
|
|
|
tions available on your system.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmixerbar (device)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Displays mixer value in a bar as reported by the OS. See docs
|
2009-04-09 21:20:10 +00:00
|
|
|
|
for $mixer for details on arguments.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmixerr (device)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Prints the right channel mixer value as reported by the OS. See
|
2009-04-09 21:20:10 +00:00
|
|
|
|
docs for $mixer for details on arguments.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmixerrbar (device)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Displays the right channel mixer value in a bar as reported by
|
2009-04-09 21:20:10 +00:00
|
|
|
|
the OS. See docs for $mixer for details on arguments.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmixerl (device)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Prints the left channel mixer value as reported by the OS. See
|
2009-04-09 21:20:10 +00:00
|
|
|
|
docs for $mixer for details on arguments.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmixerlbar (device)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Displays the left channel mixer value in a bar as reported by
|
2009-04-09 21:20:10 +00:00
|
|
|
|
the OS. See docs for $mixer for details on arguments.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_state[0m
|
|
|
|
|
Current state of MOC; playing, stopped etc.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_file[0m
|
|
|
|
|
File name of the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_title[0m
|
|
|
|
|
Title of the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_artist[0m
|
|
|
|
|
Artist of the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_song[0m
|
|
|
|
|
The current song name being played in MOC.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_album[0m
|
|
|
|
|
Album of the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_totaltime[0m
|
|
|
|
|
Total length of the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_timeleft[0m
|
|
|
|
|
Time left in the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_curtime[0m
|
|
|
|
|
Current time of the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_bitrate[0m
|
|
|
|
|
Bitrate in the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmoc_rate[0m
|
|
|
|
|
Rate of the current MOC song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmonitor[0m
|
|
|
|
|
Number of the monitor on which conky is running
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmonitor_number[0m
|
|
|
|
|
Number of monitors
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_artist[0m
|
|
|
|
|
Artist in current MPD song must be enabled at compile
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_album[0m
|
|
|
|
|
Album in current MPD song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_bar (height),(width)[0m
|
|
|
|
|
Bar of mpd's progress
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_bitrate[0m
|
|
|
|
|
Bitrate of current song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_status[0m
|
|
|
|
|
Playing, stopped, et cetera.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_title (max length)[0m
|
|
|
|
|
Title of current MPD song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_vol[0m
|
|
|
|
|
MPD's volume
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_elapsed[0m
|
|
|
|
|
Song's elapsed time
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_length[0m
|
|
|
|
|
Song's length
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_percent[0m
|
|
|
|
|
Percent of song's progress
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_random[0m
|
|
|
|
|
Random status (On/Off)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_repeat[0m
|
|
|
|
|
Repeat status (On/Off)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_track[0m
|
|
|
|
|
Prints the MPD track field
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_name[0m
|
|
|
|
|
Prints the MPD name field
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_file[0m
|
|
|
|
|
Prints the file name of the current MPD song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mmpd_smart (max length)[0m
|
|
|
|
|
Prints the song name in either the form "artist - title" or file
|
|
|
|
|
name, depending on whats available
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_mpd_playing[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
if mpd is playing or paused, display everything between
|
2009-04-09 21:20:10 +00:00
|
|
|
|
$if_mpd_playing and the matching $endif
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mnameserver (index)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Print a nameserver from /etc/resolv.conf. Index starts at and
|
2009-04-09 21:20:10 +00:00
|
|
|
|
defaults to 0.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mnodename[0m
|
|
|
|
|
Hostname
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mnvidia threshold temp ambient gpufreq memfreq imagequality[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Nvidia graficcard support for the XNVCtrl library. Each option
|
|
|
|
|
can be shortened to the least significant part. Temperatures
|
2009-04-09 21:20:10 +00:00
|
|
|
|
are printed as float, all other values as integer.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mthreshold[22m: the thresholdtemperature at which the gpu slows down
|
|
|
|
|
[1mtemp[22m: gives the gpu current temperature
|
|
|
|
|
[1mambient[22m: gives current air temperature near GPU case
|
|
|
|
|
[1mgpufreq[22m: gives the current gpu frequency
|
|
|
|
|
[1mmemfreq[22m: gives the current mem frequency
|
|
|
|
|
[1mimagequality[22m: which imagequality should be choosen by OpenGL ap‐
|
|
|
|
|
plications
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1moutlinecolor (color)[0m
|
|
|
|
|
Change outline color
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mpb_battery item[0m
|
|
|
|
|
If running on Apple powerbook/ibook, display information on bat‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
tery status. The item parameter specifies, what information to
|
2009-04-09 21:20:10 +00:00
|
|
|
|
display. Exactly one item must be specified. Valid items are:
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mstatus[22m: Display if battery is fully charged, charging, discharg‐
|
|
|
|
|
ing or absent (running on AC)
|
2009-04-10 02:18:19 +00:00
|
|
|
|
[1mpercent[22m: Display charge of battery in percent, if charging or
|
|
|
|
|
discharging. Nothing will be displayed, if battery is fully
|
2009-04-09 21:20:10 +00:00
|
|
|
|
charged or absent.
|
|
|
|
|
[1mtime[22m: Display the time remaining until the battery will be fully
|
2009-04-10 02:18:19 +00:00
|
|
|
|
charged or discharged at current rate. Nothing is displayed, if
|
|
|
|
|
battery is absent or if it's present but fully charged and not
|
2009-04-09 21:20:10 +00:00
|
|
|
|
discharging.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mplatform (dev) type n[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Platform sensor from sysfs (Linux 2.6). Parameter dev may be
|
|
|
|
|
omitted if you have only one platform device. Platform type is
|
|
|
|
|
either 'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp'
|
|
|
|
|
meaning temperature. Parameter n is number of the sensor. See
|
2009-04-09 21:20:10 +00:00
|
|
|
|
/sys/bus/platform/devices/ on your local computer.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mpop3_unseen (args)[0m
|
|
|
|
|
Displays the number of unseen messages in your global POP3 inbox
|
|
|
|
|
by default. You can define individual POP3 inboxes seperately by
|
|
|
|
|
passing arguments to this object. Arguments are: "host user pass
|
|
|
|
|
[-i interval] [-p port] [-e command] [-r retries]". Default port
|
|
|
|
|
is 110, default interval is 5 minutes, and default number of re‐
|
|
|
|
|
tries before giving up is 5. If the password is supplied as '*',
|
|
|
|
|
you will be prompted to enter the password when Conky starts.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mpop3_used (args)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Displays the amount of space (in MiB, 2^20) used in your global
|
|
|
|
|
POP3 inbox by default. You can define individual POP3 inboxes
|
|
|
|
|
seperately by passing arguments to this object. Arguments are:
|
|
|
|
|
"host user pass [-i interval] [-p port] [-e command] [-r re‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
tries]". Default port is 110, default interval is 5 minutes, and
|
|
|
|
|
default number of retries before giving up is 5. If the password
|
2009-04-10 02:18:19 +00:00
|
|
|
|
is supplied as '*', you will be prompted to enter the password
|
2009-04-09 21:20:10 +00:00
|
|
|
|
when Conky starts.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mpre_exec shell command[0m
|
|
|
|
|
Executes a shell command one time before conky displays anything
|
|
|
|
|
and puts output as text.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mprocesses[0m
|
|
|
|
|
Total processes (sleeping and running)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mrunning_processes[0m
|
|
|
|
|
Running processes (not sleeping), requires Linux 2.6
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mscroll length (step) text[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Scroll 'text' by 'step' characters showing 'length' number of
|
|
|
|
|
characters at the same time. The text may also contain vari‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
ables. 'step' is optional and defaults to 1 if not set. If a var
|
2009-04-10 02:18:19 +00:00
|
|
|
|
creates output on multiple lines then the lines are placed be‐
|
|
|
|
|
hind each other separated with a '|'-sign. Do NOT use vars that
|
|
|
|
|
change colors or otherwise affect the design inside a scrolling
|
|
|
|
|
text. If you want spaces between the start and the end of
|
|
|
|
|
'text', place them at the end of 'text' not at the front ("foo‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
bar" and " foobar" can both generate "barfoo" but "foobar " will
|
|
|
|
|
keep the spaces like this "bar foo").
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mshadecolor (color)[0m
|
|
|
|
|
Change shading color
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1msmapi (ARGS)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
when using smapi, display contents of the /sys/devices/plat‐
|
|
|
|
|
form/smapi directory. ARGS are either '(FILENAME)' or 'bat (IN‐
|
|
|
|
|
DEX) (FILENAME)' to display the corresponding files' content.
|
|
|
|
|
This is a very raw method of accessing the smapi values. When
|
2009-04-09 21:20:10 +00:00
|
|
|
|
available, better use one of the smapi_* variables instead.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1msmapi_bat_bar (INDEX),(height),(width)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
when using smapi, display the remaining capacity of the battery
|
2009-04-09 21:20:10 +00:00
|
|
|
|
with index INDEX as a bar.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1msmapi_bat_perc (INDEX)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
when using smapi, display the remaining capacity in percent of
|
|
|
|
|
the battery with index INDEX. This is a separate variable be‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
cause it supports the 'use_spacer' configuration option.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1msmapi_bat_power INDEX[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
when using smapi, display the current power of the battery with
|
|
|
|
|
index INDEX in watt. This is a separate variable because the
|
|
|
|
|
original read out value is being converted from mW. The sign of
|
|
|
|
|
the output reflects charging (positive) or discharging (nega‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
tive) state.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1msmapi_bat_temp INDEX[0m
|
|
|
|
|
when using smapi, display the current temperature of the battery
|
2009-04-10 02:18:19 +00:00
|
|
|
|
with index INDEX in degree Celsius. This is a separate variable
|
2009-04-09 21:20:10 +00:00
|
|
|
|
because the original read out value is being converted from mil‐
|
|
|
|
|
li degree Celsius.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mstippled_hr (space)[0m
|
|
|
|
|
Stippled (dashed) horizontal line
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mswapbar (height),(width)[0m
|
|
|
|
|
Bar that shows amount of swap in use
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mswap [22mAmount of swap in use
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mswapmax[0m
|
|
|
|
|
Total amount of swap
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mswapperc[0m
|
|
|
|
|
Percentage of swap in use
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1msysname[0m
|
|
|
|
|
System name, Linux for example
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtcp_portmon port_begin port_end item (index) [4m[22m(ip4[24m [4monly[24m [4mat[24m [4mpresent)[0m
|
|
|
|
|
TCP port monitor for specified local ports. Port numbers must be
|
|
|
|
|
in the range 1 to 65535. Valid items are:
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mcount [22m- total number of connections in the range
|
|
|
|
|
[1mrip [22m- remote ip address
|
|
|
|
|
[1mrhost [22m- remote host name
|
|
|
|
|
[1mrport [22m- remote port number
|
|
|
|
|
[1mrservice [22m- remote service name from /etc/services
|
|
|
|
|
[1mlip [22m- local ip address
|
|
|
|
|
[1mlhost [22m- local host name
|
|
|
|
|
[1mlport [22m- local port number
|
|
|
|
|
[1mlservice [22m- local service name from /etc/services
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
The connection index provides you with access to each connection
|
|
|
|
|
in the port monitor. The monitor will return information for in‐
|
|
|
|
|
dex values from 0 to n-1 connections. Values higher than n-1 are
|
2009-04-10 02:18:19 +00:00
|
|
|
|
simply ignored. For the "count" item, the connection index must
|
2009-04-09 21:20:10 +00:00
|
|
|
|
be omitted. It is required for all other items.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Examples:
|
2009-04-10 02:18:19 +00:00
|
|
|
|
[1m${tcp_portmon 6881 6999 count} [22m- displays the number of connec‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
tions in the bittorrent port range
|
2009-04-10 02:18:19 +00:00
|
|
|
|
[1m${tcp_portmon 22 22 rip 0} [22m- displays the remote host ip of the
|
2009-04-09 21:20:10 +00:00
|
|
|
|
first sshd connection
|
2009-04-10 02:18:19 +00:00
|
|
|
|
[1m${tcp_portmon 22 22 rip 9} [22m- displays the remote host ip of the
|
2009-04-09 21:20:10 +00:00
|
|
|
|
tenth sshd connection
|
|
|
|
|
[1m${tcp_portmon 1 1024 rhost 0} [22m- displays the remote host name of
|
|
|
|
|
the first connection on a privileged port
|
|
|
|
|
[1m${tcp_portmon 1 1024 rport 4} [22m- displays the remote host port of
|
|
|
|
|
the fifth connection on a privileged port
|
2009-04-10 02:18:19 +00:00
|
|
|
|
[1m${tcp_portmon 1 65535 lservice 14} [22m- displays the local service
|
2009-04-09 21:20:10 +00:00
|
|
|
|
name of the fifteenth connection in the range of all ports
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Note that port monitor variables which share the same port range
|
|
|
|
|
actually refer to the same monitor, so many references to a sin‐
|
|
|
|
|
gle port range for different items and different indexes all use
|
2009-04-10 02:18:19 +00:00
|
|
|
|
the same monitor internally. In other words, the program avoids
|
2009-04-09 21:20:10 +00:00
|
|
|
|
creating redundant monitors.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtexeci interval command[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Runs a command at an interval inside a thread and displays the
|
|
|
|
|
output. Same as $execi, except the command is run inside a
|
|
|
|
|
thread. Use this if you have a slow script to keep Conky updat‐
|
|
|
|
|
ing. You should make the interval slightly longer then the time
|
|
|
|
|
it takes your script to execute. For example, if you have a
|
|
|
|
|
script that take 5 seconds to execute, you should make the in‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
terval at least 6 seconds. See also $execi.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1moffset (pixels)[0m
|
|
|
|
|
Move text over by N pixels. See also $voffset.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mrss url delay_in_minutes action item_num[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Download and parse RSS feeds. Action may be one of the follow‐
|
|
|
|
|
ing: feed_title, item_title (with num par), item_desc (with num
|
2009-04-09 21:20:10 +00:00
|
|
|
|
par) and item_titles.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtab (width, (start))[0m
|
|
|
|
|
Puts a tab of the specified width, starting from column 'start'.
|
2009-04-10 02:10:08 +00:00
|
|
|
|
The unit is pixels for both arguments.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtail logfile lines (interval)[0m
|
|
|
|
|
Displays last N lines of supplied text text file. If interval is
|
|
|
|
|
not supplied, Conky assumes 2x Conky's interval. Max of 30 lines
|
|
|
|
|
can be displayed, or until the text buffer is filled.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtemplateN (arg1) (arg2) (arg3 ...)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Evaluate the content of the templateN configuration variable
|
2009-04-09 21:20:10 +00:00
|
|
|
|
(where N is a value between 0 and 9, inclusively), applying sub‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
stitutions as described in the documentation of the correspond‐
|
|
|
|
|
ing configuration variable. The number of arguments is option‐
|
|
|
|
|
al, but must match the highest referred index in the template.
|
|
|
|
|
You can use the same special sequences in each argument as the
|
|
|
|
|
ones valid for a template definition, e.g. to allow an argument
|
|
|
|
|
to contain a whitespace. Also simple nesting of templates is
|
2009-04-09 21:20:10 +00:00
|
|
|
|
possible this way.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
Here are some examples of template definitions:
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
template0 $\1\2
|
|
|
|
|
template1 \1: ${fs_used \2} / ${fs_size \2}
|
|
|
|
|
template2 \1 \2
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-10 02:18:19 +00:00
|
|
|
|
The following list shows sample usage of the templates defined
|
2009-04-09 21:20:10 +00:00
|
|
|
|
above, with the equivalent syntax when not using any template at
|
|
|
|
|
all:
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
using template same without template
|
|
|
|
|
─────────────────────────────────────────────────────────────────────────────────
|
|
|
|
|
${template0 node name} $nodename
|
|
|
|
|
${template1 root /} root: ${fs_free /} /
|
|
|
|
|
${fs_size /}
|
|
|
|
|
${template1 ${template2\ disk\ root} /} disk root: ${fs_free /} / ${fs_size /}
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtime (format)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Local time, see man strftime to get more information about for‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
mat
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mutime (format)[0m
|
|
|
|
|
Display time in UTC (universal coordinate time).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtztime (timezone) (format)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Local time for specified timezone, see man strftime to get more
|
|
|
|
|
information about format. The timezone argument is specified in
|
|
|
|
|
similar fashion as TZ environment variable. For hints, look in
|
2009-04-09 21:20:10 +00:00
|
|
|
|
/usr/share/zoneinfo. e.g. US/Pacific, Europe/Zurich, etc.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtotaldown net[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Total download, overflows at 4 GB on Linux with 32-bit arch and
|
2009-04-09 21:20:10 +00:00
|
|
|
|
there doesn't seem to be a way to know how many times it has al‐
|
|
|
|
|
ready done that before conky has started.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtop type, num[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
This takes arguments in the form:top (name) (number) Basically,
|
|
|
|
|
processes are ranked from highest to lowest in terms of cpu us‐
|
|
|
|
|
age, which is what (num) represents. The types are: "name",
|
|
|
|
|
"pid", "cpu", "mem", "mem_res", "mem_vsize", and "time". There
|
2009-04-09 21:20:10 +00:00
|
|
|
|
can be a max of 10 processes listed.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtop_mem type, num[0m
|
|
|
|
|
Same as top, except sorted by mem usage instead of cpu
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtop_time type, num[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Same as top, except sorted by total CPU time instead of current
|
2009-04-09 21:20:10 +00:00
|
|
|
|
CPU usage
|
2009-02-07 16:44:19 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mtotalup net[0m
|
|
|
|
|
Total upload, this one too, may overflow
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mupdates Number of updates[0m
|
|
|
|
|
for debugging
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mupspeed net[0m
|
|
|
|
|
Upload speed in KiB
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mupspeedf net[0m
|
|
|
|
|
Upload speed in KiB with one decimal
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mupspeedgraph ("normal"|"log") (height),(width) (gradient colour 1)[0m
|
|
|
|
|
[1m(gradient colour 2) (scale) (net)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Upload speed graph, colours defined in hex, minus the #. If
|
|
|
|
|
scale is non-zero, it becomes the scale for the graph. Uses a
|
|
|
|
|
logarithmic scale (to see small numbers) when you use "log" in‐
|
2009-04-09 21:20:10 +00:00
|
|
|
|
stead of "normal".
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muptime [22mUptime
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muptime_short[0m
|
|
|
|
|
Uptime in a shorter format
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muser_number[0m
|
|
|
|
|
Number of users logged in
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muser_names[0m
|
|
|
|
|
Lists the names of the users logged in
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muser_terms[0m
|
|
|
|
|
Lists the consoles in use
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1muser_times[0m
|
|
|
|
|
Lists how long users have been logged in for
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mvoffset (pixels)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Change vertical offset by N pixels. Negative values will cause
|
2009-04-09 21:20:10 +00:00
|
|
|
|
text to overlap. See also $offset.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mvoltage_mv (n)[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Returns CPU #n's voltage in mV. CPUs are counted from 1. If
|
2009-04-09 21:20:10 +00:00
|
|
|
|
omitted, the parameter defaults to 1.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mvoltage_v (n)[0m
|
|
|
|
|
Returns CPU #n's voltage in V. CPUs are counted from 1. If omit‐
|
|
|
|
|
ted, the parameter defaults to 1.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwireless_essid net[0m
|
|
|
|
|
Wireless access point ESSID (Linux only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwireless_mode net[0m
|
|
|
|
|
Wireless mode (Managed/Ad-Hoc/Master) (Linux only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwireless_bitrate net[0m
|
|
|
|
|
Wireless bitrate (ie 11 Mb/s) (Linux only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwireless_ap net[0m
|
|
|
|
|
Wireless access point MAC address (Linux only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwireless_link_qual net[0m
|
|
|
|
|
Wireless link quality (Linux only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwireless_link_qual_max net[0m
|
|
|
|
|
Wireless link quality maximum value (Linux only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwireless_link_qual_perc net[0m
|
|
|
|
|
Wireless link quality in percents (Linux only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwireless_link_bar (height), (width) net[0m
|
|
|
|
|
Wireless link quality bar (Linux only)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mwords textfile[0m
|
|
|
|
|
Displays the number of words in the given file
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_artist[0m
|
|
|
|
|
Artist in current XMMS2 song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_album[0m
|
|
|
|
|
Album in current XMMS2 song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_title[0m
|
|
|
|
|
Title in current XMMS2 song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_genre[0m
|
|
|
|
|
Genre in current XMMS2 song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_comment[0m
|
|
|
|
|
Comment in current XMMS2 song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_decoder[0m
|
|
|
|
|
Decoder plugin used
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_transport[0m
|
|
|
|
|
Transport plugin used
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_url[0m
|
|
|
|
|
Full path to current song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_tracknr[0m
|
|
|
|
|
Track number in current XMMS2 song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_bitrate[0m
|
|
|
|
|
Bitrate of current song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_id[0m
|
|
|
|
|
XMMS2 id of current song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_duration[0m
|
|
|
|
|
Duration of current song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_elapsed[0m
|
|
|
|
|
Song's elapsed time
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_size[0m
|
|
|
|
|
Size of current song
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_percent[0m
|
|
|
|
|
Percent of song's progress
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_status[0m
|
|
|
|
|
XMMS2 status (Playing, Paused, Stopped, or Disconnected)
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_bar (height),(width)[0m
|
|
|
|
|
Bar of XMMS2's progress
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mxmms2_smart[0m
|
|
|
|
|
Prints the song name in either the form "artist - title" or file
|
|
|
|
|
name, depending on whats available
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mif_xmms2_connected[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Display everything between $if_xmms2_connected and the matching
|
2009-04-09 21:20:10 +00:00
|
|
|
|
$endif if xmms2 is running.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1meve api_userid api_key character_id[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Fetches your currently training skill from the Eve Online API
|
2009-04-09 21:20:10 +00:00
|
|
|
|
servers (http://www.eve-online.com/) and displays the skill
|
|
|
|
|
along with the remaining training time.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mEXAMPLES[0m
|
|
|
|
|
conky [1m-t '${time %D %H:%M}' -o -u 30[0m
|
|
|
|
|
Start Conky in its own window with date and clock as text and 30
|
|
|
|
|
sec update interval.
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
conky [1m-a top_left -x 5 -y 500 -d[0m
|
|
|
|
|
Start Conky to background at coordinates (5, 500).
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mFILES[0m
|
|
|
|
|
[4m~/.conkyrc[24m default configuration file
|
2008-12-09 04:26:12 +00:00
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mBUGS[0m
|
|
|
|
|
Drawing to root or some other desktop window directly doesn't work with
|
|
|
|
|
all window managers. Especially doesn't work well with Gnome and it has
|
2009-04-10 02:18:19 +00:00
|
|
|
|
been reported that it doesn't work with KDE either. Nautilus can be
|
|
|
|
|
disabled from drawing to desktop with program gconf-editor. Uncheck
|
|
|
|
|
show_desktop in /apps/nautilus/preferences/. There is -w switch in
|
|
|
|
|
Conky to set some specific window id. You might find xwininfo -tree
|
|
|
|
|
useful to find the window to draw to. You can also use -o argument
|
2008-12-09 04:26:12 +00:00
|
|
|
|
which makes Conky to create its own window. If you do try running Conky
|
2009-04-10 02:18:19 +00:00
|
|
|
|
in its own window, be sure to read up on the own_window_type settings
|
2008-12-09 04:26:12 +00:00
|
|
|
|
and experiment.
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mSEE ALSO[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
⟨http://conky.sourceforge.net/⟩
|
|
|
|
|
|
|
|
|
|
⟨http://www.sourceforge.net/projects/conky⟩
|
|
|
|
|
|
|
|
|
|
#conky on irc.freenode.net
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mCOPYING[0m
|
2009-04-10 02:18:19 +00:00
|
|
|
|
Copyright (c) 2005-2009 Brenden Matthews, Philip Kovacs, et. al. Any
|
2008-12-09 04:26:12 +00:00
|
|
|
|
original torsmo code is licensed under the BSD license (see LICENSE.BSD
|
|
|
|
|
for a copy). All code written since the fork of torsmo is licensed un‐
|
|
|
|
|
der the GPL (see LICENSE.GPL for a copy), except where noted different‐
|
2009-04-10 02:18:19 +00:00
|
|
|
|
ly (such as in portmon code, timed thread code, and audacious code
|
2008-12-09 04:26:12 +00:00
|
|
|
|
which are LGPL, and prss which is an MIT-style license).
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
[1mAUTHORS[0m
|
2008-12-09 04:26:12 +00:00
|
|
|
|
The Conky dev team (see AUTHORS for a full list of contributors).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2009-04-09 21:20:10 +00:00
|
|
|
|
2009-03-15 conky(1)
|