2005-08-21 22:18:14 +00:00
|
|
|
conky(1) conky(1)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
2005-08-27 21:29:49 +00:00
|
|
|
conky - A system monitor for X originally based on the torsmo code, but
|
2006-01-12 01:22:14 +00:00
|
|
|
more kickass. It just keeps on given'er. Yeah.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
conky [options]
|
|
|
|
|
|
|
|
DESCRIPTION
|
2008-04-01 21:37:49 +00:00
|
|
|
Conky is a system monitor for X originally based on torsmo. Since its
|
|
|
|
inception, Conky has changed significantly from its predecessor, while
|
|
|
|
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
|
|
|
|
about any piece of information by using scripts and other external pro-
|
|
|
|
grams.
|
|
|
|
|
|
|
|
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),
|
|
|
|
built in IMAP and POP3 support, built in support for many popular music
|
|
|
|
players (MPD, XMMS2, BMPx, Audacious), and much much more. Conky can
|
|
|
|
display this info either as text, or using simple progress bars and
|
|
|
|
graph widgets, with different fonts and colours.
|
|
|
|
|
|
|
|
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
|
|
|
|
#conky on irc.freenode.net if you have questions or want to contribute.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
Thanks for your interest in Conky.
|
|
|
|
|
|
|
|
COMPILING
|
2008-04-01 21:37:49 +00:00
|
|
|
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-03-31 04:56:39 +00:00
|
|
|
options).
|
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
Conky has (for some time) been available in the repositories of most
|
|
|
|
popular distributions. Here are some installation instructions for a
|
2008-03-31 04:56:39 +00:00
|
|
|
few:
|
2005-08-30 02:45:09 +00:00
|
|
|
|
2006-01-12 01:22:14 +00:00
|
|
|
Gentoo users -- Conky is in Gentoo's Portage... simply use "emerge app-
|
2008-04-01 21:37:49 +00:00
|
|
|
admin/conky" for installation. There is also usually an up-to-date
|
2008-03-31 04:56:39 +00:00
|
|
|
ebuild within Conky's package or in SVN.
|
2005-08-30 02:45:09 +00:00
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
Debian, etc. users -- Conky should be in your repositories, and can be
|
2008-03-31 04:56:39 +00:00
|
|
|
installed by doing "aptitude install conky".
|
2005-08-22 00:24:24 +00:00
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
Example to compile and run Conky with all optional components (note
|
2005-11-02 05:27:31 +00:00
|
|
|
that some configure options may differ for your system):
|
2005-08-22 00:24:24 +00:00
|
|
|
|
2008-03-18 00:23:16 +00:00
|
|
|
sh autogen.sh # Only required if building from SVN
|
2005-08-21 22:18:14 +00:00
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
./configure --prefix=/usr --mandir=/usr/share/man --in-
|
|
|
|
fodir=/usr/share/info --datadir=/usr/share --sysconfdir=/etc --local-
|
2007-11-17 04:13:20 +00:00
|
|
|
statedir=/var/lib --disable-own-window --enable-audacious[=yes|no|lega-
|
|
|
|
cy] --enable-bmpx --disable-hddtemp --disable-mpd --enable-xmms2 --dis-
|
2008-04-01 21:37:49 +00:00
|
|
|
able-portmon --disable-network --enable-debug --disable-x11 --dis-
|
2007-11-17 04:13:20 +00:00
|
|
|
able-double-buffer --disable-xdamage --disable-xft
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
make
|
|
|
|
|
2005-08-22 17:19:00 +00:00
|
|
|
make install # Optional
|
|
|
|
|
2005-08-30 02:45:09 +00:00
|
|
|
src/conky
|
2005-08-21 22:18:14 +00:00
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
Conky has been tested to be compatible with C99 C, however it has not
|
2008-03-31 04:56:39 +00:00
|
|
|
been tested with anything other than gcc, and is not guaranteed to work
|
|
|
|
with other compilers.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
YOU SHOULD KNOW
|
2008-04-01 21:37:49 +00:00
|
|
|
Conky is generally very good on resources. That said, the more you try
|
2008-03-31 04:56:39 +00:00
|
|
|
to make Conky do, the more resources it is going to consume.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
2005-08-30 02:45:09 +00:00
|
|
|
An easy way to force Conky to reload your ~/.conkyrc: "killall -SIGUSR1
|
2008-04-01 21:37:49 +00:00
|
|
|
conky". Saves you the trouble of having to kill and then restart. You
|
2008-03-18 00:23:16 +00:00
|
|
|
can now also do the same with SIGHUP.
|
2005-08-29 16:52:54 +00:00
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
OPTIONS
|
2008-04-01 21:37:49 +00:00
|
|
|
Command line options override configurations defined in configuration
|
2005-08-21 22:18:14 +00:00
|
|
|
file.
|
|
|
|
|
2008-04-01 04:59:00 +00:00
|
|
|
-v | -V | --version
|
2005-08-30 02:45:09 +00:00
|
|
|
Prints version and exits
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-06-03 21:01:40 +00:00
|
|
|
-q | --quiet
|
|
|
|
Run Conky in 'quiet mode' (ie. no output)
|
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-a | --alignment=ALIGNMENT
|
2008-04-01 21:37:49 +00:00
|
|
|
Text alignment on screen, {top,bottom,middle}_{left,right,mid-
|
2008-04-01 04:59:00 +00:00
|
|
|
dle} or none
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-b | --double-buffer
|
|
|
|
Use double buffering (eliminates "flicker")
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-c | --config=FILE
|
2005-08-21 22:18:14 +00:00
|
|
|
Config file to load instead of $HOME/.conkyrc
|
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-d | --daemonize
|
|
|
|
Daemonize Conky, aka fork to background
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-f | --font=FONT
|
2005-08-21 22:18:14 +00:00
|
|
|
Font to use
|
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-h | --help
|
|
|
|
Prints command line help and exits
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-o | --own-window
|
|
|
|
Create own window to draw
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-t | --text=TEXT
|
2006-01-12 01:22:14 +00:00
|
|
|
Text to render, remember single quotes, like -t ' $uptime '
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-u | --interval=SECONDS
|
2005-08-21 22:18:14 +00:00
|
|
|
Update interval
|
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
-w | --window-id=WIN_ID
|
2005-08-21 22:18:14 +00:00
|
|
|
Window id to draw
|
|
|
|
|
|
|
|
|
|
|
|
-x X_COORDINATE
|
|
|
|
X position
|
|
|
|
|
|
|
|
|
|
|
|
-y Y_COORDINATE
|
|
|
|
Y position
|
|
|
|
|
|
|
|
|
2008-04-01 04:59:00 +00:00
|
|
|
-i COUNT
|
|
|
|
Number of times to update Conky (and quit)
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
CONFIGURATION SETTINGS
|
2008-04-01 21:37:49 +00:00
|
|
|
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).
|
2005-08-30 02:45:09 +00:00
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
You might want to copy it to $HOME/.conkyrc and then start modifying
|
2008-03-31 04:56:39 +00:00
|
|
|
it. Other configs can be found at http://conky.sf.net/
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
alignment
|
2008-03-18 00:23:16 +00:00
|
|
|
Aligned position on screen, may be top_left, top_right, top_mid-
|
|
|
|
dle, bottom_left, bottom_right, bottom_middle, middle_left, mid-
|
2008-04-01 21:37:49 +00:00
|
|
|
dle_right, or none (also can be abreviated as tl, tr, tm, bl,
|
2008-03-18 00:23:16 +00:00
|
|
|
br, bm, ml, mr)
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
background
|
2008-04-01 21:37:49 +00:00
|
|
|
Boolean value, if true, Conky will be forked to background when
|
2005-08-21 22:18:14 +00:00
|
|
|
started
|
|
|
|
|
|
|
|
|
|
|
|
border_margin
|
|
|
|
Border margin in pixels
|
|
|
|
|
|
|
|
|
|
|
|
border_width
|
|
|
|
Border width in pixels
|
|
|
|
|
|
|
|
|
2008-06-03 20:46:15 +00:00
|
|
|
colorN Predefine 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 (#).
|
2007-04-25 17:22:06 +00:00
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
cpu_avg_samples
|
|
|
|
The number of samples to average for CPU monitoring
|
|
|
|
|
|
|
|
|
2008-01-06 01:36:08 +00:00
|
|
|
top_cpu_separate
|
|
|
|
If true, cpu in top will show usage of one processor's power. If
|
2008-04-01 21:37:49 +00:00
|
|
|
false, cpu in top will show the usage of all processors' power
|
2008-01-06 01:36:08 +00:00
|
|
|
combined.
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
default_color
|
|
|
|
Default color and border color
|
|
|
|
|
|
|
|
|
|
|
|
default_outline_color
|
|
|
|
Default outline color
|
|
|
|
|
|
|
|
|
2006-11-12 21:19:40 +00:00
|
|
|
default_shade_color
|
|
|
|
Default shading color and border's shading color
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
double_buffer
|
2006-01-12 01:22:14 +00:00
|
|
|
Use the Xdbe extension? (eliminates flicker) It is highly recom-
|
|
|
|
mended to use own window with this one so double buffer won't be
|
2005-08-21 22:18:14 +00:00
|
|
|
so big.
|
|
|
|
|
|
|
|
|
|
|
|
draw_borders
|
|
|
|
Draw borders around text?
|
|
|
|
|
|
|
|
|
2006-01-05 23:23:51 +00:00
|
|
|
draw_graph_borders
|
|
|
|
Draw borders around graphs?
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
draw_outline
|
|
|
|
Draw outlines?
|
|
|
|
|
|
|
|
|
2006-11-12 21:19:40 +00:00
|
|
|
draw_shades
|
|
|
|
Draw shades?
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
font Font name in X, xfontsel can be used to get a nice font
|
|
|
|
|
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
gap_x Gap, in pixels, between right or left border of screen, same as
|
2006-11-21 21:13:49 +00:00
|
|
|
passing -x at command line, e.g. gap_x 10
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
gap_y Gap, in pixels, between top or bottom border of screen, same as
|
2006-11-21 21:13:49 +00:00
|
|
|
passing -y at command line, e.g. gap_y 10.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-06-03 20:46:15 +00:00
|
|
|
if_up_strictness
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
imap Default global IMAP server. Arguments are: "host user pass [-i
|
|
|
|
interval] [-f folder] [-p port] [-e command]". Default port is
|
|
|
|
143, default folder is 'INBOX', default interval is 5 minutes.
|
|
|
|
If the password is supplied as '*', you will be prompted to en-
|
2006-08-10 16:56:13 +00:00
|
|
|
ter the password when Conky starts.
|
2006-05-08 22:34:38 +00:00
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
mail_spool
|
|
|
|
Mail spool for mail checking
|
|
|
|
|
|
|
|
|
2006-12-09 05:40:08 +00:00
|
|
|
max_port_monitor_connections
|
2008-06-03 20:46:15 +00:00
|
|
|
Allow each port monitor to track at most this many connections
|
2006-12-09 05:40:08 +00:00
|
|
|
(if 0 or not set, default is 256)
|
|
|
|
|
|
|
|
|
2006-11-22 21:53:54 +00:00
|
|
|
max_specials
|
2008-06-03 20:46:15 +00:00
|
|
|
Maximum number of special things, e.g. fonts, offsets, aligns,
|
2006-11-22 21:53:54 +00:00
|
|
|
etc. (default is 512)
|
|
|
|
|
|
|
|
|
2006-11-11 05:03:40 +00:00
|
|
|
max_user_text bytes
|
|
|
|
Maximum size of user text buffer, i.e. layout below TEXT line in
|
2006-11-12 21:19:40 +00:00
|
|
|
config file (default is 16384 bytes)
|
2006-11-11 05:03:40 +00:00
|
|
|
|
|
|
|
|
2008-03-20 21:29:32 +00:00
|
|
|
text_buffer_size bytes
|
2008-06-03 20:46:15 +00:00
|
|
|
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
|
2008-04-01 21:37:49 +00:00
|
|
|
256 bytes.
|
2007-02-14 19:45:18 +00:00
|
|
|
|
|
|
|
|
2005-08-24 06:21:50 +00:00
|
|
|
maximum_width pixels
|
|
|
|
Maximum width of window
|
|
|
|
|
|
|
|
|
|
|
|
minimum_size width (height)
|
2005-08-21 22:18:14 +00:00
|
|
|
Minimum size of window
|
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
monitor
|
|
|
|
Number of the monitor on which conky is running
|
|
|
|
|
|
|
|
|
|
|
|
monitor_number
|
|
|
|
Number of monitors
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
mpd_host
|
|
|
|
Host of MPD server
|
|
|
|
|
|
|
|
|
2005-08-27 21:04:37 +00:00
|
|
|
mpd_port
|
2005-08-21 22:18:14 +00:00
|
|
|
Port of MPD server
|
|
|
|
|
|
|
|
|
|
|
|
mpd_password
|
|
|
|
MPD server password
|
|
|
|
|
|
|
|
|
2007-09-02 04:27:46 +00:00
|
|
|
music_player_interval
|
2008-06-03 20:46:15 +00:00
|
|
|
Music player thread update interval (defaults to Conky's update
|
2007-09-02 04:27:46 +00:00
|
|
|
interval)
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
net_avg_samples
|
|
|
|
The number of samples to average for net data
|
|
|
|
|
|
|
|
|
2006-11-12 21:19:40 +00:00
|
|
|
no_buffers
|
|
|
|
Substract (file system) buffers from used memory?
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
override_utf8_locale
|
|
|
|
Force UTF8? requires XFT
|
|
|
|
|
|
|
|
|
|
|
|
own_window
|
|
|
|
Boolean, create own window to draw?
|
|
|
|
|
|
|
|
|
2006-12-23 06:01:16 +00:00
|
|
|
own_window_class
|
|
|
|
Manually set the WM_CLASS name. Defaults to "Conky".
|
2006-03-08 22:17:27 +00:00
|
|
|
|
|
|
|
|
2005-08-25 09:24:26 +00:00
|
|
|
own_window_colour colour
|
2008-06-03 20:46:15 +00:00
|
|
|
If own_window_transparent no, set a specified background colour
|
|
|
|
(defaults to black). Takes either a hex value (#ffffff) or a
|
2005-08-25 09:24:26 +00:00
|
|
|
valid RGB name (see /usr/lib/X11/rgb.txt)
|
|
|
|
|
|
|
|
|
2006-03-06 23:35:41 +00:00
|
|
|
own_window_hints undecorated,below,above,sticky,skip_taskbar,skip_pager
|
2008-06-03 20:46:15 +00:00
|
|
|
If own_window is yes, you may use these window manager hints to
|
2006-05-08 22:34:38 +00:00
|
|
|
affect the way Conky displays. Notes: Use own_window_type desk-
|
2008-06-03 20:46:15 +00:00
|
|
|
top as another way to implement many of these hints implicitly.
|
|
|
|
If you use own_window_type override, window manager hints have
|
2006-03-09 19:03:20 +00:00
|
|
|
no meaning and are ignored.
|
2006-03-06 23:35:41 +00:00
|
|
|
|
|
|
|
|
2006-12-23 06:01:16 +00:00
|
|
|
own_window_title
|
2008-06-03 20:46:15 +00:00
|
|
|
Manually set the window name. Defaults to "<hostname> - conky".
|
2006-12-23 06:01:16 +00:00
|
|
|
|
|
|
|
|
|
|
|
own_window_transparent
|
|
|
|
Boolean, set pseudo-transparency?
|
|
|
|
|
|
|
|
|
|
|
|
own_window_type
|
2008-04-29 21:31:04 +00:00
|
|
|
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
|
2008-06-03 20:46:15 +00:00
|
|
|
desktop; do not appear in your pager or taskbar; and are sticky
|
|
|
|
across all workspaces. Override windows are not under the con-
|
2006-12-23 06:01:16 +00:00
|
|
|
trol of the window manager. Hints are ignored. This type of win-
|
|
|
|
dow can be useful for certain situations.
|
|
|
|
|
|
|
|
|
2005-11-24 15:36:46 +00:00
|
|
|
out_to_console
|
|
|
|
Print text to stdout.
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
pad_percents
|
|
|
|
Pad percentages to this many decimals (0 = no padding)
|
|
|
|
|
|
|
|
|
2008-06-03 20:46:15 +00:00
|
|
|
pop3 Default global POP3 server. Arguments are: "host user pass [-i
|
|
|
|
interval] [-p port] [-e command]". Default port is 110, default
|
|
|
|
interval is 5 minutes. If the password is supplied as '*', you
|
2006-05-08 22:34:38 +00:00
|
|
|
will be prompted to enter the password when Conky starts.
|
|
|
|
|
|
|
|
|
2008-02-09 02:21:06 +00:00
|
|
|
short_units
|
|
|
|
Shortens units to a single character (kiB->k, GiB->G, etc.). De-
|
|
|
|
fault is off.
|
|
|
|
|
|
|
|
|
2008-04-13 04:10:35 +00:00
|
|
|
show_graph_scale
|
|
|
|
Shows the maximum value in scaled graphs.
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
stippled_borders
|
|
|
|
Border stippling (dashing) in pixels
|
|
|
|
|
|
|
|
|
|
|
|
total_run_times
|
2008-06-03 20:46:15 +00:00
|
|
|
Total number of times for Conky to update before quitting. Zero
|
2005-08-21 22:18:14 +00:00
|
|
|
makes Conky run forever
|
|
|
|
|
|
|
|
|
|
|
|
update_interval
|
|
|
|
Update interval in seconds
|
|
|
|
|
|
|
|
|
|
|
|
uppercase
|
|
|
|
Boolean value, if true, text is rendered in upper case
|
|
|
|
|
|
|
|
|
|
|
|
use_spacer
|
2008-02-09 02:21:06 +00:00
|
|
|
Adds spaces around certain objects to stop them from moving oth-
|
|
|
|
er things around. Arguments are left, right, and none (default).
|
2008-06-03 20:46:15 +00:00
|
|
|
The old true/false values are deprecated and default to
|
|
|
|
right/none respectively. Note that this only helps if you are
|
2008-02-09 02:21:06 +00:00
|
|
|
using a mono font, such as Bitstream Vera Sans Mono.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
use_xft
|
|
|
|
Use Xft (anti-aliased font and stuff)
|
|
|
|
|
|
|
|
|
2006-04-15 18:00:39 +00:00
|
|
|
xftalpha
|
|
|
|
Alpha of Xft font. Must be a value at or between 1 and 0.
|
|
|
|
|
|
|
|
|
|
|
|
xftfont
|
|
|
|
Xft font to use.
|
|
|
|
|
|
|
|
|
2005-08-30 02:45:09 +00:00
|
|
|
TEXT After this begins text to be formatted on screen
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
VARIABLES
|
2008-06-03 20:46:15 +00:00
|
|
|
Colors are parsed using XParsecolor(), there might be a list of them:
|
|
|
|
/usr/share/X11/rgb.txt. Also, <http://sedition.com/perl/rgb.html>.
|
2008-03-31 04:56:39 +00:00
|
|
|
Color can be also in #rrggbb format (hex).
|
2005-08-21 22:18:14 +00:00
|
|
|
|
2005-08-29 16:52:54 +00:00
|
|
|
addr interface
|
2005-08-21 22:18:14 +00:00
|
|
|
IP address for an interface
|
|
|
|
|
|
|
|
|
2008-03-18 00:23:16 +00:00
|
|
|
addrs interface
|
2008-06-03 20:46:15 +00:00
|
|
|
IP addresses for an interface (if one - works like addr). Linux
|
2008-03-18 00:23:16 +00:00
|
|
|
only.
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
acpiacadapter
|
|
|
|
ACPI ac adapter state.
|
|
|
|
|
|
|
|
|
|
|
|
acpifan
|
|
|
|
ACPI fan state
|
|
|
|
|
|
|
|
|
|
|
|
acpitemp
|
2005-08-22 00:24:24 +00:00
|
|
|
ACPI temperature in C.
|
|
|
|
|
|
|
|
|
|
|
|
acpitempf
|
|
|
|
ACPI temperature in F.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
adt746xcpu
|
|
|
|
CPU temperature from therm_adt746x
|
|
|
|
|
|
|
|
|
|
|
|
adt746xfan
|
|
|
|
Fan speed from therm_adt746x
|
|
|
|
|
|
|
|
|
|
|
|
alignr (num)
|
|
|
|
Right-justify text, with space of N
|
|
|
|
|
|
|
|
|
|
|
|
alignc (num)
|
|
|
|
Align text to centre
|
|
|
|
|
|
|
|
|
2005-08-31 06:48:00 +00:00
|
|
|
apm_adapter
|
|
|
|
Display APM AC adapter status (FreeBSD only)
|
|
|
|
|
|
|
|
|
|
|
|
apm_battery_life
|
|
|
|
Display APM battery life in percent (FreeBSD only)
|
|
|
|
|
|
|
|
|
|
|
|
apm_battery_time
|
2008-06-03 20:46:15 +00:00
|
|
|
Display remaining APM battery life in hh:mm:ss or "unknown" if
|
2005-08-31 06:48:00 +00:00
|
|
|
AC adapterstatus is on-line or charging (FreeBSD only)
|
|
|
|
|
|
|
|
|
2006-11-03 20:54:52 +00:00
|
|
|
audacious_bar (height),(width)
|
|
|
|
Progress bar
|
|
|
|
|
|
|
|
|
|
|
|
audacious_bitrate
|
|
|
|
Bitrate of current tune
|
|
|
|
|
|
|
|
|
|
|
|
audacious_channels
|
|
|
|
Number of audio channels of current tune
|
|
|
|
|
|
|
|
|
|
|
|
audacious_filename
|
|
|
|
Full path and filename of current tune
|
|
|
|
|
|
|
|
|
|
|
|
audacious_frequency
|
|
|
|
Sampling frequency of current tune
|
|
|
|
|
|
|
|
|
|
|
|
audacious_length
|
|
|
|
Total length of current tune as MM:SS
|
|
|
|
|
|
|
|
|
|
|
|
audacious_length_seconds
|
|
|
|
Total length of current tune in seconds
|
|
|
|
|
|
|
|
|
|
|
|
audacious_playlist_position
|
|
|
|
Playlist position of current tune
|
|
|
|
|
|
|
|
|
|
|
|
audacious_playlist_length
|
|
|
|
Number of tunes in playlist
|
|
|
|
|
|
|
|
|
|
|
|
audacious_position
|
|
|
|
Position of current tune (MM:SS)
|
|
|
|
|
|
|
|
|
|
|
|
audacious_position_seconds
|
|
|
|
Position of current tune in seconds
|
|
|
|
|
|
|
|
|
|
|
|
audacious_status
|
|
|
|
Player status (Playing/Paused/Stopped/Not running)
|
|
|
|
|
|
|
|
|
2006-12-01 00:29:12 +00:00
|
|
|
audacious_title (max length)
|
|
|
|
Title of current tune with optional maximum length specifier
|
2006-11-03 20:54:52 +00:00
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
battery (num)
|
2008-06-03 20:46:15 +00:00
|
|
|
Battery status and remaining percentage capacity of ACPI or APM
|
|
|
|
battery. ACPI battery number can be given as argument (default
|
2006-12-12 23:21:14 +00:00
|
|
|
is BAT0).
|
|
|
|
|
|
|
|
|
2007-04-25 17:22:06 +00:00
|
|
|
battery_bar (height),(width) (num)
|
|
|
|
Battery percentage remaining of ACPI battery in a bar. ACPI bat-
|
|
|
|
tery number can be given as argument (default is BAT0).
|
|
|
|
|
|
|
|
|
|
|
|
battery_percent (num)
|
|
|
|
Battery percentage remaining for ACPI battery. ACPI battery num-
|
|
|
|
ber can be given as argument (default is BAT0).
|
|
|
|
|
|
|
|
|
2006-12-12 23:21:14 +00:00
|
|
|
battery_time (num)
|
2008-06-03 20:46:15 +00:00
|
|
|
Battery charge/discharge time remaining of ACPI battery. ACPI
|
2006-12-12 23:21:14 +00:00
|
|
|
battery number can be given as argument (default is BAT0).
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2006-01-02 03:39:51 +00:00
|
|
|
bmpx_artist
|
|
|
|
Artist in current BMPx track
|
|
|
|
|
|
|
|
|
|
|
|
bmpx_album
|
|
|
|
Album in current BMPx track
|
|
|
|
|
|
|
|
|
|
|
|
bmpx_title
|
|
|
|
Title of the current BMPx track
|
|
|
|
|
|
|
|
|
|
|
|
bmpx_track
|
|
|
|
Track number of the current BMPx track
|
|
|
|
|
|
|
|
|
|
|
|
bmpx_bitrate
|
|
|
|
Bitrate of the current BMPx track
|
|
|
|
|
|
|
|
|
|
|
|
bmpx_uri
|
|
|
|
URI of the current BMPx track
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
buffers
|
|
|
|
Amount of memory buffered
|
|
|
|
|
|
|
|
|
|
|
|
cached Amount of memory cached
|
|
|
|
|
|
|
|
|
|
|
|
color (color)
|
|
|
|
Change drawing color to color
|
|
|
|
|
|
|
|
|
2008-06-03 20:46:15 +00:00
|
|
|
colorN Change drawing color to colorN configuration option, where N is
|
|
|
|
a digit between 0 and 9, inclusively.
|
2007-04-25 17:22:06 +00:00
|
|
|
|
|
|
|
|
2008-03-18 00:23:16 +00:00
|
|
|
conky_version
|
|
|
|
Conky version
|
|
|
|
|
|
|
|
|
|
|
|
conky_build_date
|
|
|
|
Date Conky was built
|
|
|
|
|
|
|
|
|
|
|
|
conky_bulid_arch
|
|
|
|
CPU architecture Conky was built for
|
|
|
|
|
|
|
|
|
2005-08-27 10:36:28 +00:00
|
|
|
cpu (cpuN)
|
2008-04-01 21:37:49 +00:00
|
|
|
CPU usage in percents. For SMP machines, the CPU number can be
|
|
|
|
provided as an argument. ${cpu cpu0} is the total usage, and
|
2007-02-14 19:45:18 +00:00
|
|
|
${cpu cpuX} (X >= 1) are individual CPUs.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2005-08-27 10:36:28 +00:00
|
|
|
cpubar (cpu number) (height),(width)
|
2008-04-01 21:37:49 +00:00
|
|
|
Bar that shows CPU usage, height is bar's height in pixels. See
|
2005-08-31 06:48:00 +00:00
|
|
|
$cpu for more info on SMP.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
cpugraph normal|log (cpu number) (height),(width) (gradient colour 1)
|
|
|
|
(gradient colour 2)
|
2008-04-01 21:37:49 +00:00
|
|
|
CPU usage graph, with optional colours in hex, minus the #. See
|
2008-06-21 20:37:58 +00:00
|
|
|
$cpu for more info on SMP. Uses a logarithmic scale (to see small
|
|
|
|
numbers) when you use "log" instead of "normal".
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-02-09 02:21:06 +00:00
|
|
|
diskio (device)
|
|
|
|
Displays current disk IO. Device is optional, and takes the form
|
|
|
|
of sda for /dev/sda. Individual partitions are allowed.
|
2005-08-26 02:16:35 +00:00
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
diskiograph normal|log (device) (height),(width) (gradient colour 1)
|
|
|
|
(gradient colour 2) (scale)
|
2008-04-01 21:37:49 +00:00
|
|
|
Disk IO graph, colours defined in hex, minus the #. If scale is
|
2008-06-21 20:37:58 +00:00
|
|
|
non-zero, it becomes the scale for the graph. Uses a logarithmic
|
|
|
|
scale (to see small numbers) when you use "log".
|
2007-01-08 01:10:12 +00:00
|
|
|
|
|
|
|
|
2008-02-09 02:21:06 +00:00
|
|
|
diskio_read (device)
|
|
|
|
Displays current disk IO for reads. Device as in diskio.
|
2007-01-08 01:10:12 +00:00
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
diskiograph_read normal|log (device) (height),(width) (gradient colour
|
|
|
|
1) (gradient colour 2) (scale)
|
2007-01-08 01:10:12 +00:00
|
|
|
Disk IO graph for reads, colours defined in hex, minus the #. If
|
2008-02-09 02:21:06 +00:00
|
|
|
scale is non-zero, it becomes the scale for the graph. Device as
|
2008-06-21 20:37:58 +00:00
|
|
|
in diskio. Uses a logarithmic scale (to see small numbers) when
|
|
|
|
you use "log" instead of "normal".
|
2007-01-08 01:10:12 +00:00
|
|
|
|
|
|
|
|
2008-02-09 02:21:06 +00:00
|
|
|
diskio_write (device)
|
|
|
|
Displays current disk IO for writes. Device as in diskio.
|
2007-01-08 01:10:12 +00:00
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
diskiograph_write normal|log (device) (height),(width) (gradient colour
|
|
|
|
1) (gradient colour 2) (scale)
|
2008-04-01 21:37:49 +00:00
|
|
|
Disk IO graph for writes, colours defined in hex, minus the #.
|
2008-02-09 02:21:06 +00:00
|
|
|
If scale is non-zero, it becomes the scale for the graph. Device
|
2008-06-21 20:37:58 +00:00
|
|
|
as in diskio. Uses a logarithmic scale (to see small numbers)
|
|
|
|
when you use "log" instead of "normal".
|
2005-08-26 02:16:35 +00:00
|
|
|
|
|
|
|
|
2008-03-29 04:02:12 +00:00
|
|
|
disk_protect device
|
|
|
|
Disk protection status, if supported (needs kernel-patch).
|
|
|
|
Prints either "frozen" or "free " (note the padding).
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
downspeed net
|
2008-05-06 22:41:28 +00:00
|
|
|
Download speed in KiB
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
downspeedf net
|
2008-05-06 22:41:28 +00:00
|
|
|
Download speed in KiB with one decimal
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
downspeedgraph normal|log net (height),(width) (gradient colour 1)
|
|
|
|
(gradient colour 2) (scale)
|
2008-04-01 21:37:49 +00:00
|
|
|
Download speed graph, colours defined in hex, minus the #. If
|
2008-06-21 20:37:58 +00:00
|
|
|
scale is non-zero, it becomes the scale for the graph. Uses a
|
|
|
|
logarithmic scale (to see small numbers) when you use "log".
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
else Text to show if any of the above are not true
|
|
|
|
|
|
|
|
|
2006-11-30 20:46:34 +00:00
|
|
|
entropy_avail
|
|
|
|
Current entropy available for crypto freaks
|
|
|
|
|
|
|
|
|
|
|
|
entropy_bar (height),(width)
|
|
|
|
Normalized bar of available entropy for crypto freaks
|
|
|
|
|
|
|
|
|
|
|
|
entropy_poolsize
|
|
|
|
Total size of system entropy pool for crypto freaks
|
|
|
|
|
|
|
|
|
2005-08-23 03:00:50 +00:00
|
|
|
exec command
|
2006-01-12 01:22:14 +00:00
|
|
|
Executes a shell command and displays the output in conky. warn-
|
2008-04-01 21:37:49 +00:00
|
|
|
ing: this takes a lot more resources than other variables. I'd
|
2005-08-21 22:18:14 +00:00
|
|
|
recommend coding wanted behaviour in C and posting a patch.
|
|
|
|
|
|
|
|
|
2005-08-23 03:00:50 +00:00
|
|
|
execbar command
|
2008-04-01 21:37:49 +00:00
|
|
|
Same as exec, except if the first value return is a value be-
|
2006-08-10 16:56:13 +00:00
|
|
|
tween 0-100, it will use that number for a bar. The size for the
|
|
|
|
bar is currently fixed, but that may change in the future.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
execgraph (normal|log) command
|
|
|
|
Same as execbar, but graphs values. Uses a logaritmic scale when
|
|
|
|
the log option is given (to see small numbers). Values still have
|
|
|
|
to be between 0 and 100.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2005-08-24 01:05:27 +00:00
|
|
|
execi interval command
|
2008-04-01 21:37:49 +00:00
|
|
|
Same as exec but with specific interval. Interval can't be less
|
2005-08-30 00:22:55 +00:00
|
|
|
than update_interval in configuration. See also $texeci
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2005-08-23 03:00:50 +00:00
|
|
|
execibar interval command
|
|
|
|
Same as execbar, except with an interval
|
|
|
|
|
|
|
|
|
|
|
|
execigraph interval command
|
2008-03-31 04:02:33 +00:00
|
|
|
Same as execgraph, but takes an interval arg graphs values
|
2005-08-23 03:00:50 +00:00
|
|
|
|
|
|
|
|
2008-03-22 06:10:54 +00:00
|
|
|
execp command
|
|
|
|
Executes a shell command and displays the output in conky. warn-
|
2008-04-01 21:37:49 +00:00
|
|
|
ing: this takes a lot more resources than other variables. I'd
|
2008-03-22 06:10:54 +00:00
|
|
|
recommend coding wanted behaviour in C and posting a patch. This
|
2008-04-01 21:37:49 +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
|
2008-03-22 06:10:54 +00:00
|
|
|
loops, and then destroys all the objects. If you try to use any-
|
2008-04-01 21:37:49 +00:00
|
|
|
thing like $execi within an $execp statement, it will function-
|
2008-03-22 06:10:54 +00:00
|
|
|
ally run at the same interval that the $execp statement runs, as
|
|
|
|
it is created and destroyed at every interval.
|
|
|
|
|
|
|
|
|
|
|
|
execpi interval command
|
|
|
|
Same as execp but with specific interval. Interval can't be less
|
|
|
|
than update_interval in configuration. Note that the output from
|
2008-04-01 21:37:49 +00:00
|
|
|
the $execpi command is still parsed and evaluated at every in-
|
2008-03-22 06:10:54 +00:00
|
|
|
terval.
|
|
|
|
|
|
|
|
|
2006-05-09 23:08:23 +00:00
|
|
|
font (font)
|
2008-04-01 21:37:49 +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
|
2006-05-09 23:08:23 +00:00
|
|
|
$color)
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2006-05-22 02:49:22 +00:00
|
|
|
freq (n)
|
2008-04-01 21:37:49 +00:00
|
|
|
Returns CPU #n's frequency in MHz. CPUs are counted from 1. If
|
2006-05-22 02:49:22 +00:00
|
|
|
omitted, the parameter defaults to 1.
|
2005-08-22 00:24:24 +00:00
|
|
|
|
|
|
|
|
2006-05-22 02:49:22 +00:00
|
|
|
freq_g (n)
|
2008-04-01 21:37:49 +00:00
|
|
|
Returns CPU #n's frequency in GHz. CPUs are counted from 1. If
|
2006-05-22 02:49:22 +00:00
|
|
|
omitted, the parameter defaults to 1.
|
2005-08-22 00:24:24 +00:00
|
|
|
|
|
|
|
|
2005-08-26 02:16:35 +00:00
|
|
|
freq_dyn
|
2008-04-01 21:37:49 +00:00
|
|
|
Returns CPU frequency in MHz, but is calculated by counting to
|
|
|
|
clock cycles to complete an instruction. Only available for
|
2005-08-26 02:16:35 +00:00
|
|
|
x86/amd64.
|
|
|
|
|
|
|
|
|
|
|
|
freq_dyn_g
|
2008-04-01 21:37:49 +00:00
|
|
|
Returns CPU frequency in GHz, but is calculated by counting to
|
|
|
|
clock cycles to complete an instruction. Only available for
|
2005-08-26 02:16:35 +00:00
|
|
|
x86/amd64.
|
|
|
|
|
|
|
|
|
2005-08-22 00:24:24 +00:00
|
|
|
fs_bar (height),(width) fs
|
2008-04-01 21:37:49 +00:00
|
|
|
Bar that shows how much space is used on a file system. height
|
2005-08-21 22:18:14 +00:00
|
|
|
is the height in pixels. fs is any file on that file system.
|
|
|
|
|
|
|
|
|
|
|
|
fs_free (fs)
|
|
|
|
Free space on a file system available for users.
|
|
|
|
|
|
|
|
|
|
|
|
fs_free_perc (fs)
|
|
|
|
Free percentage of space on a file system available for users.
|
|
|
|
|
|
|
|
|
|
|
|
fs_size (fs)
|
|
|
|
File system size
|
|
|
|
|
|
|
|
|
2008-03-18 00:23:16 +00:00
|
|
|
fs_type (fs)
|
|
|
|
File system type
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
fs_used (fs)
|
|
|
|
File system used space
|
|
|
|
|
|
|
|
|
2006-08-10 16:56:13 +00:00
|
|
|
goto x The next element will be printed at position 'x'.
|
|
|
|
|
|
|
|
|
2008-03-23 02:10:23 +00:00
|
|
|
gw_iface
|
2008-04-01 21:37:49 +00:00
|
|
|
Displays the default route's interface or "multiple"/"none" ac-
|
2008-03-23 02:10:23 +00:00
|
|
|
cordingly.
|
|
|
|
|
|
|
|
|
2008-04-01 21:37:49 +00:00
|
|
|
gw_ip Displays the default gateway's IP or "multiple"/"none" accord-
|
2008-03-23 02:10:23 +00:00
|
|
|
ingly.
|
|
|
|
|
|
|
|
|
2006-08-10 16:56:13 +00:00
|
|
|
hddtemp dev, (host,(port))
|
2008-04-01 21:37:49 +00:00
|
|
|
Displays temperature of a selected hard disk drive as reported
|
|
|
|
by the hddtemp daemon running on host:port. Default host is
|
2006-08-10 16:56:13 +00:00
|
|
|
127.0.0.1, default port is 7634.
|
|
|
|
|
|
|
|
|
2005-08-26 05:52:43 +00:00
|
|
|
head logfile lines (interval)
|
2008-04-01 21:37:49 +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
|
2005-08-26 05:52:43 +00:00
|
|
|
lines can be displayed, or until the text buffer is filled.
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
hr (height)
|
|
|
|
Horizontal line, height is the height in pixels
|
|
|
|
|
|
|
|
|
2007-08-13 23:14:01 +00:00
|
|
|
hwmon (dev) type n
|
2008-04-01 21:37:49 +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
|
|
|
|
'in' or 'vol' meaning voltage; 'fan' meaning fan; 'temp' (Cel-
|
|
|
|
sius) or 'tempf' (Fahrenheit) meaning temperature. Parameter n
|
|
|
|
is number of the sensor. See /sys/class/hwmon/ on your local
|
2007-08-13 23:14:01 +00:00
|
|
|
computer.
|
2007-04-25 17:22:06 +00:00
|
|
|
|
|
|
|
|
2006-05-13 19:51:26 +00:00
|
|
|
iconv_start codeset_from codeset_to
|
2008-04-01 21:37:49 +00:00
|
|
|
Convert text from one codeset to another using GNU iconv. Needs
|
2006-05-13 19:51:26 +00:00
|
|
|
to be stopped with iconv_stop.
|
|
|
|
|
|
|
|
|
|
|
|
iconv_stop
|
|
|
|
Stop iconv codeset conversion.
|
|
|
|
|
|
|
|
|
2006-01-26 04:44:19 +00:00
|
|
|
i2c (dev) type n
|
2008-04-01 21:37:49 +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'
|
2007-08-13 23:14:01 +00:00
|
|
|
or 'vol' meaning voltage; 'fan' meaning fan; 'temp' (Celsius) or
|
2008-04-01 21:37:49 +00:00
|
|
|
'tempf' (Fahrenheit) meaning temperature. Parameter n is number
|
2007-08-13 23:14:01 +00:00
|
|
|
of the sensor. See /sys/bus/i2c/devices/ on your local computer.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2005-08-27 08:14:29 +00:00
|
|
|
i8k_ac_status
|
2008-04-01 21:37:49 +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
|
2005-08-27 08:14:29 +00:00
|
|
|
i8k itself.
|
|
|
|
|
|
|
|
|
|
|
|
i8k_bios
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2005-08-27 08:14:29 +00:00
|
|
|
the bios version as listed in /proc/i8k.
|
|
|
|
|
|
|
|
|
|
|
|
i8k_buttons_status
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2005-08-27 08:14:29 +00:00
|
|
|
the volume buttons status as listed in /proc/i8k.
|
|
|
|
|
|
|
|
|
|
|
|
i8k_cpu_temp
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2006-02-15 04:28:42 +00:00
|
|
|
the cpu temperature in Celsius, as reported by /proc/i8k.
|
2005-08-27 08:14:29 +00:00
|
|
|
|
|
|
|
|
|
|
|
i8k_cpu_tempf
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2006-11-21 21:13:49 +00:00
|
|
|
the cpu temperature in Fahrenheit, as reported by /proc/i8k.
|
2005-08-27 08:14:29 +00:00
|
|
|
|
|
|
|
|
|
|
|
i8k_left_fan_rpm
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
|
|
|
the left fan's rate of rotation, in revolutions per minute as
|
2005-08-27 08:14:29 +00:00
|
|
|
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
|
|
|
in reverse order.
|
|
|
|
|
|
|
|
|
|
|
|
i8k_left_fan_status
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2005-11-17 04:54:45 +00:00
|
|
|
the left fan status as listed in /proc/i8k (translated to human-
|
2008-04-01 21:37:49 +00:00
|
|
|
readable). Beware, some laptops i8k reports these fans in re-
|
2006-08-10 16:56:13 +00:00
|
|
|
verse order.
|
2005-08-27 08:14:29 +00:00
|
|
|
|
|
|
|
|
|
|
|
i8k_right_fan_rpm
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
|
|
|
the right fan's rate of rotation, in revolutions per minute as
|
2005-08-27 08:14:29 +00:00
|
|
|
listed in /proc/i8k. Beware, some laptops i8k reports these fans
|
|
|
|
in reverse order.
|
|
|
|
|
|
|
|
|
|
|
|
i8k_right_fan_status
|
2008-04-01 21:37:49 +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
|
2005-08-27 08:14:29 +00:00
|
|
|
reverse order.
|
|
|
|
|
|
|
|
|
|
|
|
i8k_serial
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2005-08-27 08:14:29 +00:00
|
|
|
your laptop serial number as listed in /proc/i8k.
|
|
|
|
|
|
|
|
|
|
|
|
i8k_version
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the i8k kernel driver for Inspiron laptops, displays
|
2005-08-27 08:14:29 +00:00
|
|
|
the version formatting of /proc/i8k.
|
|
|
|
|
|
|
|
|
2006-06-08 04:29:23 +00:00
|
|
|
ibm_fan
|
|
|
|
If running the IBM ACPI, displays the fan speed.
|
|
|
|
|
|
|
|
|
|
|
|
ibm_temps N
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the IBM ACPI, displays the temperatures from the IBM
|
2006-06-08 04:29:23 +00:00
|
|
|
temperature sensors (N=0..7) Sensor 0 is on the CPU, 3 is on the
|
|
|
|
GPU.
|
|
|
|
|
|
|
|
|
|
|
|
ibm_volume
|
2008-04-01 21:37:49 +00:00
|
|
|
If running the IBM ACPI, displays the "master" volume, con-
|
2006-06-08 04:29:23 +00:00
|
|
|
trolled by the volume keys (0-14).
|
|
|
|
|
|
|
|
|
|
|
|
ibm_brightness
|
|
|
|
If running the IBM ACPI, displays the brigtness of the laptops's
|
|
|
|
LCD (0-7).
|
|
|
|
|
|
|
|
|
2007-04-25 17:22:06 +00:00
|
|
|
if_empty (var)
|
2008-04-01 21:37:49 +00:00
|
|
|
if conky variable VAR is empty, display everything between
|
2007-04-25 17:22:06 +00:00
|
|
|
$if_empty and the matching $endif
|
|
|
|
|
|
|
|
|
2008-03-23 02:10:23 +00:00
|
|
|
if_gw if there is at least one default gateway, display everything be-
|
|
|
|
tween $if_gw and the matching $endif
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
if_running (process)
|
2008-04-01 21:37:49 +00:00
|
|
|
if PROCESS is running, display everything $if_running and the
|
2005-08-21 22:18:14 +00:00
|
|
|
matching $endif
|
|
|
|
|
|
|
|
|
2007-04-25 17:22:06 +00:00
|
|
|
if_existing file (string)
|
2008-04-01 21:37:49 +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
|
2007-04-25 17:22:06 +00:00
|
|
|
$if_existing and the matching $endif.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
if_mounted (mountpoint)
|
2007-04-25 17:22:06 +00:00
|
|
|
if MOUNTPOINT is mounted, display everything between $if_mounted
|
2005-08-21 22:18:14 +00:00
|
|
|
and the matching $endif
|
|
|
|
|
|
|
|
|
2008-03-18 00:23:16 +00:00
|
|
|
if_smapi_bat_installed (INDEX)
|
2008-04-01 21:37:49 +00:00
|
|
|
when using smapi, if the battery with index INDEX is installed,
|
|
|
|
display everything between $if_smapi_bat_installed and the
|
2008-03-18 00:23:16 +00:00
|
|
|
matching $endif
|
|
|
|
|
|
|
|
|
|
|
|
if_up (interface)
|
|
|
|
if INTERFACE exists and is up, display everything between $if_up
|
|
|
|
and the matching $endif
|
|
|
|
|
|
|
|
|
2006-05-08 22:34:38 +00:00
|
|
|
imap_messages (args)
|
2006-08-10 16:56:13 +00:00
|
|
|
Displays the number of messages in your global IMAP inbox by de-
|
2008-04-01 21:37:49 +00:00
|
|
|
fault. You can define individual IMAP inboxes seperately by
|
2006-05-08 22:34:38 +00:00
|
|
|
passing arguments to this object. Arguments are: "host user pass
|
2008-04-01 21:37:49 +00:00
|
|
|
[-i interval] [-p port] [-e command]". Default port is 143, de-
|
2006-08-10 16:56:13 +00:00
|
|
|
fault interval is 5 minutes. If the password is supplied as '*',
|
|
|
|
you will be prompted to enter the password when Conky starts.
|
2006-05-08 22:34:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
imap_unseen (args)
|
|
|
|
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
|
2008-04-01 21:37:49 +00:00
|
|
|
[-i interval] [-p port] [-e command]". Default port is 143, de-
|
2006-08-10 16:56:13 +00:00
|
|
|
fault interval is 5 minutes. If the password is supplied as '*',
|
|
|
|
you will be prompted to enter the password when Conky starts.
|
2006-05-08 22:34:38 +00:00
|
|
|
|
|
|
|
|
2008-03-31 04:02:33 +00:00
|
|
|
ioscheduler disk
|
2008-04-01 21:37:49 +00:00
|
|
|
Prints the current ioscheduler used for the given disk name
|
2008-03-23 02:10:23 +00:00
|
|
|
(i.e. e.g. "hda" or "sdb")
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
kernel Kernel version
|
|
|
|
|
|
|
|
|
2008-03-23 02:10:23 +00:00
|
|
|
laptop_mode
|
|
|
|
The value of /proc/sys/vm/laptop_mode
|
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
lines textfile
|
|
|
|
Displays the number of lines in the given file
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
loadavg
|
|
|
|
(1,2,3)> System load average, 1 is for past 1 minute, 2 for past
|
|
|
|
5 minutes and 3 for past 15 minutes.
|
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
loadgraph normal|log (height),(width) (gradient colour 1) (gradient
|
|
|
|
colour 2)
|
2008-04-13 04:10:35 +00:00
|
|
|
Load1 average graph, similar to xload, with optional colours in
|
2008-06-21 20:37:58 +00:00
|
|
|
hex, minus the #. Uses a logarithmic scale (to see small numbers)
|
|
|
|
when you use "log" instead of "normal".
|
2008-04-13 04:10:35 +00:00
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
machine
|
|
|
|
Machine, i686 for example
|
|
|
|
|
|
|
|
|
2007-10-02 23:57:41 +00:00
|
|
|
mails (mailbox) (interval)
|
2008-04-13 04:10:35 +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
|
2007-10-02 23:57:41 +00:00
|
|
|
your favourite protocol. See also new_mails.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2007-02-14 19:45:18 +00:00
|
|
|
mboxscan (-n number of messages to print) (-fw from width) (-sw subject
|
|
|
|
width) mbox
|
2008-04-13 04:10:35 +00:00
|
|
|
Print a summary of recent messages in an mbox format mailbox.
|
|
|
|
mbox parameter is the filename of the mailbox (can be encapsu-
|
2007-02-14 19:45:18 +00:00
|
|
|
lated using '"', ie. ${mboxscan -n 10 "/home/brenden/some box"}
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
mem Amount of memory in use
|
|
|
|
|
|
|
|
|
2005-08-22 00:24:24 +00:00
|
|
|
membar (height),(width)
|
2005-08-21 22:18:14 +00:00
|
|
|
Bar that shows amount of memory in use
|
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
memeasyfree
|
|
|
|
Amount of free memory including the memory that is very easily freed (buffers/cache)
|
|
|
|
|
|
|
|
|
|
|
|
memfree
|
|
|
|
Amount of free memory
|
|
|
|
|
|
|
|
|
|
|
|
memgraph normal|log (height),(width) (gradient colour 1) (gradient
|
|
|
|
colour 2)
|
2008-06-08 11:41:00 +00:00
|
|
|
Memory usage graph, with optional colours in hex, minus the #
|
2008-06-21 20:37:58 +00:00
|
|
|
Uses a logarithmic scale (to see small numbers) when you use
|
|
|
|
"log" instead of "normal".
|
2008-06-08 11:41:00 +00:00
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
memmax Total amount of memory
|
|
|
|
|
|
|
|
|
|
|
|
memperc
|
|
|
|
Percentage of memory in use
|
|
|
|
|
|
|
|
|
|
|
|
mpd_artist
|
|
|
|
Artist in current MPD song must be enabled at compile
|
|
|
|
|
|
|
|
|
|
|
|
mpd_album
|
|
|
|
Album in current MPD song
|
|
|
|
|
|
|
|
|
2005-08-22 00:24:24 +00:00
|
|
|
mpd_bar (height),(width)
|
2006-01-12 01:22:14 +00:00
|
|
|
Bar of mpd's progress
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
mpd_bitrate
|
|
|
|
Bitrate of current song
|
|
|
|
|
|
|
|
|
|
|
|
mpd_status
|
|
|
|
Playing, stopped, et cetera.
|
|
|
|
|
|
|
|
|
2007-08-06 03:11:30 +00:00
|
|
|
mpd_title (max length)
|
2005-08-21 22:18:14 +00:00
|
|
|
Title of current MPD song
|
|
|
|
|
|
|
|
|
|
|
|
mpd_vol
|
2006-01-12 01:22:14 +00:00
|
|
|
MPD's volume
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
mpd_elapsed
|
2006-01-12 01:22:14 +00:00
|
|
|
Song's elapsed time
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
mpd_length
|
2006-01-12 01:22:14 +00:00
|
|
|
Song's length
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
mpd_percent
|
2006-01-12 01:22:14 +00:00
|
|
|
Percent of song's progress
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2005-10-18 00:28:23 +00:00
|
|
|
mpd_random
|
|
|
|
Random status (On/Off)
|
|
|
|
|
|
|
|
|
|
|
|
mpd_repeat
|
|
|
|
Repeat status (On/Off)
|
|
|
|
|
|
|
|
|
|
|
|
mpd_track
|
|
|
|
Prints the MPD track field
|
|
|
|
|
|
|
|
|
2006-01-31 03:32:26 +00:00
|
|
|
mpd_name
|
|
|
|
Prints the MPD name field
|
|
|
|
|
|
|
|
|
|
|
|
mpd_file
|
|
|
|
Prints the file name of the current MPD song
|
|
|
|
|
|
|
|
|
2006-03-08 06:27:53 +00:00
|
|
|
mpd_smart
|
|
|
|
Prints the song name in either the form "artist - title" or file
|
|
|
|
name, depending on whats available
|
|
|
|
|
|
|
|
|
2008-03-23 02:10:23 +00:00
|
|
|
nameserver (index)
|
2008-04-13 04:10:35 +00:00
|
|
|
Print a nameserver from /etc/resolv.conf. Index starts at and
|
2008-03-23 02:10:23 +00:00
|
|
|
defaults to 0.
|
|
|
|
|
|
|
|
|
2007-10-02 23:57:41 +00:00
|
|
|
new_mails (mailbox) (interval)
|
|
|
|
Unread mail count in the specified mailbox or mail spool if not.
|
|
|
|
Both mbox and maildir type mailboxes are supported.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
nodename
|
|
|
|
Hostname
|
|
|
|
|
|
|
|
|
2008-06-03 20:46:15 +00:00
|
|
|
nvidia threshold temp gpufreq memfreq imagequality
|
|
|
|
Nvidia graficcard support for the XNVCtrl library. Each option
|
|
|
|
gives back one integer value: (threshold): the thresholdtempera-
|
|
|
|
ture at which the gpu slows down (temp): gives the gpu current
|
|
|
|
temperature (gpufreq): gives the current gpu frequency (mem-
|
|
|
|
freq): gives the current mem frequency (imagequality): which im-
|
|
|
|
agequality should be choosen by OpenGL applications
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
outlinecolor (color)
|
|
|
|
Change outline color
|
|
|
|
|
|
|
|
|
2006-04-23 21:37:59 +00:00
|
|
|
pb_battery item
|
|
|
|
If running on Apple powerbook/ibook, display information on bat-
|
2008-06-03 20:46:15 +00:00
|
|
|
tery status. The item parameter specifies, what information to
|
2006-04-23 21:37:59 +00:00
|
|
|
display. Exactly one item must be specified. Valid items are:
|
|
|
|
|
|
|
|
status: Display if battery is fully charged, charging, discharg-
|
|
|
|
ing or absent (running on AC)
|
2008-06-03 20:46:15 +00:00
|
|
|
percent: Display charge of battery in percent, if charging or
|
|
|
|
discharging. Nothing will be displayed, if battery is fully
|
2006-04-23 21:37:59 +00:00
|
|
|
charged or absent.
|
|
|
|
time: Display the time remaining until the battery will be fully
|
2008-06-03 20:46:15 +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
|
2006-04-23 21:37:59 +00:00
|
|
|
discharging.
|
|
|
|
|
|
|
|
|
2007-08-13 00:28:48 +00:00
|
|
|
platform (dev) type n
|
2008-06-03 20:46:15 +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'
|
2007-08-13 23:14:01 +00:00
|
|
|
(Celsius) or 'tempf' (Fahrenheit) meaning temperature. Parameter
|
2008-06-03 20:46:15 +00:00
|
|
|
n is number of the sensor. See /sys/bus/platform/devices/ on
|
2007-08-13 23:14:01 +00:00
|
|
|
your local computer.
|
2007-08-13 00:28:48 +00:00
|
|
|
|
|
|
|
|
2006-05-08 22:34:38 +00:00
|
|
|
pop3_unseen (args)
|
|
|
|
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
|
2008-06-03 20:46:15 +00:00
|
|
|
[-i interval] [-p port] [-e command]". Default port is 110, de-
|
2006-08-10 16:56:13 +00:00
|
|
|
fault interval is 5 minutes. If the password is supplied as '*',
|
|
|
|
you will be prompted to enter the password when Conky starts.
|
2006-05-08 22:34:38 +00:00
|
|
|
|
|
|
|
|
|
|
|
pop3_used (args)
|
2008-06-03 20:46:15 +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]". Default
|
|
|
|
port is 110, default interval is 5 minutes. If the password is
|
2006-05-08 22:34:38 +00:00
|
|
|
supplied as '*', you will be prompted to enter the password when
|
|
|
|
Conky starts.
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
pre_exec shell command
|
|
|
|
Executes a shell command one time before conky displays anything
|
|
|
|
and puts output as text.
|
|
|
|
|
|
|
|
|
|
|
|
processes
|
|
|
|
Total processes (sleeping and running)
|
|
|
|
|
|
|
|
|
|
|
|
running_processes
|
|
|
|
Running processes (not sleeping), requires Linux 2.6
|
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
scroll length text
|
|
|
|
Scroll 'text' showing 'length' number of characters at the same
|
|
|
|
time. The text may also contain variables. If a var creates out-
|
|
|
|
put on multiple lines then the lines are placed behind each oth-
|
|
|
|
er 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 ("foobar" and " foobar"
|
|
|
|
can both generate "barfoo" but "foobar " will keep the spaces
|
|
|
|
like this "bar foo").
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
shadecolor (color)
|
|
|
|
Change shading color
|
|
|
|
|
|
|
|
|
2008-03-18 00:23:16 +00:00
|
|
|
smapi (ARGS)
|
2008-06-03 20:46:15 +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
|
2008-03-18 00:23:16 +00:00
|
|
|
available, better use one of the smapi_* variables instead.
|
|
|
|
|
|
|
|
|
|
|
|
smapi_bat_perc (INDEX)
|
2008-06-03 20:46:15 +00:00
|
|
|
when using smapi, display the remaining capacity in percent of
|
|
|
|
the battery with index INDEX. This is a separate variable be-
|
2008-03-18 00:23:16 +00:00
|
|
|
cause it supports the 'use_spacer' configuration option.
|
|
|
|
|
|
|
|
|
|
|
|
smapi_bat_bar (INDEX),(height),(width)
|
2008-06-03 20:46:15 +00:00
|
|
|
when using smapi, display the remaining capacity of the battery
|
2008-03-18 00:23:16 +00:00
|
|
|
with index INDEX as a bar.
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
stippled_hr (space)
|
|
|
|
Stippled (dashed) horizontal line
|
|
|
|
|
|
|
|
|
2005-08-22 00:24:24 +00:00
|
|
|
swapbar (height),(width)
|
2005-08-21 22:18:14 +00:00
|
|
|
Bar that shows amount of swap in use
|
|
|
|
|
|
|
|
|
|
|
|
swap Amount of swap in use
|
|
|
|
|
|
|
|
|
|
|
|
swapmax
|
|
|
|
Total amount of swap
|
|
|
|
|
|
|
|
|
|
|
|
swapperc
|
|
|
|
Percentage of swap in use
|
|
|
|
|
|
|
|
|
|
|
|
sysname
|
|
|
|
System name, Linux for example
|
|
|
|
|
|
|
|
|
2005-11-02 04:22:40 +00:00
|
|
|
tcp_portmon port_begin port_end item (index) (ip4 only at present)
|
|
|
|
TCP port monitor for specified local ports. Port numbers must be
|
|
|
|
in the range 1 to 65535. Valid items are:
|
|
|
|
|
|
|
|
count - total number of connections in the range
|
|
|
|
rip - remote ip address
|
|
|
|
rhost - remote host name
|
|
|
|
rport - remote port number
|
2006-03-31 02:50:54 +00:00
|
|
|
rservice - remote service name from /etc/services
|
2005-11-02 04:22:40 +00:00
|
|
|
lip - local ip address
|
|
|
|
lhost - local host name
|
2006-03-31 02:50:54 +00:00
|
|
|
lport - local port number
|
2005-11-02 04:22:40 +00:00
|
|
|
lservice - local service name from /etc/services
|
|
|
|
|
|
|
|
The connection index provides you with access to each connection
|
2006-08-10 16:56:13 +00:00
|
|
|
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
|
2008-06-03 20:46:15 +00:00
|
|
|
simply ignored. For the "count" item, the connection index must
|
2006-08-10 16:56:13 +00:00
|
|
|
be omitted. It is required for all other items.
|
2005-11-02 04:22:40 +00:00
|
|
|
|
|
|
|
Examples:
|
2008-06-03 20:46:15 +00:00
|
|
|
${tcp_portmon 6881 6999 count} - displays the number of connec-
|
2005-11-02 04:22:40 +00:00
|
|
|
tions in the bittorrent port range
|
2008-06-03 20:46:15 +00:00
|
|
|
${tcp_portmon 22 22 rip 0} - displays the remote host ip of the
|
2005-11-02 04:22:40 +00:00
|
|
|
first sshd connection
|
2008-06-03 20:46:15 +00:00
|
|
|
${tcp_portmon 22 22 rip 9} - displays the remote host ip of the
|
2005-11-02 04:22:40 +00:00
|
|
|
tenth sshd connection
|
|
|
|
${tcp_portmon 1 1024 rhost 0} - displays the remote host name of
|
|
|
|
the first connection on a privileged port
|
|
|
|
${tcp_portmon 1 1024 rport 4} - displays the remote host port of
|
|
|
|
the fifth connection on a privileged port
|
2008-06-03 20:46:15 +00:00
|
|
|
${tcp_portmon 1 65535 lservice 14} - displays the local service
|
2005-11-02 04:22:40 +00:00
|
|
|
name of the fifteenth connection in the range of all ports
|
|
|
|
|
|
|
|
Note that port monitor variables which share the same port range
|
2006-01-12 01:22:14 +00:00
|
|
|
actually refer to the same monitor, so many references to a sin-
|
2005-11-02 04:22:40 +00:00
|
|
|
gle port range for different items and different indexes all use
|
2008-06-03 20:46:15 +00:00
|
|
|
the same monitor internally. In other words, the program avoids
|
2005-11-02 04:22:40 +00:00
|
|
|
creating redundant monitors.
|
|
|
|
|
2005-08-30 00:22:55 +00:00
|
|
|
texeci interval command
|
2008-06-03 20:46:15 +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-
|
2006-08-10 16:56:13 +00:00
|
|
|
terval at least 6 seconds. See also $execi.
|
2005-08-30 00:22:55 +00:00
|
|
|
|
|
|
|
|
2005-08-22 00:24:24 +00:00
|
|
|
offset (pixels)
|
|
|
|
Move text over by N pixels. See also $voffset.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2007-08-10 20:57:30 +00:00
|
|
|
rss url delay_in_minutes action item_num
|
2008-06-03 20:46:15 +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
|
2007-08-10 20:57:30 +00:00
|
|
|
par) and item_titles.
|
|
|
|
|
|
|
|
|
2006-08-10 16:56:13 +00:00
|
|
|
tab (width, (start))
|
|
|
|
Puts a tab of the specified width, starting from column 'start'.
|
|
|
|
|
|
|
|
|
2005-08-26 05:52:43 +00:00
|
|
|
tail logfile lines (interval)
|
|
|
|
Displays last N lines of supplied text text file. If interval is
|
2006-01-12 01:22:14 +00:00
|
|
|
not supplied, Conky assumes 2x Conky's interval. Max of 30 lines
|
2005-08-26 05:52:43 +00:00
|
|
|
can be displayed, or until the text buffer is filled.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
time (format)
|
2008-06-03 20:46:15 +00:00
|
|
|
Local time, see man strftime to get more information about for-
|
2005-08-21 22:18:14 +00:00
|
|
|
mat
|
|
|
|
|
|
|
|
|
2006-08-10 16:56:13 +00:00
|
|
|
utime (format)
|
|
|
|
Display time in UTC (universal coordinate time).
|
|
|
|
|
|
|
|
|
|
|
|
tztime (timezone) (format)
|
2008-06-03 20:46:15 +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
|
2006-08-10 16:56:13 +00:00
|
|
|
/usr/share/zoneinfo. e.g. US/Pacific, Europe/Zurich, etc.
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
totaldown net
|
2008-06-03 20:46:15 +00:00
|
|
|
Total download, overflows at 4 GB on Linux with 32-bit arch and
|
2006-08-10 16:56:13 +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.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
top type, num
|
2008-06-03 20:46:15 +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
|
2008-03-31 03:51:29 +00:00
|
|
|
can be a max of 10 processes listed.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
top_mem type, num
|
|
|
|
Same as top, except sorted by mem usage instead of cpu
|
|
|
|
|
|
|
|
|
|
|
|
totalup net
|
|
|
|
Total upload, this one too, may overflow
|
|
|
|
|
|
|
|
|
|
|
|
updates Number of updates
|
|
|
|
for debugging
|
|
|
|
|
|
|
|
|
|
|
|
upspeed net
|
2008-05-06 22:41:28 +00:00
|
|
|
Upload speed in KiB
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
upspeedf net
|
2008-05-06 22:41:28 +00:00
|
|
|
Upload speed in KiB with one decimal
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
upspeedgraph normal|log net (height),(width) (gradient colour 1)
|
|
|
|
(gradient colour 2) (scale)
|
2008-06-03 20:46:15 +00:00
|
|
|
Upload speed graph, colours defined in hex, minus the #. If
|
2008-06-21 20:37:58 +00:00
|
|
|
scale is non-zero, it becomes the scale for the graph. Uses a
|
|
|
|
logarithmic scale (to see small numbers) when you use "log".
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
uptime Uptime
|
|
|
|
|
|
|
|
|
|
|
|
uptime_short
|
|
|
|
Uptime in a shorter format
|
|
|
|
|
|
|
|
|
2008-03-18 00:23:16 +00:00
|
|
|
user_number
|
|
|
|
Number of users logged in
|
|
|
|
|
|
|
|
|
|
|
|
user_names
|
|
|
|
Lists the names of the users logged in
|
|
|
|
|
|
|
|
|
|
|
|
user_terms
|
|
|
|
Lists the consoles in use
|
|
|
|
|
|
|
|
|
|
|
|
user_times
|
|
|
|
Lists how long users have been logged in for
|
|
|
|
|
|
|
|
|
2005-08-22 00:24:24 +00:00
|
|
|
voffset (pixels)
|
2008-06-03 20:46:15 +00:00
|
|
|
Change vertical offset by N pixels. Negative values will cause
|
2005-08-22 00:24:24 +00:00
|
|
|
text to overlap. See also $offset.
|
|
|
|
|
|
|
|
|
2006-06-08 04:29:23 +00:00
|
|
|
voltage_mv (n)
|
2008-06-03 20:46:15 +00:00
|
|
|
Returns CPU #n's voltage in mV. CPUs are counted from 1. If
|
2006-06-08 04:29:23 +00:00
|
|
|
omitted, the parameter defaults to 1.
|
|
|
|
|
|
|
|
|
|
|
|
voltage_v (n)
|
|
|
|
Returns CPU #n's voltage in V. CPUs are counted from 1. If omit-
|
|
|
|
ted, the parameter defaults to 1.
|
|
|
|
|
|
|
|
|
2007-08-10 20:57:30 +00:00
|
|
|
wireless_essid net
|
|
|
|
Wireless access point ESSID (Linux only)
|
|
|
|
|
|
|
|
|
|
|
|
wireless_mode net
|
|
|
|
Wireless mode (Managed/Ad-Hoc/Master) (Linux only)
|
|
|
|
|
|
|
|
|
|
|
|
wireless_bitrate net
|
|
|
|
Wireless bitrate (ie 11 Mb/s) (Linux only)
|
|
|
|
|
|
|
|
|
|
|
|
wireless_ap net
|
|
|
|
Wireless access point MAC address (Linux only)
|
|
|
|
|
|
|
|
|
|
|
|
wireless_link_qual net
|
|
|
|
Wireless link quality (Linux only)
|
|
|
|
|
|
|
|
|
|
|
|
wireless_link_qual_max net
|
|
|
|
Wireless link quality maximum value (Linux only)
|
|
|
|
|
|
|
|
|
|
|
|
wireless_link_qual_perc net
|
|
|
|
Wireless link quality in percents (Linux only)
|
|
|
|
|
|
|
|
|
|
|
|
wireless_link_bar (height), (width) net
|
|
|
|
Wireless link quality bar (Linux only)
|
|
|
|
|
|
|
|
|
2008-06-21 20:37:58 +00:00
|
|
|
words textfile
|
|
|
|
Displays the number of words in the given file
|
|
|
|
|
|
|
|
|
2007-04-25 17:22:06 +00:00
|
|
|
xmms2_artist
|
|
|
|
Artist in current XMMS2 song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_album
|
|
|
|
Album in current XMMS2 song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_title
|
|
|
|
Title in current XMMS2 song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_genre
|
|
|
|
Genre in current XMMS2 song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_comment
|
|
|
|
Comment in current XMMS2 song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_decoder
|
|
|
|
Decoder plugin used
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_transport
|
|
|
|
Transport plugin used
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_url
|
|
|
|
Full path to current song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_tracknr
|
|
|
|
Track number in current XMMS2 song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_bitrate
|
|
|
|
Bitrate of current song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_id
|
|
|
|
XMMS2 id of current song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_duration
|
|
|
|
Duration of current song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_elapsed
|
|
|
|
Song's elapsed time
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_size
|
|
|
|
Size of current song
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_percent
|
|
|
|
Percent of song's progress
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_status
|
|
|
|
XMMS2 status (Playing, Paused, Stopped, or Disconnected)
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_bar (height),(width)
|
|
|
|
Bar of XMMS2's progress
|
|
|
|
|
|
|
|
|
|
|
|
xmms2_smart
|
|
|
|
Prints the song name in either the form "artist - title" or file
|
|
|
|
name, depending on whats available
|
|
|
|
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
EXAMPLES
|
2007-10-17 20:18:29 +00:00
|
|
|
conky -t '${time %D %H:%M}' -o -u 30
|
2005-08-21 22:18:14 +00:00
|
|
|
Start Conky in its own window with date and clock as text and 30
|
|
|
|
sec update interval.
|
|
|
|
|
|
|
|
conky -a top_left -x 5 -y 500 -d
|
|
|
|
Start Conky to background at coordinates (5, 500).
|
|
|
|
|
|
|
|
FILES
|
|
|
|
~/.conkyrc default configuration file
|
|
|
|
|
|
|
|
BUGS
|
2006-01-12 01:22:14 +00:00
|
|
|
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
|
2008-06-03 20:46:15 +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-03-31 04:56:39 +00:00
|
|
|
which makes Conky to create its own window. If you do try running Conky
|
2008-06-03 20:46:15 +00:00
|
|
|
in its own window, be sure to read up on the own_window_type settings
|
2008-03-31 04:56:39 +00:00
|
|
|
and experiment.
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
SEE ALSO
|
2008-03-31 04:56:39 +00:00
|
|
|
<http://conky.sourceforge.net/>
|
2005-08-21 22:18:14 +00:00
|
|
|
|
2006-08-10 16:56:13 +00:00
|
|
|
<http://www.sourceforge.net/projects/conky>
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
#conky on irc.freenode.net
|
|
|
|
|
2008-03-31 04:56:39 +00:00
|
|
|
COPYING
|
2008-06-03 20:46:15 +00:00
|
|
|
Copyright (c) 2005-2008 Brenden Matthews, Philip Kovacs, et. al. Any
|
2008-03-31 04:56:39 +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-
|
2008-06-03 20:46:15 +00:00
|
|
|
ly (such as in portmon code, timed thread code, and audacious code
|
2008-03-31 04:56:39 +00:00
|
|
|
which are LGPL, and prss which is an MIT-style license).
|
|
|
|
|
2005-08-21 22:18:14 +00:00
|
|
|
AUTHORS
|
2008-03-31 04:56:39 +00:00
|
|
|
The Conky dev team (see AUTHORS for a full list of contributors).
|
2005-08-21 22:18:14 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
2008-05-06 22:41:28 +00:00
|
|
|
2008-05-06 conky(1)
|