1 '\" t -*- coding: us-ascii -*-
3 .if \n(.g .ds T> \\F[\n[.fam]]
7 .if \n(.g .mso www.tmac
8 .TH conky 1 2009-08-01 "" ""
10 conky \- A system monitor for X originally based on the torsmo code, but more kickass. It just keeps on given'er. Yeah.
16 .if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
25 Conky is a system monitor for X originally based on
26 torsmo. Since its inception, Conky has changed
27 significantly from its predecessor, while maintaining
28 simplicity and configurability. Conky can display just
29 about anything, either on your root desktop or in its own
30 window. Not only does Conky have many built-in objects, it
31 can also display just about any piece of information by
32 using scripts and other external programs.
34 Conky has more than 250 built in objects, including
35 support for a plethora of OS stats (uname, uptime, CPU
36 usage, mem usage, disk usage, "top" like process stats, and
37 network monitoring, just to name a few), built in IMAP and
38 POP3 support, built in support for many popular music
39 players (MPD, XMMS2, BMPx, Audacious), and much much more.
40 Conky can display this info either as text, or using simple
41 progress bars and graph widgets, with different fonts and
44 We are always looking for help, whether its reporting
45 bugs, writing patches, or writing docs. Please use the
46 facilities at SourceForge to make bug reports, feature
47 requests, and submit patches, or stop by #conky on
48 irc.freenode.net if you have questions or want to
51 Thanks for your interest in Conky.
53 For users compiling from source on a binary distro,
54 make sure you have the X development libraries installed
55 (Unless you provide configure with "--disable-x11"). This
56 should be a package along the lines of "libx11-dev" or
57 "xorg-x11-dev" for X11 libs, and similar "-dev" format for
58 the other libs required (depending on your configure
59 options). You should be able to see which extra packages
60 you need to install by reading errors that you get from
61 \&'./configure'. You can enable/disable stuff by giving
62 options to configure, but be careful with disabling. For
63 example: with --disable-math you won't get errors but
64 logarithmic graphs will be normal graphs and gauges
67 Conky has (for some time) been available in the
68 repositories of most popular distributions. Here are some
69 installation instructions for a few:
71 Gentoo users -- Conky is in Gentoo's Portage...
72 simply use "emerge app-admin/conky" for
75 Debian, etc. users -- Conky should be in your
76 repositories, and can be installed by doing "aptitude
79 Example to compile and run Conky with all optional
80 components (note that some configure options may differ for
83 \fB\*(T<\fBsh autogen.sh\fR\*(T> \fR\*(T<\fB# Only required if building from the git repo\fR\*(T>
85 \fB\*(T<\fB\&./configure\fR\*(T> \fR\*(T<\fB\-\-prefix=/usr \-\-mandir=/usr/share/man \-\-infodir=/usr/share/info \-\-datadir=/usr/share \-\-sysconfdir=/etc \-\-localstatedir=/var/lib \-\-disable\-own\-window \-\-enable\-audacious[=yes|no|legacy] \-\-enable\-bmpx \-\-disable\-hddtemp \-\-disable\-mpd \-\-enable\-xmms2 \-\-disable\-portmon \-\-disable\-network \-\-enable\-debug \-\-disable\-x11 \-\-disable\-double\-buffer \-\-disable\-xdamage \-\-disable\-xft\fR\*(T>
87 \fB\*(T<\fBmake\fR\*(T> \fR
89 \fB\*(T<\fBmake install\fR\*(T> \fR\*(T<\fB# Optional\fR\*(T>
91 \fB\*(T<\fBsrc/conky\fR\*(T> \fR
93 Conky has been tested to be compatible with C99 C,
94 however it has not been tested with anything other than
95 gcc, and is not guaranteed to work with other
99 Conky is generally very good on resources. That said,
100 the more you try to make Conky do, the more resources it is
103 An easy way to force Conky to reload your ~/.conkyrc:
104 "killall -SIGUSR1 conky". Saves you the trouble of having
105 to kill and then restart. You can now also do the same with
108 Command line options override configurations defined in
111 \fB\*(T<\fB\-v | \-V | \-\-version\fR\*(T> \fR
112 Prints version and exits
115 \fB\*(T<\fB\-q | \-\-quiet\fR\*(T> \fR
116 Run Conky in 'quiet mode' (ie. no output)
119 \fB\*(T<\fB\-D | \-\-debug\fR\*(T> \fR
120 Increase debugging output, ie. -DD for more
124 \fB\*(T<\fB\-a | \-\-alignment=\fR\*(T> \fR\*(T<\fBALIGNMENT\fR\*(T>
125 Text alignment on screen,
126 {top,bottom,middle}_{left,right,middle} or none. Can also
127 be abbreviated with first chars of position, ie. tr for
131 \fB\*(T<\fB\-b | \-\-double\-buffer\fR\*(T> \fR
132 Use double buffering (eliminates "flicker")
135 \fB\*(T<\fB\-c | \-\-config=\fR\*(T> \fR\*(T<\fBFILE\fR\*(T>
136 Config file to load instead of $HOME/.conkyrc
139 \fB\*(T<\fB\-C | \-\-print\-config\fR\*(T> \fR
140 Print builtin default config to stdout. See also
141 the section EXAMPLES for more information.
144 \fB\*(T<\fB\-d | \-\-daemonize\fR\*(T> \fR
145 Daemonize Conky, aka fork to background
148 \fB\*(T<\fB\-f | \-\-font=\fR\*(T> \fR\*(T<\fBFONT\fR\*(T>
152 \fB\*(T<\fB\-h | \-\-help\fR\*(T> \fR
153 Prints command line help and exits
156 \fB\*(T<\fB\-o | \-\-own\-window\fR\*(T> \fR
157 Create own window to draw
160 \fB\*(T<\fB\-t | \-\-text=\fR\*(T> \fR\*(T<\fBTEXT\fR\*(T>
161 Text to render, remember single quotes, like -t '
165 \fB\*(T<\fB\-p | \-\-pause=\fR\*(T> \fR\*(T<\fBSECONDS\fR\*(T>
166 Time to pause before actually starting Conky
169 \fB\*(T<\fB\-u | \-\-interval=\fR\*(T> \fR\*(T<\fBSECONDS\fR\*(T>
173 \fB\*(T<\fB\-w | \-\-window\-id=\fR\*(T> \fR\*(T<\fBWIN_ID\fR\*(T>
177 \fB\*(T<\fB\-X | \-\-display=\fR\*(T> \fR\*(T<\fBDISPLAY\fR\*(T>
181 \fB\*(T<\fB\-x\fR\*(T> \fR\*(T<\fBX_COORDINATE\fR\*(T>
185 \fB\*(T<\fB\-y\fR\*(T> \fR\*(T<\fBY_COORDINATE\fR\*(T>
189 \fB\*(T<\fB\-i\fR\*(T> \fR\*(T<\fBCOUNT\fR\*(T>
190 Number of times to update Conky (and quit)
192 .SH "CONFIGURATION SETTINGS"
193 Default configuration file location is $HOME/.conkyrc or
194 ${sysconfdir}/conky/conky.conf. On most systems, sysconfdir is
195 /etc, and you can find the sample config file there
196 (/etc/conky/conky.conf).
198 You might want to copy it to $HOME/.conkyrc and then
199 start modifying it. Other configs can be found at
202 \fB\*(T<\fBTEXT\fR\*(T> \fR
203 After this begins text to be formatted on screen.
204 Backslash (\e) escapes newlines in the text section. This
205 can be useful for cleaning up config files where conky is
206 used to pipe input to dzen2.
209 \fB\*(T<\fBalignment\fR\*(T> \fR
210 Aligned position on screen, may be top_left,
211 top_right, top_middle, bottom_left, bottom_right,
212 bottom_middle, middle_left, middle_middle, middle_right, or
213 none (also can be abreviated as tl, tr, tm, bl, br, bm, ml,
214 mm, mr). See also gap_x and gap_y.
217 \fB\*(T<\fBappend_file\fR\*(T> \fR
218 Append the file given as argument.
221 \fB\*(T<\fBbackground\fR\*(T> \fR
222 Boolean value, if true, Conky will be forked to
223 background when started.
226 \fB\*(T<\fBborder_inner_margin\fR\*(T> \fR
227 Inner border margin in pixels (the margin between
228 the border and text).
231 \fB\*(T<\fBborder_outer_margin\fR\*(T> \fR
232 Outer border margin in pixels (the margin between
233 the border and the edge of the window).
236 \fB\*(T<\fBborder_width\fR\*(T> \fR
237 Border width in pixels.
240 \fB\*(T<\fBcolorN\fR\*(T> \fR
241 Predefine a color for use inside TEXT segments.
242 Substitute N by a digit between 0 and 9, inclusively. When
243 specifying the color value in hex, omit the leading hash
247 \fB\*(T<\fBcpu_avg_samples\fR\*(T> \fR
248 The number of samples to average for CPU
252 \fB\*(T<\fBdefault_bar_size\fR\*(T> \fR
253 Specify a default width and height for bars.
254 Example: 'default_bar_size 0 6'. This is particularly
255 useful for execbar and execibar as they do not take size
259 \fB\*(T<\fBdefault_color\fR\*(T> \fR
260 Default color and border color
263 \fB\*(T<\fBdefault_gauge_size\fR\*(T> \fR
264 Specify a default width and height for gauges.
265 Example: 'default_gauge_size 25 25'. This is particularly
266 useful for execgauge and execigauge as they do not take
270 \fB\*(T<\fBdefault_graph_size\fR\*(T> \fR
271 Specify a default width and height for graphs.
272 Example: 'default_graph_size 0 25'. This is particularly
273 useful for execgraph and execigraph as they do not take
277 \fB\*(T<\fBdefault_outline_color\fR\*(T> \fR
278 Default outline color
281 \fB\*(T<\fBdefault_shade_color\fR\*(T> \fR
282 Default shading color and border's shading color
285 \fB\*(T<\fBdisable_auto_reload\fR\*(T> \fR
286 Enable to disable the inotify-based auto config reload feature.
289 \fB\*(T<\fBdiskio_avg_samples\fR\*(T> \fR
290 The number of samples to average for disk I/O
294 \fB\*(T<\fBdisplay\fR\*(T> \fR
295 Specify an X display to connect to.
298 \fB\*(T<\fBdouble_buffer\fR\*(T> \fR
299 Use the Xdbe extension? (eliminates flicker) It
300 is highly recommended to use own window with this one so
301 double buffer won't be so big.
304 \fB\*(T<\fBdraw_borders\fR\*(T> \fR
305 Draw borders around text?
308 \fB\*(T<\fBdraw_graph_borders\fR\*(T> \fR
309 Draw borders around graphs?
312 \fB\*(T<\fBdraw_outline\fR\*(T> \fR
316 \fB\*(T<\fBdraw_shades\fR\*(T> \fR
320 \fB\*(T<\fBextra_newline\fR\*(T> \fR
321 Put an extra newline at the end when writing to
322 stdout, useful for writing to awesome's wiboxes.
325 \fB\*(T<\fBfont\fR\*(T> \fR
326 Font name in X, xfontsel can be used to get a
330 \fB\*(T<\fBformat_human_readable\fR\*(T> \fR
331 If enabled, values which are in bytes will be
332 printed in human readable format (i.e., KiB, MiB, etc). If
333 disabled, the number of bytes is printed instead.
336 \fB\*(T<\fBgap_x\fR\*(T> \fR
337 Gap, in pixels, between right or left border of
338 screen, same as passing -x at command line, e.g. gap_x 10.
339 For other position related stuff, see 'alignment'.
342 \fB\*(T<\fBgap_y\fR\*(T> \fR
343 Gap, in pixels, between top or bottom border of
344 screen, same as passing -y at command line, e.g. gap_y 10.
345 For other position related stuff, see 'alignment'.
348 \fB\*(T<\fBhddtemp_host\fR\*(T> \fR
349 Hostname to connect to for hddtemp objects. Defaults
353 \fB\*(T<\fBhddtemp_port\fR\*(T> \fR
354 Port to use for hddtemp connections. Defaults to
358 \fB\*(T<\fBif_up_strictness\fR\*(T> \fR
359 How strict should if_up be when testing an
360 interface for being up? The value is one of up, link or
361 address, to check for the interface being solely up, being
362 up and having link or being up, having link and an assigned
366 \fB\*(T<\fBimap\fR\*(T> \fR
367 Default global IMAP server. Arguments are: "host
368 user pass [-i interval (in seconds)] [-f 'folder'] [-p port]
369 [-e 'command'] [-r retries]". Default port is 143, default
370 folder is 'INBOX', default interval is 5 minutes, and
371 default number of retries before giving up is 5. If the
372 password is supplied as '*', you will be prompted to enter
373 the password when Conky starts.
376 \fB\*(T<\fBimlib_cache_flush_interval\fR\*(T> \fR
377 Interval (in seconds) to flush Imlib2 cache.
380 \fB\*(T<\fBimlib_cache_size\fR\*(T> \fR
381 Imlib2 image cache size, in bytes. Defaults to
382 4MiB. Increase this value if you use $image lots. Set
383 to 0 to disable the image cache.
386 \fB\*(T<\fBlua_draw_hook_post\fR\*(T> \fR\*(T<\fBfunction_name [function arguments]\fR\*(T>
387 This function, if defined, will be called by
388 Conky through each iteration after drawing to the
389 window. Requires X support. Takes any number of
390 optional arguments. Use this hook for drawing things on
391 top of what Conky draws. Conky puts 'conky_' in front
392 of function_name to prevent accidental calls to the
393 wrong function unless you place 'conky_' in front of it
397 \fB\*(T<\fBlua_draw_hook_pre\fR\*(T> \fR\*(T<\fBfunction_name [function arguments]\fR\*(T>
398 This function, if defined, will be called by
399 Conky through each iteration before drawing to the
400 window. Requires X support. Takes any number of
401 optional arguments. Use this hook for drawing things on
402 top of what Conky draws. Conky puts 'conky_' in front
403 of function_name to prevent accidental calls to the
404 wrong function unless you place 'conky_' in front of it
408 \fB\*(T<\fBlua_load\fR\*(T> \fR
409 Loads the Lua scripts separated by spaces.
412 \fB\*(T<\fBlua_shutdown_hook\fR\*(T> \fR\*(T<\fBfunction_name [function arguments]\fR\*(T>
413 This function, if defined, will be called by
414 Conky at shutdown or when the configuration is
415 reloaded. Use this hook to clean up after yourself,
416 such as freeing memory which has been allocated by
417 external libraries via Lua. Conky puts 'conky_' in
418 front of function_name to prevent accidental calls to
419 the wrong function unless you place 'conky_' in
420 front of it yourself.
423 \fB\*(T<\fBlua_startup_hook\fR\*(T> \fR\*(T<\fBfunction_name [function arguments]\fR\*(T>
424 This function, if defined, will be called by
425 Conky at startup or when the configuration is reloaded.
426 Use this hook to initialize values, or for any run-once
427 applications. Conky puts 'conky_' in front of
428 function_name to prevent accidental calls to the wrong
429 function unless you place 'conky_' in front of
433 \fB\*(T<\fBmail_spool\fR\*(T> \fR
434 Mail spool for mail checking
437 \fB\*(T<\fBmax_port_monitor_connections\fR\*(T> \fR
438 Allow each port monitor to track at most this
439 many connections (if 0 or not set, default is 256)
442 \fB\*(T<\fBmax_specials\fR\*(T> \fR
443 Maximum number of special things, e.g. fonts,
444 offsets, aligns, etc. (default is 512)
447 \fB\*(T<\fBmax_text_width\fR\*(T> \fR\*(T<\fBwidth\fR\*(T>
448 When a line in the output contains 'width'
449 chars and the end isn't reached, the next char will start
450 on a new line. If you want to make sure that lines don't
451 get broken, set 'width' to 0
454 \fB\*(T<\fBmax_user_text\fR\*(T> \fR\*(T<\fBbytes\fR\*(T>
455 Maximum size of user text buffer, i.e. layout
456 below TEXT line in config file (default is 16384 bytes)
459 \fB\*(T<\fBmaximum_width\fR\*(T> \fR\*(T<\fBpixels\fR\*(T>
460 Maximum width of window
463 \fB\*(T<\fBminimum_size\fR\*(T> \fR\*(T<\fBwidth (height)\fR\*(T>
464 Minimum size of window
467 \fB\*(T<\fBmpd_host\fR\*(T> \fR
471 \fB\*(T<\fBmpd_password\fR\*(T> \fR
475 \fB\*(T<\fBmpd_port\fR\*(T> \fR
479 \fB\*(T<\fBmusic_player_interval\fR\*(T> \fR
480 Music player thread update interval (defaults to
481 Conky's update interval)
484 \fB\*(T<\fBnet_avg_samples\fR\*(T> \fR
485 The number of samples to average for net data
488 \fB\*(T<\fBno_buffers\fR\*(T> \fR
489 Subtract (file system) buffers from used memory?
492 \fB\*(T<\fBout_to_console\fR\*(T> \fR
493 Print text to stdout.
496 \fB\*(T<\fBout_to_ncurses\fR\*(T> \fR
497 Print text in the console, but use ncurses so
498 that conky can print the text of a new update over the old
499 text. (In the future this will provide more useful things)
502 \fB\*(T<\fBout_to_stderr\fR\*(T> \fR
503 Print text to stderr.
506 \fB\*(T<\fBout_to_x\fR\*(T> \fR
507 When set to no, there will be no output in X
508 (useful when you also use things like out_to_console). If
509 you set it to no, make sure that it's placed before all
510 other X-related setting (take the first line of your
511 configfile to be sure). Default value is yes
514 \fB\*(T<\fBoverride_utf8_locale\fR\*(T> \fR
515 Force UTF8? requires XFT
518 \fB\*(T<\fBoverwrite_file\fR\*(T> \fR
519 Overwrite the file given as argument.
522 \fB\*(T<\fBown_window\fR\*(T> \fR
523 Boolean, create own window to draw?
526 \fB\*(T<\fBown_window_class\fR\*(T> \fR
527 Manually set the WM_CLASS name. Defaults to
531 \fB\*(T<\fBown_window_colour\fR\*(T> \fR\*(T<\fBcolour\fR\*(T>
532 If own_window_transparent no, set a specified
533 background colour (defaults to black). Takes either a hex
534 value (e.g. ffffff, note the lack of '#') or a valid RGB
535 name (see /usr/lib/X11/rgb.txt)
538 \fB\*(T<\fBown_window_hints\fR\*(T> \fR\*(T<\fBundecorated,below,above,sticky,skip_taskbar,skip_pager\fR\*(T>
539 If own_window is yes, you may use these window
540 manager hints to affect the way Conky displays. Notes: Use
541 own_window_type desktop as another way to implement many of
542 these hints implicitly. If you use own_window_type
543 override, window manager hints have no meaning and are
547 \fB\*(T<\fBown_window_title\fR\*(T> \fR
548 Manually set the window name. Defaults to
549 "<hostname> - conky".
552 \fB\*(T<\fBown_window_argb_visual\fR\*(T> \fR
553 Boolean, use ARGB visual? ARGB can be used for real
554 transparency, note that a composite manager is required for real
555 transparency. This option will not work as desired (in most cases)
556 in conjunction with 'own_window_type override'.
559 \fB\*(T<\fBown_window_argb_value\fR\*(T> \fR
560 When ARGB visuals are enabled, this use this to modify the alpha value used. Valid range is 0-255, where 0 is 0% opacity, and 255 is 100% opacity. Note that if own_window_transparent is enabled, this value has no effect.
563 \fB\*(T<\fBown_window_transparent\fR\*(T> \fR
564 Boolean, set transparency? If ARGB visual is enabled, sets
565 background opacity to 0%.
568 \fB\*(T<\fBown_window_type\fR\*(T> \fR
569 if own_window is yes, you may specify type
570 normal, desktop, dock, panel or override (default: normal).
571 Desktop windows are special windows that have no window
572 decorations; are always visible on your desktop; do not
573 appear in your pager or taskbar; and are sticky across all
574 workspaces. Panel windows reserve space along a desktop
575 edge, just like panels and taskbars, preventing maximized
576 windows from overlapping them. The edge is chosen based on
577 the alignment option. Override windows are not under the
578 control of the window manager. Hints are ignored. This type
579 of window can be useful for certain situations.
582 \fB\*(T<\fBpad_percents\fR\*(T> \fR
583 Pad percentages to this many decimals (0 = no
587 \fB\*(T<\fBpop3\fR\*(T> \fR
588 Default global POP3 server. Arguments are: "host
589 user pass [-i interval (in seconds)] [-p port] [-e 'command']
590 [-r retries]". Default port is 110, default interval is 5
591 minutes, and default number of retries before giving up is
592 5. If the password is supplied as '*', you will be prompted
593 to enter the password when Conky starts.
596 \fB\*(T<\fBshort_units\fR\*(T> \fR
597 Shortens units to a single character (kiB->k,
598 GiB->G, etc.). Default is off.
601 \fB\*(T<\fBshow_graph_range\fR\*(T> \fR
602 Shows the time range covered by a graph.
605 \fB\*(T<\fBshow_graph_scale\fR\*(T> \fR
606 Shows the maximum value in scaled graphs.
609 \fB\*(T<\fBstippled_borders\fR\*(T> \fR
610 Border stippling (dashing) in pixels
613 \fB\*(T<\fBtemperature_unit\fR\*(T> \fR
614 Desired output unit of all objects displaying a
615 temperature. Parameters are either "fahrenheit" or
616 "celsius". The default unit is degree Celsius.
619 \fB\*(T<\fBtemplateN\fR\*(T> \fR
620 Define a template for later use inside TEXT
621 segments. Substitute N by a digit between 0 and 9,
622 inclusively. The value of the variable is being inserted
623 into the stuff below TEXT at the corresponding position,
624 but before some substitutions are applied:
628 \&'\e\e' -> backslash
632 \&'\eN' -> template argument N
635 \fB\*(T<\fBtext_buffer_size\fR\*(T> \fR\*(T<\fBbytes\fR\*(T>
636 Size of the standard text buffer (default is 256
637 bytes). This buffer is used for intermediary text, such as
638 individual lines, output from $exec vars, and various other
639 variables. Increasing the size of this buffer can
640 drastically reduce Conky's performance, but will allow for
641 more text display per variable. The size of this buffer
642 cannot be smaller than the default value of 256 bytes.
645 \fB\*(T<\fBtimes_in_seconds\fR\*(T> \fR
646 If true, variables that output times output a number
647 that represents seconds. This doesn't affect $time, $tztime and
651 \fB\*(T<\fBtop_cpu_separate\fR\*(T> \fR
652 If true, cpu in top will show usage of one
653 processor's power. If false, cpu in top will show the usage
654 of all processors' power combined.
657 \fB\*(T<\fBtop_name_width\fR\*(T> \fR
658 Width for $top name value (defaults to 15
662 \fB\*(T<\fBtotal_run_times\fR\*(T> \fR
663 Total number of times for Conky to update before
664 quitting. Zero makes Conky run forever
667 \fB\*(T<\fBupdate_interval\fR\*(T> \fR\*(T<\fBseconds\fR\*(T>
671 \fB\*(T<\fBupdate_interval_on_battery\fR\*(T> \fR\*(T<\fBseconds\fR\*(T>
672 Update interval when running on batterypower
675 \fB\*(T<\fBuppercase\fR\*(T> \fR
676 Boolean value, if true, text is rendered in upper
680 \fB\*(T<\fBuse_spacer\fR\*(T> \fR
681 Adds spaces around certain objects to stop them
682 from moving other things around. Arguments are left, right,
683 and none (default). The old true/false values are
684 deprecated and default to right/none respectively. Note
685 that this only helps if you are using a mono font, such as
686 Bitstream Vera Sans Mono.
689 \fB\*(T<\fBuse_xft\fR\*(T> \fR
690 Use Xft (anti-aliased font and stuff)
693 \fB\*(T<\fBxftalpha\fR\*(T> \fR
694 Alpha of Xft font. Must be a value at or between
698 \fB\*(T<\fBxftfont\fR\*(T> \fR
701 .SH OBJECTS/VARIABLES
702 Colours are parsed using XParsecolor(), there might be a
703 list of them: /usr/share/X11/rgb.txt.
704 Colour can be also in
705 #rrggbb format (hex).
707 Some objects may create threads, and sometimes these threads will
708 not be destroyed until Conky terminates. There is no way to
709 destroy or clean up threads while Conky is running. For example,
710 if you use an MPD variable, the MPD thread will keep running until
711 Conky dies. Some threaded objects will use one of the parameters
712 as a 'key', so that you only have 1 relevant thread running (for
713 example, the $curl, $rss and $weather objects launch one thread per
716 \fB\*(T<\fBacpiacadapter\fR\*(T> \fR\*(T<\fB(adapter)\fR\*(T>
717 ACPI ac adapter state. On linux, the adapter option specifies the
718 subfolder of /sys/class/power_supply containing the state information (defaults
719 to "AC"). Other systems ignore it.
722 \fB\*(T<\fBacpifan\fR\*(T> \fR
726 \fB\*(T<\fBacpitemp\fR\*(T> \fR
727 ACPI temperature in C.
730 \fB\*(T<\fBaddr\fR\*(T> \fR\*(T<\fB(interface)\fR\*(T>
731 IP address for an interface, or "No Address" if
732 no address is assigned.
735 \fB\*(T<\fBaddrs\fR\*(T> \fR\*(T<\fB(interface)\fR\*(T>
736 IP addresses for an interface (if one - works
737 like addr). Linux only.
740 \fB\*(T<\fBadt746xcpu\fR\*(T> \fR
741 CPU temperature from therm_adt746x
744 \fB\*(T<\fBadt746xfan\fR\*(T> \fR
745 Fan speed from therm_adt746x
748 \fB\*(T<\fBalignc\fR\*(T> \fR\*(T<\fB(num)\fR\*(T>
752 \fB\*(T<\fBalignr\fR\*(T> \fR\*(T<\fB(num)\fR\*(T>
753 Right-justify text, with space of N
756 \fB\*(T<\fBapcupsd\fR\*(T> \fR\*(T<\fBhost\fR\*(T> \*(T<\fBport\fR\*(T>
757 Sets up the connection to apcupsd daemon. Prints
758 nothing, defaults to localhost:3551
761 \fB\*(T<\fBapcupsd_cable\fR\*(T> \fR
762 Prints the UPS connection type.
765 \fB\*(T<\fBapcupsd_charge\fR\*(T> \fR
766 Current battery capacity in percent.
769 \fB\*(T<\fBapcupsd_lastxfer\fR\*(T> \fR
770 Reason for last transfer from line to battery.
773 \fB\*(T<\fBapcupsd_linev\fR\*(T> \fR
774 Nominal input voltage.
777 \fB\*(T<\fBapcupsd_load\fR\*(T> \fR
778 Current load in percent.
781 \fB\*(T<\fBapcupsd_loadbar\fR\*(T> \fR
782 Bar showing current load.
785 \fB\*(T<\fBapcupsd_loadgauge\fR\*(T> \fR\*(T<\fB(height),(width)\fR\*(T>
786 Gauge that shows current load.
789 \fB\*(T<\fBapcupsd_loadgraph\fR\*(T> \fR\*(T<\fB(height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
790 History graph of current load.
793 \fB\*(T<\fBapcupsd_model\fR\*(T> \fR
794 Prints the model of the UPS.
797 \fB\*(T<\fBapcupsd_name\fR\*(T> \fR
798 Prints the UPS user-defined name.
801 \fB\*(T<\fBapcupsd_status\fR\*(T> \fR
802 Prints current status (on-line, on-battery).
805 \fB\*(T<\fBapcupsd_temp\fR\*(T> \fR
806 Current internal temperature.
809 \fB\*(T<\fBapcupsd_timeleft\fR\*(T> \fR
810 Time left to run on battery.
813 \fB\*(T<\fBapcupsd_upsmode\fR\*(T> \fR
814 Prints the UPS mode (e.g. standalone).
817 \fB\*(T<\fBapm_adapter\fR\*(T> \fR
818 Display APM AC adapter status (FreeBSD only)
821 \fB\*(T<\fBapm_battery_life\fR\*(T> \fR
822 Display APM battery life in percent (FreeBSD
826 \fB\*(T<\fBapm_battery_time\fR\*(T> \fR
827 Display remaining APM battery life in hh:mm:ss or
828 "unknown" if AC adapterstatus is on-line or charging
832 \fB\*(T<\fBaudacious_bar\fR\*(T> \fR\*(T<\fB(height),(width)\fR\*(T>
836 \fB\*(T<\fBaudacious_bitrate\fR\*(T> \fR
837 Bitrate of current tune
840 \fB\*(T<\fBaudacious_channels\fR\*(T> \fR
841 Number of audio channels of current tune
844 \fB\*(T<\fBaudacious_filename\fR\*(T> \fR
845 Full path and filename of current tune
848 \fB\*(T<\fBaudacious_frequency\fR\*(T> \fR
849 Sampling frequency of current tune
852 \fB\*(T<\fBaudacious_length\fR\*(T> \fR
853 Total length of current tune as MM:SS
856 \fB\*(T<\fBaudacious_length_seconds\fR\*(T> \fR
857 Total length of current tune in seconds
860 \fB\*(T<\fBaudacious_main_volume\fR\*(T> \fR
861 The current volume fetched from Audacious
864 \fB\*(T<\fBaudacious_playlist_length\fR\*(T> \fR
865 Number of tunes in playlist
868 \fB\*(T<\fBaudacious_playlist_position\fR\*(T> \fR
869 Playlist position of current tune
872 \fB\*(T<\fBaudacious_position\fR\*(T> \fR
873 Position of current tune (MM:SS)
876 \fB\*(T<\fBaudacious_position_seconds\fR\*(T> \fR
877 Position of current tune in seconds
880 \fB\*(T<\fBaudacious_status\fR\*(T> \fR
881 Player status (Playing/Paused/Stopped/Not
885 \fB\*(T<\fBaudacious_title\fR\*(T> \fR\*(T<\fB(max length)\fR\*(T>
886 Title of current tune with optional maximum
890 \fB\*(T<\fBbattery\fR\*(T> \fR\*(T<\fB(num)\fR\*(T>
891 Battery status and remaining percentage capacity
892 of ACPI or APM battery. ACPI battery number can be given as
893 argument (default is BAT0).
896 \fB\*(T<\fBbattery_bar\fR\*(T> \fR\*(T<\fB(height),(width) (num)\fR\*(T>
897 Battery percentage remaining of ACPI battery in a
898 bar. ACPI battery number can be given as argument (default
902 \fB\*(T<\fBbattery_percent\fR\*(T> \fR\*(T<\fB(num)\fR\*(T>
903 Battery percentage remaining for ACPI battery.
904 ACPI battery number can be given as argument (default is
908 \fB\*(T<\fBbattery_short\fR\*(T> \fR\*(T<\fB(num)\fR\*(T>
909 Battery status and remaining percentage capacity
910 of ACPI or APM battery. ACPI battery number can be given as
911 argument (default is BAT0). This mode display a short
912 status, which means that C is displayed instead of
913 charging, D for discharging, F for full, N for not present,
914 E for empty and U for unknown.
917 \fB\*(T<\fBbattery_time\fR\*(T> \fR\*(T<\fB(num)\fR\*(T>
918 Battery charge/discharge time remaining of ACPI
919 battery. ACPI battery number can be given as argument
923 \fB\*(T<\fBblink\fR\*(T> \fR\*(T<\fBtext_and_other_conky_vars\fR\*(T>
924 Let 'text_and_other_conky_vars' blink on and off.
927 \fB\*(T<\fBbmpx_album\fR\*(T> \fR
928 Album in current BMPx track
931 \fB\*(T<\fBbmpx_artist\fR\*(T> \fR
932 Artist in current BMPx track
935 \fB\*(T<\fBbmpx_bitrate\fR\*(T> \fR
936 Bitrate of the current BMPx track
939 \fB\*(T<\fBbmpx_title\fR\*(T> \fR
940 Title of the current BMPx track
943 \fB\*(T<\fBbmpx_track\fR\*(T> \fR
944 Track number of the current BMPx track
947 \fB\*(T<\fBbmpx_uri\fR\*(T> \fR
948 URI of the current BMPx track
951 \fB\*(T<\fBbuffers\fR\*(T> \fR
952 Amount of memory buffered
955 \fB\*(T<\fBcached\fR\*(T> \fR
956 Amount of memory cached
959 \fB\*(T<\fBcmdline_to_pid\fR\*(T> \fR\*(T<\fBstring\fR\*(T>
960 PID of the first process that has string in it's
964 \fB\*(T<\fBcolor\fR\*(T> \fR\*(T<\fB(color)\fR\*(T>
965 Change drawing color to 'color' which is a name of
966 a color or a hexcode preceded with # (for example #0A1B2C ).
967 If you use ncurses only the following colors are supported:
968 red,green,yellow,blue,magenta,cyan,black,white.
971 \fB\*(T<\fBcolorN\fR\*(T> \fR
972 Change drawing color to colorN configuration
973 option, where N is a digit between 0 and 9, inclusively.
976 \fB\*(T<\fBcombine\fR\*(T> \fR\*(T<\fBvar1 var2\fR\*(T>
977 Places the lines of var2 to the right of the
978 lines of var1 separated by the chars that are put between
979 var1 and var2. For example: ${combine ${head /proc/cpuinfo
980 2} - ${head /proc/meminfo 1}} gives as output
981 "cpuinfo_line1 - meminfo_line1" on line 1 and
982 "cpuinfo_line2 -" on line 2. $combine vars can also be
983 nested to place more vars next to each other.
986 \fB\*(T<\fBconky_build_arch\fR\*(T> \fR
987 CPU architecture Conky was built for
990 \fB\*(T<\fBconky_build_date\fR\*(T> \fR
994 \fB\*(T<\fBconky_version\fR\*(T> \fR
998 \fB\*(T<\fBcpu\fR\*(T> \fR\*(T<\fB(cpuN)\fR\*(T>
999 CPU usage in percents. For SMP machines, the CPU
1000 number can be provided as an argument. ${cpu cpu0} is the
1001 total usage, and ${cpu cpuX} (X >= 1) are individual
1005 \fB\*(T<\fBcpubar\fR\*(T> \fR\*(T<\fB(cpuN) (height),(width)\fR\*(T>
1006 Bar that shows CPU usage, height is bar's height
1007 in pixels. See $cpu for more info on SMP.
1010 \fB\*(T<\fBcpugauge\fR\*(T> \fR\*(T<\fB(cpuN) (height),(width)\fR\*(T>
1011 Elliptical gauge that shows CPU usage, height and
1012 width are gauge's vertical and horizontal axis
1013 respectively. See $cpu for more info on SMP.
1016 \fB\*(T<\fBcpugraph\fR\*(T> \fR\*(T<\fB(cpuN) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
1017 CPU usage graph, with optional colours in hex,
1018 minus the #. See $cpu for more info on SMP. Uses a
1019 logarithmic scale (to see small numbers) when you use the
1020 -l switch. Takes the switch '-t' to use a temperature
1021 gradient, which makes the gradient values change depending
1022 on the amplitude of a particular graph value (try it and
1026 \fB\*(T<\fBcurl\fR\*(T> \fR\*(T<\fBurl (interval_in_minutes)\fR\*(T>
1027 Download data from URI using Curl at the
1028 specified interval. The interval may be a floating
1029 point value greater than 0, otherwise defaults to 15
1030 minutes. Most useful when used in conjunction with Lua
1031 and the Lua API. This object is threaded, and once a
1032 thread is created it can't be explicitly destroyed.
1033 One thread will run for each URI specified. You can use
1034 any protocol that Curl supports.
1036 \fB\*(T<\fBdesktop\fR\*(T> \fR
1037 Number of the desktop on which conky is running
1038 or the message "Not running in X" if this is the case.
1041 \fB\*(T<\fBdesktop_name\fR\*(T> \fR
1042 Name of the desktop on which conky is running or
1043 the message "Not running in X" if this is the case.
1046 \fB\*(T<\fBdesktop_number\fR\*(T> \fR
1047 Number of desktops or the message "Not running in
1048 X" if this is the case.
1051 \fB\*(T<\fBdisk_protect\fR\*(T> \fR\*(T<\fBdevice\fR\*(T>
1052 Disk protection status, if supported (needs
1053 kernel-patch). Prints either "frozen" or "free " (note the
1057 \fB\*(T<\fBdiskio\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1058 Displays current disk IO. Device is optional, and
1059 takes the form of sda for /dev/sda. Individual partitions
1063 \fB\*(T<\fBdiskio_read\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1064 Displays current disk IO for reads. Device as in
1068 \fB\*(T<\fBdiskio_write\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1069 Displays current disk IO for writes. Device as in
1073 \fB\*(T<\fBdiskiograph\fR\*(T> \fR\*(T<\fB(device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
1074 Disk IO graph, colours defined in hex, minus the
1075 #. If scale is non-zero, it becomes the scale for the
1076 graph. Uses a logarithmic scale (to see small numbers) when
1077 you use -l switch. Takes the switch '-t' to use a
1078 temperature gradient, which makes the gradient values
1079 change depending on the amplitude of a particular graph
1080 value (try it and see).
1083 \fB\*(T<\fBdiskiograph_read\fR\*(T> \fR\*(T<\fB(device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
1084 Disk IO graph for reads, colours defined in hex,
1085 minus the #. If scale is non-zero, it becomes the scale for
1086 the graph. Device as in diskio. Uses a logarithmic scale
1087 (to see small numbers) when you use -l switch. Takes the
1088 switch '-t' to use a temperature gradient, which makes the
1089 gradient values change depending on the amplitude of a
1090 particular graph value (try it and see).
1093 \fB\*(T<\fBdiskiograph_write\fR\*(T> \fR\*(T<\fB(device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
1094 Disk IO graph for writes, colours defined in hex,
1095 minus the #. If scale is non-zero, it becomes the scale for
1096 the graph. Device as in diskio. Uses a logarithmic scale
1097 (to see small numbers) when you use -l switch. Takes the
1098 switch '-t' to use a temperature gradient, which makes the
1099 gradient values change depending on the amplitude of a
1100 particular graph value (try it and see).
1103 \fB\*(T<\fBdownspeed\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
1104 Download speed in suitable IEC units
1107 \fB\*(T<\fBdownspeedf\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
1108 Download speed in KiB with one decimal
1111 \fB\*(T<\fBdownspeedgraph\fR\*(T> \fR\*(T<\fB(netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
1112 Download speed graph, colours defined in hex,
1113 minus the #. If scale is non-zero, it becomes the scale for
1114 the graph. Uses a logarithmic scale (to see small numbers)
1115 when you use -l switch. Takes the switch '-t' to use a
1116 temperature gradient, which makes the gradient values
1117 change depending on the amplitude of a particular graph
1118 value (try it and see).
1121 \fB\*(T<\fBdraft_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
1122 Number of mails marked as draft in the specified
1123 mailbox or mail spool if not. Only maildir type mailboxes
1124 are supported, mbox type will return -1.
1127 \fB\*(T<\fBelse\fR\*(T> \fR
1128 Text to show if any of the above are not true
1131 \fB\*(T<\fBendif\fR\*(T> \fR
1135 \fB\*(T<\fBentropy_avail\fR\*(T> \fR
1136 Current entropy available for crypto freaks
1139 \fB\*(T<\fBentropy_bar\fR\*(T> \fR\*(T<\fB(height),(width)\fR\*(T>
1140 Normalized bar of available entropy for crypto
1144 \fB\*(T<\fBentropy_perc\fR\*(T> \fR
1145 Percentage of entropy available in comparison to
1149 \fB\*(T<\fBentropy_poolsize\fR\*(T> \fR
1150 Total size of system entropy pool for crypto
1154 \fB\*(T<\fBeval\fR\*(T> \fR\*(T<\fBstring\fR\*(T>
1155 Evaluates given string according to the rules of
1156 TEXT interpretation, i.e. parsing any contained text object
1157 specifications into their output, any occuring '$$' into a
1158 single '$' and so on. The output is then being parsed
1162 \fB\*(T<\fBeve\fR\*(T> \fR\*(T<\fBapi_userid api_key character_id\fR\*(T>
1163 Fetches your currently training skill from the
1164 Eve Online API servers (http://www.eve-online.com/) and
1165 displays the skill along with the remaining training time.
1168 \fB\*(T<\fBexec\fR\*(T> \fR\*(T<\fBcommand\fR\*(T>
1169 Executes a shell command and displays the output
1170 in conky. warning: this takes a lot more resources than
1171 other variables. I'd recommend coding wanted behaviour in C
1172 and posting a patch.
1175 \fB\*(T<\fBexecbar\fR\*(T> \fR\*(T<\fBcommand\fR\*(T>
1176 Same as exec, except if the first value return is
1177 a value between 0-100, it will use that number for a bar.
1178 The size for bars can be controlled via the
1179 default_bar_size config setting.
1182 \fB\*(T<\fBexecgauge\fR\*(T> \fR\*(T<\fBcommand\fR\*(T>
1183 Same as exec, except if the first value returned
1184 is a value between 0-100, it will use that number for a
1185 gauge. The size for gauges can be controlled via the
1186 default_gauge_size config setting.
1189 \fB\*(T<\fBexecgraph\fR\*(T> \fR\*(T<\fB(\-t) (\-l) command\fR\*(T>
1190 Same as execbar, but graphs values. Uses a
1191 logaritmic scale when the log option (-l switch) is given
1192 (to see small numbers). Values still have to be between 0
1193 and 100. The size for graphs can be controlled via the
1194 default_graph_size config setting. Takes the switch '-t' to
1195 use a temperature gradient, which makes the gradient values
1196 change depending on the amplitude of a particular graph
1197 value (try it and see). If -t or -l is your first argument,
1198 you may need to preceed it by a space (' ').
1201 \fB\*(T<\fBexeci\fR\*(T> \fR\*(T<\fBinterval command\fR\*(T>
1202 Same as exec but with specific interval. Interval
1203 can't be less than update_interval in configuration. See
1207 \fB\*(T<\fBexecibar\fR\*(T> \fR\*(T<\fBinterval command\fR\*(T>
1208 Same as execbar, except with an interval
1211 \fB\*(T<\fBexecigauge\fR\*(T> \fR\*(T<\fBinterval command\fR\*(T>
1212 Same as execgauge, but takes an interval arg and
1216 \fB\*(T<\fBexecigraph\fR\*(T> \fR\*(T<\fBinterval (\-t) (\-l) command\fR\*(T>
1217 Same as execgraph, but takes an interval arg and
1218 graphs values. If -t or -l is your first argument, you may
1219 need to preceed it by a space (' ').
1222 \fB\*(T<\fBexecp\fR\*(T> \fR\*(T<\fBcommand\fR\*(T>
1223 Executes a shell command and displays the output
1224 in conky. warning: this takes a lot more resources than
1225 other variables. I'd recommend coding wanted behaviour in C
1226 and posting a patch. This differs from $exec in that it
1227 parses the output of the command, so you can insert things
1228 like ${color red}hi!${color} in your script and have it
1229 correctly parsed by Conky. Caveats: Conky parses and
1230 evaluates the output of $execp every time Conky loops, and
1231 then destroys all the objects. If you try to use anything
1232 like $execi within an $execp statement, it will
1233 functionally run at the same interval that the $execp
1234 statement runs, as it is created and destroyed at every
1238 \fB\*(T<\fBexecpi\fR\*(T> \fR\*(T<\fBinterval command\fR\*(T>
1239 Same as execp but with specific interval.
1240 Interval can't be less than update_interval in
1241 configuration. Note that the output from the $execpi
1242 command is still parsed and evaluated at every interval.
1245 \fB\*(T<\fBflagged_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
1246 Number of mails marked as flagged in the
1247 specified mailbox or mail spool if not. Only maildir type
1248 mailboxes are supported, mbox type will return -1.
1251 \fB\*(T<\fBfont\fR\*(T> \fR\*(T<\fB(font)\fR\*(T>
1252 Specify a different font. This new font will
1253 apply to the current line and everything following. You can
1254 use a $font with no arguments to change back to the default
1255 font (much like with $color)
1258 \fB\*(T<\fBformat_time\fR\*(T> \fR\*(T<\fBseconds format\fR\*(T>
1259 Format time given in seconds. This var only works when
1260 the times_in_seconds configuration setting is on. Format is a string
1261 that should start and end with a "-char. The "-chars are not
1262 part of the output, \ew,\ed,\eh,\em,\es,\e(,\e) and \e\e are replaced by
1263 weeks,days,hours,minutes,seconds,(,) and \e. If you leave out a unit,
1264 it's value will be expressed in the highest unite lower then the
1265 one left out. Text between ()-chars will not be visible if a
1266 replaced unit in this text is 0. If seconds is a decimal number
1267 then you can see the numbers behind the point by using \eS
1268 followed by a number that specifies the amount of
1269 digits behind the point that you want to see (maximum 9).
1270 You can also place a 'x' behind \eS so you have all digits behind
1271 the point and no trailing zero's. (also maximum 9)
1274 \fB\*(T<\fBforwarded_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
1275 Number of mails marked as forwarded in the
1276 specified mailbox or mail spool if not. Only maildir type
1277 mailboxes are supported, mbox type will return -1.
1280 \fB\*(T<\fBfreq\fR\*(T> \fR\*(T<\fB(n)\fR\*(T>
1281 Returns CPU #n's frequency in MHz. CPUs are
1282 counted from 1. If omitted, the parameter defaults to 1.
1285 \fB\*(T<\fBfreq_g\fR\*(T> \fR\*(T<\fB(n)\fR\*(T>
1286 Returns CPU #n's frequency in GHz. CPUs are
1287 counted from 1. If omitted, the parameter defaults to 1.
1290 \fB\*(T<\fBfs_bar\fR\*(T> \fR\*(T<\fB(height),(width) fs\fR\*(T>
1291 Bar that shows how much space is used on a file
1292 system. height is the height in pixels. fs is any file on
1296 \fB\*(T<\fBfs_bar_free\fR\*(T> \fR\*(T<\fB(height),(width) fs\fR\*(T>
1297 Bar that shows how much space is free on a file
1298 system. height is the height in pixels. fs is any file on
1302 \fB\*(T<\fBfs_free\fR\*(T> \fR\*(T<\fB(fs)\fR\*(T>
1303 Free space on a file system available for users.
1306 \fB\*(T<\fBfs_free_perc\fR\*(T> \fR\*(T<\fB(fs)\fR\*(T>
1307 Free percentage of space on a file system
1308 available for users.
1311 \fB\*(T<\fBfs_size\fR\*(T> \fR\*(T<\fB(fs)\fR\*(T>
1315 \fB\*(T<\fBfs_type\fR\*(T> \fR\*(T<\fB(fs)\fR\*(T>
1319 \fB\*(T<\fBfs_used\fR\*(T> \fR\*(T<\fB(fs)\fR\*(T>
1320 File system used space.
1323 \fB\*(T<\fBfs_used_perc\fR\*(T> \fR\*(T<\fB(fs)\fR\*(T>
1324 Percent of file system used space.
1327 \fB\*(T<\fBgoto\fR\*(T> \fR\*(T<\fBx\fR\*(T>
1328 The next element will be printed at position 'x'.
1331 \fB\*(T<\fBgw_iface\fR\*(T> \fR
1332 Displays the default route's interface or
1333 "multiple"/"none" accordingly.
1336 \fB\*(T<\fBgw_ip\fR\*(T> \fR
1337 Displays the default gateway's IP or
1338 "multiple"/"none" accordingly.
1341 \fB\*(T<\fBhddtemp\fR\*(T> \fR\*(T<\fB(dev)\fR\*(T>
1342 Displays temperature of a selected hard disk
1343 drive as reported by the hddtemp daemon. Use hddtemp_host
1344 and hddtemp_port to specify a host and port for all hddtemp
1345 objects. If no dev parameter is given, the first disk returned
1346 by the hddtemp daemon is used.
1349 \fB\*(T<\fBhead\fR\*(T> \fR\*(T<\fBlogfile lines (next_check)\fR\*(T>
1350 Displays first N lines of supplied text file. The
1351 file is checked every 'next_check' update. If next_check is
1352 not supplied, Conky defaults to 2. Max of 30 lines can be
1353 displayed, or until the text buffer is filled.
1356 \fB\*(T<\fBhr\fR\*(T> \fR\*(T<\fB(height)\fR\*(T>
1357 Horizontal line, height is the height in pixels
1360 \fB\*(T<\fBhwmon\fR\*(T> \fR\*(T<\fB(dev) type n (factor offset)\fR\*(T>
1361 Hwmon sensor from sysfs (Linux 2.6). Parameter
1362 dev may be omitted if you have only one hwmon device.
1363 Parameter type is either 'in' or 'vol' meaning voltage;
1364 \&'fan' meaning fan; 'temp' meaning temperature. Parameter n
1365 is number of the sensor. See /sys/class/hwmon/ on your
1366 local computer. The optional arguments 'factor' and
1367 \&'offset' allow precalculation of the raw input, which is
1368 being modified as follows: 'input = input * factor +
1369 offset'. Note that they have to be given as decimal values
1370 (i.e. contain at least one decimal place).
1373 \fB\*(T<\fBi2c\fR\*(T> \fR\*(T<\fB(dev) type n (factor offset)\fR\*(T>
1374 I2C sensor from sysfs (Linux 2.6). Parameter dev
1375 may be omitted if you have only one I2C device. Parameter
1376 type is either 'in' or 'vol' meaning voltage; 'fan' meaning
1377 fan; 'temp' meaning temperature. Parameter n is number of
1378 the sensor. See /sys/bus/i2c/devices/ on your local
1379 computer. The optional arguments 'factor' and 'offset'
1380 allow precalculation of the raw input, which is being
1381 modified as follows: 'input = input * factor + offset'.
1382 Note that they have to be given as decimal values (i.e.
1383 contain at least one decimal place).
1386 \fB\*(T<\fBi8k_ac_status\fR\*(T> \fR
1387 If running the i8k kernel driver for Inspiron
1388 laptops, displays whether ac power is on, as listed in
1389 /proc/i8k (translated to human-readable). Beware that this
1390 is by default not enabled by i8k itself.
1393 \fB\*(T<\fBi8k_bios\fR\*(T> \fR
1394 If running the i8k kernel driver for Inspiron
1395 laptops, displays the bios version as listed in /proc/i8k.
1398 \fB\*(T<\fBi8k_buttons_status\fR\*(T> \fR
1399 If running the i8k kernel driver for Inspiron
1400 laptops, displays the volume buttons status as listed in
1404 \fB\*(T<\fBi8k_cpu_temp\fR\*(T> \fR
1405 If running the i8k kernel driver for Inspiron
1406 laptops, displays the cpu temperature in Celsius, as
1407 reported by /proc/i8k.
1410 \fB\*(T<\fBi8k_left_fan_rpm\fR\*(T> \fR
1411 If running the i8k kernel driver for Inspiron
1412 laptops, displays the left fan's rate of rotation, in
1413 revolutions per minute as listed in /proc/i8k. Beware, some
1414 laptops i8k reports these fans in reverse order.
1417 \fB\*(T<\fBi8k_left_fan_status\fR\*(T> \fR
1418 If running the i8k kernel driver for Inspiron
1419 laptops, displays the left fan status as listed in
1420 /proc/i8k (translated to human-readable). Beware, some
1421 laptops i8k reports these fans in reverse order.
1424 \fB\*(T<\fBi8k_right_fan_rpm\fR\*(T> \fR
1425 If running the i8k kernel driver for Inspiron
1426 laptops, displays the right fan's rate of rotation, in
1427 revolutions per minute as listed in /proc/i8k. Beware, some
1428 laptops i8k reports these fans in reverse order.
1431 \fB\*(T<\fBi8k_right_fan_status\fR\*(T> \fR
1432 If running the i8k kernel driver for Inspiron
1433 laptops, displays the right fan status as listed in
1434 /proc/i8k (translated to human-readable). Beware, some
1435 laptops i8k reports these fans in reverse order.
1438 \fB\*(T<\fBi8k_serial\fR\*(T> \fR
1439 If running the i8k kernel driver for Inspiron
1440 laptops, displays your laptop serial number as listed in
1444 \fB\*(T<\fBi8k_version\fR\*(T> \fR
1445 If running the i8k kernel driver for Inspiron
1446 laptops, displays the version formatting of /proc/i8k.
1449 \fB\*(T<\fBibm_brightness\fR\*(T> \fR
1450 If running the IBM ACPI, displays the brigtness
1451 of the laptops's LCD (0-7).
1454 \fB\*(T<\fBibm_fan\fR\*(T> \fR
1455 If running the IBM ACPI, displays the fan speed.
1458 \fB\*(T<\fBibm_temps\fR\*(T> \fR\*(T<\fBN\fR\*(T>
1459 If running the IBM ACPI, displays the
1460 temperatures from the IBM temperature sensors (N=0..7)
1461 Sensor 0 is on the CPU, 3 is on the GPU.
1464 \fB\*(T<\fBibm_volume\fR\*(T> \fR
1465 If running the IBM ACPI, displays the "master"
1466 volume, controlled by the volume keys (0-14).
1469 \fB\*(T<\fBiconv_start\fR\*(T> \fR\*(T<\fBcodeset_from codeset_to\fR\*(T>
1470 Convert text from one codeset to another using
1471 GNU iconv. Needs to be stopped with iconv_stop.
1474 \fB\*(T<\fBiconv_stop\fR\*(T> \fR
1475 Stop iconv codeset conversion.
1478 \fB\*(T<\fBif_empty\fR\*(T> \fR\*(T<\fB(var)\fR\*(T>
1479 if conky variable VAR is empty, display
1480 everything between $if_empty and the matching $endif
1483 \fB\*(T<\fBif_existing\fR\*(T> \fR\*(T<\fBfile (string)\fR\*(T>
1484 if FILE exists, display everything between
1485 if_existing and the matching $endif. The optional second
1486 paramater checks for FILE containing the specified string
1487 and prints everything between $if_existing and the matching
1491 \fB\*(T<\fBif_gw\fR\*(T> \fR
1492 if there is at least one default gateway, display
1493 everything between $if_gw and the matching $endif
1496 \fB\*(T<\fBif_match\fR\*(T> \fR\*(T<\fBexpression\fR\*(T>
1497 Evaluates the given boolean expression, printing
1498 everything between $if_match and the matching $endif
1499 depending on whether the evaluation returns true or not.
1500 Valid expressions consist of a left side, an operator and a
1501 right side. Left and right sides are being parsed for
1502 contained text objects before evaluation. Recognised left
1503 and right side types are:
1505 \fBdouble\fRArgument consists of only
1506 digits and a single dot.
1508 \fBlong\fRArgument consists of only
1511 \fBstring\fRArgument is enclosed in
1514 Valid operands are: '>', '<', '>=',
1518 \fB\*(T<\fBif_mixer_mute\fR\*(T> \fR\*(T<\fB(mixer)\fR\*(T>
1519 If mixer exists, display everything between
1520 $if_mixer_mute and the matching $endif. If no mixer is
1521 specified, "Master" is used.
1524 \fB\*(T<\fBif_mounted\fR\*(T> \fR\*(T<\fB(mountpoint)\fR\*(T>
1525 if MOUNTPOINT is mounted, display everything
1526 between $if_mounted and the matching $endif
1529 \fB\*(T<\fBif_mpd_playing\fR\*(T> \fR
1530 if mpd is playing or paused, display everything
1531 between $if_mpd_playing and the matching $endif
1534 \fB\*(T<\fBif_running\fR\*(T> \fR\*(T<\fB(process)\fR\*(T>
1535 if PROCESS is running, display everything
1536 $if_running and the matching $endif. This uses the
1537 ``pidof'' command, so the -x switch is also supported.
1540 \fB\*(T<\fBif_smapi_bat_installed\fR\*(T> \fR\*(T<\fB(INDEX)\fR\*(T>
1541 when using smapi, if the battery with index INDEX
1542 is installed, display everything between
1543 $if_smapi_bat_installed and the matching $endif
1546 \fB\*(T<\fBif_up\fR\*(T> \fR\*(T<\fB(interface)\fR\*(T>
1547 if INTERFACE exists and is up, display everything
1548 between $if_up and the matching $endif
1551 \fB\*(T<\fBif_updatenr\fR\*(T> \fR\*(T<\fB(updatenr)\fR\*(T>
1552 If it's the UPDATENR-th time that conky updates,
1553 display everything between $if_updatenr and the matching
1554 $endif. The counter resets when the highest UPDATENR is
1555 reached. Example : "{$if_updatenr 1}foo$endif{$if_updatenr
1556 2}bar$endif{$if_updatenr 4}$endif" shows foo 25% of the
1557 time followed by bar 25% of the time followed by nothing
1558 the other half of the time.
1561 \fB\*(T<\fBif_xmms2_connected\fR\*(T> \fR
1562 Display everything between $if_xmms2_connected
1563 and the matching $endif if xmms2 is running.
1566 \fB\*(T<\fBimage\fR\*(T> \fR\*(T<\fB<path to image> (\-p x,y) (\-s WxH) (\-n) (\-f interval)\fR\*(T>
1567 Renders an image from the path specified using
1568 Imlib2. Takes 4 optional arguments: a position, a size, a
1569 no-cache switch, and a cache flush interval. Changing the
1570 x,y position will move the position of the image, and
1571 changing the WxH will scale the image. If you specify the
1572 no-cache flag (-n), the image will not be cached.
1573 Alternately, you can specify the -f int switch to specify a
1574 cache flust interval for a particular image. Example:
1575 ${image /home/brenden/cheeseburger.jpg -p 20,20 -s 200x200}
1576 will render 'cheeseburger.jpg' at (20,20) scaled to 200x200
1577 pixels. Conky does not make any attempt to adjust the
1578 position (or any other formatting) of images, they are just
1579 rendered as per the arguments passed. The only reason
1580 $image is part of the TEXT section, is to allow for runtime
1581 modifications, through $execp $lua_parse, or some other
1585 \fB\*(T<\fBimap_messages\fR\*(T> \fR\*(T<\fB(args)\fR\*(T>
1586 Displays the number of messages in your global
1587 IMAP inbox by default. You can define individual IMAP
1588 inboxes separately by passing arguments to this object.
1589 Arguments are: "host user pass [-i interval (in seconds)]
1590 [-f 'folder'] [-p port] [-e 'command'] [-r retries]". Default
1591 port is 143, default folder is 'INBOX', default interval is
1592 5 minutes, and default number of retries before giving up
1593 is 5. If the password is supplied as '*', you will be
1594 prompted to enter the password when Conky starts.
1597 \fB\*(T<\fBimap_unseen\fR\*(T> \fR\*(T<\fB(args)\fR\*(T>
1598 Displays the number of unseen messages in your
1599 global IMAP inbox by default. You can define individual
1600 IMAP inboxes separately by passing arguments to this
1601 object. Arguments are: "host user pass [-i interval (in
1602 seconds)] [-f 'folder'] [-p port] [-e 'command'] [-r retries]".
1603 Default port is 143, default folder is 'INBOX', default
1604 interval is 5 minutes, and default number of retries before
1605 giving up is 5. If the password is supplied as '*', you
1606 will be prompted to enter the password when Conky starts.
1609 \fB\*(T<\fBinclude\fR\*(T> \fR\*(T<\fBpath\fR\*(T>
1610 Loads the configfile at path, places the
1611 configsettings behind the configsettings in the orginal
1612 config and places the vars where the includevar
1615 \fB\*(T<\fBioscheduler\fR\*(T> \fR\*(T<\fBdisk\fR\*(T>
1616 Prints the current ioscheduler used for the given
1617 disk name (i.e. e.g. "hda" or "sdb")
1620 \fB\*(T<\fBkernel\fR\*(T> \fR
1624 \fB\*(T<\fBlaptop_mode\fR\*(T> \fR
1625 The value of /proc/sys/vm/laptop_mode
1628 \fB\*(T<\fBlines\fR\*(T> \fR\*(T<\fBtextfile\fR\*(T>
1629 Displays the number of lines in the given file
1632 \fB\*(T<\fBloadavg\fR\*(T> \fR\*(T<\fB(1|2|3)\fR\*(T>
1633 System load average, 1 is for past 1 minute, 2
1634 for past 5 minutes and 3 for past 15 minutes. Without argument, prints
1635 all three values separated by whitespace.
1638 \fB\*(T<\fBloadgraph\fR\*(T> \fR\*(T<\fB(height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
1639 Load1 average graph, similar to xload, with
1640 optional colours in hex, minus the #. Uses a logarithmic
1641 scale (to see small numbers) when you use the -l switch.
1642 Takes the switch '-t' to use a temperature gradient, which
1643 makes the gradient values change depending on the amplitude
1644 of a particular graph value (try it and see).
1647 \fB\*(T<\fBlua\fR\*(T> \fR\*(T<\fBfunction_name (function parameters)\fR\*(T>
1648 Executes a Lua function with given parameters,
1649 then prints the returned string. See also 'lua_load' on how
1650 to load scripts. Conky puts 'conky_' in front of
1651 function_name to prevent accidental calls to the wrong
1652 function unless you put you place 'conky_' in front of it
1656 \fB\*(T<\fBlua_bar\fR\*(T> \fR\*(T<\fB(height, width) function_name (function parameters)\fR\*(T>
1657 Executes a Lua function with given parameters and
1658 draws a bar. Expects result value to be an integer between
1659 0 and 100. See also 'lua_load' on how to load scripts.
1660 Conky puts 'conky_' in front of function_name to prevent
1661 accidental calls to the wrong function unless you put you
1662 place 'conky_' in front of it yourself.
1665 \fB\*(T<\fBlua_gauge\fR\*(T> \fR\*(T<\fB(height, width) function_name (function parameters)\fR\*(T>
1666 Executes a Lua function with given parameters and
1667 draws a gauge. Expects result value to be an integer
1668 between 0 and 100. See also 'lua_load' on how to load
1669 scripts. Conky puts 'conky_' in front of function_name to
1670 prevent accidental calls to the wrong function unless you
1671 put you place 'conky_' in front of it yourself.
1674 \fB\*(T<\fBlua_graph\fR\*(T> \fR\*(T<\fBfunction_name (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
1675 Executes a Lua function with and draws a graph.
1676 Expects result value to be any number, and by default will
1677 scale to show the full range. See also 'lua_load' on how to
1678 load scripts. Takes the switch '-t' to use a temperature
1679 gradient, which makes the gradient values change depending
1680 on the amplitude of a particular graph value (try it and
1681 see). Conky puts 'conky_' in front of function_name to
1682 prevent accidental calls to the wrong function unless you
1683 put you place 'conky_' in front of it yourself.
1686 \fB\*(T<\fBlua_parse\fR\*(T> \fR\*(T<\fBfunction_name (function parameters)\fR\*(T>
1687 Executes a Lua function with given parameters as
1688 per $lua, then parses and prints the result value as per
1689 the syntax for Conky's TEXT section. See also 'lua_load' on
1690 how to load scripts. Conky puts 'conky_' in front of
1691 function_name to prevent accidental calls to the wrong
1692 function unless you put you place 'conky_' in front of it
1696 \fB\*(T<\fBmachine\fR\*(T> \fR
1697 Machine, i686 for example
1700 \fB\*(T<\fBmails\fR\*(T> \fR\*(T<\fB(mailbox)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
1701 Mail count in the specified mailbox or your mail
1702 spool if not. Both mbox and maildir type mailboxes are
1703 supported. You can use a program like fetchmail to get
1704 mails from some server using your favourite protocol. See
1708 \fB\*(T<\fBmboxscan\fR\*(T> \fR\*(T<\fB(\-n number of messages to print) (\-fw from width) (\-sw subject width) mbox\fR\*(T>
1709 Print a summary of recent messages in an mbox
1710 format mailbox. mbox parameter is the filename of the
1711 mailbox (can be encapsulated using '"', ie. ${mboxscan -n
1712 10 "/home/brenden/some box"}
1715 \fB\*(T<\fBmem\fR\*(T> \fR
1716 Amount of memory in use
1719 \fB\*(T<\fBmembar\fR\*(T> \fR\*(T<\fB(height),(width)\fR\*(T>
1720 Bar that shows amount of memory in use
1723 \fB\*(T<\fBmemeasyfree\fR\*(T> \fR
1724 Amount of free memory including the memory that
1725 is very easily freed (buffers/cache)
1728 \fB\*(T<\fBmemfree\fR\*(T> \fR
1729 Amount of free memory
1732 \fB\*(T<\fBmemgauge\fR\*(T> \fR\*(T<\fB(height),(width)\fR\*(T>
1733 Gauge that shows amount of memory in use (see
1737 \fB\*(T<\fBmemgraph\fR\*(T> \fR\*(T<\fB(height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
1738 Memory usage graph. Uses a logarithmic scale (to
1739 see small numbers) when you use the -l switch. Takes the
1740 switch '-t' to use a temperature gradient, which makes the
1741 gradient values change depending on the amplitude of a
1742 particular graph value (try it and see).
1745 \fB\*(T<\fBmemmax\fR\*(T> \fR
1746 Total amount of memory
1749 \fB\*(T<\fBmemperc\fR\*(T> \fR
1750 Percentage of memory in use
1753 \fB\*(T<\fBmixer\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1754 Prints the mixer value as reported by the OS.
1755 Default mixer is "Master", but you can specify one of the
1756 available ALSA Simple mixer controls.
1757 You can find the list of those available on your system
1761 \fB\*(T<\fBmixerbar\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1762 Displays mixer value in a bar as reported by the
1763 OS. See docs for $mixer for details on arguments.
1766 \fB\*(T<\fBmixerl\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1767 Prints the left channel mixer value as reported
1768 by the OS. See docs for $mixer for details on arguments.
1771 \fB\*(T<\fBmixerlbar\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1772 Displays the left channel mixer value in a bar as
1773 reported by the OS. See docs for $mixer for details on
1777 \fB\*(T<\fBmixerr\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1778 Prints the right channel mixer value as reported
1779 by the OS. See docs for $mixer for details on arguments.
1782 \fB\*(T<\fBmixerrbar\fR\*(T> \fR\*(T<\fB(device)\fR\*(T>
1783 Displays the right channel mixer value in a bar
1784 as reported by the OS. See docs for $mixer for details on
1788 \fB\*(T<\fBmoc_album\fR\*(T> \fR
1789 Album of the current MOC song
1792 \fB\*(T<\fBmoc_artist\fR\*(T> \fR
1793 Artist of the current MOC song
1796 \fB\*(T<\fBmoc_bitrate\fR\*(T> \fR
1797 Bitrate in the current MOC song
1800 \fB\*(T<\fBmoc_curtime\fR\*(T> \fR
1801 Current time of the current MOC song
1804 \fB\*(T<\fBmoc_file\fR\*(T> \fR
1805 File name of the current MOC song
1808 \fB\*(T<\fBmoc_rate\fR\*(T> \fR
1809 Rate of the current MOC song
1812 \fB\*(T<\fBmoc_song\fR\*(T> \fR
1813 The current song name being played in MOC.
1816 \fB\*(T<\fBmoc_state\fR\*(T> \fR
1817 Current state of MOC; playing, stopped etc.
1820 \fB\*(T<\fBmoc_timeleft\fR\*(T> \fR
1821 Time left in the current MOC song
1824 \fB\*(T<\fBmoc_title\fR\*(T> \fR
1825 Title of the current MOC song
1828 \fB\*(T<\fBmoc_totaltime\fR\*(T> \fR
1829 Total length of the current MOC song
1832 \fB\*(T<\fBmonitor\fR\*(T> \fR
1833 Number of the monitor on which conky is running
1834 or the message "Not running in X" if this is the case.
1837 \fB\*(T<\fBmonitor_number\fR\*(T> \fR
1838 Number of monitors or the message "Not running in
1839 X" if this is the case.
1842 \fB\*(T<\fBmpd_album\fR\*(T> \fR
1843 Album in current MPD song
1846 \fB\*(T<\fBmpd_artist\fR\*(T> \fR
1847 Artist in current MPD song must be enabled at
1851 \fB\*(T<\fBmpd_bar\fR\*(T> \fR\*(T<\fB(height),(width)\fR\*(T>
1852 Bar of mpd's progress
1855 \fB\*(T<\fBmpd_bitrate\fR\*(T> \fR
1856 Bitrate of current song
1859 \fB\*(T<\fBmpd_elapsed\fR\*(T> \fR
1863 \fB\*(T<\fBmpd_file\fR\*(T> \fR
1864 Prints the file name of the current MPD song
1867 \fB\*(T<\fBmpd_length\fR\*(T> \fR
1871 \fB\*(T<\fBmpd_name\fR\*(T> \fR
1872 Prints the MPD name field
1875 \fB\*(T<\fBmpd_percent\fR\*(T> \fR
1876 Percent of song's progress
1879 \fB\*(T<\fBmpd_random\fR\*(T> \fR
1880 Random status (On/Off)
1883 \fB\*(T<\fBmpd_repeat\fR\*(T> \fR
1884 Repeat status (On/Off)
1887 \fB\*(T<\fBmpd_smart\fR\*(T> \fR\*(T<\fB(max length)\fR\*(T>
1888 Prints the song name in either the form "artist -
1889 title" or file name, depending on whats available
1892 \fB\*(T<\fBmpd_status\fR\*(T> \fR
1893 Playing, stopped, et cetera.
1896 \fB\*(T<\fBmpd_title\fR\*(T> \fR\*(T<\fB(max length)\fR\*(T>
1897 Title of current MPD song
1900 \fB\*(T<\fBmpd_track\fR\*(T> \fR
1901 Prints the MPD track field
1904 \fB\*(T<\fBmpd_vol\fR\*(T> \fR
1908 \fB\*(T<\fBnameserver\fR\*(T> \fR\*(T<\fB(index)\fR\*(T>
1909 Print a nameserver from /etc/resolv.conf. Index
1910 starts at and defaults to 0.
1913 \fB\*(T<\fBnew_mails\fR\*(T> \fR\*(T<\fB(mailbox)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
1914 Unread mail count in the specified mailbox or
1915 mail spool if not. Both mbox and maildir type mailboxes are
1919 \fB\*(T<\fBnodename\fR\*(T> \fR
1923 \fB\*(T<\fBnvidia\fR\*(T> \fR\*(T<\fBthreshold\fR\*(T> \*(T<\fBtemp\fR\*(T> \*(T<\fBambient\fR\*(T> \*(T<\fBgpufreq\fR\*(T> \*(T<\fBmemfreq\fR\*(T> \*(T<\fBimagequality\fR\*(T>
1924 Nvidia graficcard support for the XNVCtrl
1925 library. Each option can be shortened to the least
1926 significant part. Temperatures are printed as float, all
1927 other values as integer.
1930 \*(T<\fBThe thresholdtemperature at
1931 which the gpu slows down\fR\*(T>
1934 \*(T<\fBGives the gpu current
1938 \*(T<\fBGives current air temperature near GPU
1942 \*(T<\fBGives the current gpu frequency\fR\*(T>
1945 \*(T<\fBGives the current mem frequency\fR\*(T>
1948 \*(T<\fBWhich imagequality should be chosen by
1949 OpenGL applications\fR\*(T>
1952 \fB\*(T<\fBoffset\fR\*(T> \fR\*(T<\fB(pixels)\fR\*(T>
1953 Move text over by N pixels. See also $voffset.
1956 \fB\*(T<\fBoutlinecolor\fR\*(T> \fR\*(T<\fB(color)\fR\*(T>
1957 Change outline color
1960 \fB\*(T<\fBpb_battery\fR\*(T> \fR\*(T<\fBitem\fR\*(T>
1961 If running on Apple powerbook/ibook, display
1962 information on battery status. The item parameter
1963 specifies, what information to display. Exactly one item
1964 must be specified. Valid items are:
1967 \*(T<\fBDisplay if battery is fully charged,
1968 charging, discharging or absent (running on
1972 \*(T<\fBDisplay charge of battery in percent, if
1973 charging or discharging. Nothing will be displayed,
1974 if battery is fully charged or absent.\fR\*(T>
1977 \*(T<\fBDisplay the time remaining until the
1978 battery will be fully charged or discharged at
1979 current rate. Nothing is displayed, if battery is
1980 absent or if it's present but fully charged and not
1981 discharging.\fR\*(T>
1984 \fB\*(T<\fBpid_chroot\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
1985 Directory used as rootdirectory by the process
1986 (this will be "/" unless the process did a chroot syscall)
1989 \fB\*(T<\fBpid_cmdline\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
1990 Command line this process was invoked with
1993 \fB\*(T<\fBpid_cwd\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
1994 Current working directory of the process
1997 \fB\*(T<\fBpid_environ\fR\*(T> \fR\*(T<\fBpid varname\fR\*(T>
1998 Contents of a environment-var of the process
2001 \fB\*(T<\fBpid_environ_list\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2002 List of environment-vars that the process can see
2005 \fB\*(T<\fBpid_exe\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2006 Path to executed command that started the process
2009 \fB\*(T<\fBpid_nice\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2010 The nice value of the process
2013 \fB\*(T<\fBpid_openfiles\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2014 List of files that the process has open
2017 \fB\*(T<\fBpid_parent\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2018 The pid of the parent of the process
2021 \fB\*(T<\fBpid_priority\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2022 The priority of the process (see 'priority' in "man 5 proc")
2025 \fB\*(T<\fBpid_read\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2026 Total number of bytes read by the process
2029 \fB\*(T<\fBpid_state\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2030 State of the process
2033 \fB\*(T<\fBpid_state_short\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2034 One of the chars in "RSDZTW" representing the state
2035 of the process where R is running, S is sleeping in an
2036 interruptible wait, D is waiting in uninterruptible disk sleep,
2037 Z is zombie, T is traced or stopped (on a signal), and W is paging
2040 \fB\*(T<\fBpid_stderr\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2041 Filedescriptor binded to the STDERR of the process
2044 \fB\*(T<\fBpid_stdin\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2045 Filedescriptor binded to the STDIN of the process
2048 \fB\*(T<\fBpid_stdout\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2049 Filedescriptor binded to the STDOUT of the process
2052 \fB\*(T<\fBpid_threads\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2053 Number of threads in process containing this thread
2056 \fB\*(T<\fBpid_thread_list\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2057 List with pid's from threads from this process
2060 \fB\*(T<\fBpid_time_kernelmode\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2061 Amount of time that the process has been scheduled in kernel mode in seconds
2064 \fB\*(T<\fBpid_time_usermode\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2065 Amount of time that the process has been scheduled in user mode in seconds
2068 \fB\*(T<\fBpid_time\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2069 Sum of $pid_time_kernelmode and $pid_time_usermode
2072 \fB\*(T<\fBpid_uid\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2073 The real uid of the process
2076 \fB\*(T<\fBpid_euid\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2077 The effective uid of the process
2080 \fB\*(T<\fBpid_suid\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2081 The saved set uid of the process
2084 \fB\*(T<\fBpid_fsuid\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2085 The file system uid of the process
2088 \fB\*(T<\fBpid_gid\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2089 The real gid of the process
2092 \fB\*(T<\fBpid_egid\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2093 The effective gid of the process
2096 \fB\*(T<\fBpid_sgid\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2097 The saved set gid of the process
2100 \fB\*(T<\fBpid_fsgid\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2101 The file system gid of the process
2104 \fB\*(T<\fBpid_vmpeak\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2105 Peak virtual memory size of the process
2108 \fB\*(T<\fBpid_vmsize\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2109 Virtual memory size of the process
2112 \fB\*(T<\fBpid_vmlck\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2113 Locked memory size of the process
2116 \fB\*(T<\fBpid_vmhwm\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2117 Peak resident set size ("high water mark") of the process
2120 \fB\*(T<\fBpid_vmrss\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2121 Resident set size of the process
2124 \fB\*(T<\fBpid_vmdata\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2125 Data segment size of the process
2128 \fB\*(T<\fBpid_vmstk\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2129 Stack segment size of the process
2132 \fB\*(T<\fBpid_vmexe\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2133 Text segment size of the process
2136 \fB\*(T<\fBpid_vmlib\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2137 Shared library code size of the process
2140 \fB\*(T<\fBpid_vmpte\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2141 Page table entries size of the process
2144 \fB\*(T<\fBpid_write\fR\*(T> \fR\*(T<\fBpid\fR\*(T>
2145 Total number of bytes written by the process
2148 \fB\*(T<\fBplatform\fR\*(T> \fR\*(T<\fB(dev) type n (factor offset)\fR\*(T>
2149 Platform sensor from sysfs (Linux 2.6). Parameter
2150 dev may be omitted if you have only one platform device.
2151 Platform type is either 'in' or 'vol' meaning voltage;
2152 \&'fan' meaning fan; 'temp' meaning temperature. Parameter n
2153 is number of the sensor. See /sys/bus/platform/devices/ on
2154 your local computer. The optional arguments 'factor' and
2155 \&'offset' allow precalculation of the raw input, which is
2156 being modified as follows: 'input = input * factor +
2157 offset'. Note that they have to be given as decimal values
2158 (i.e. contain at least one decimal place).
2161 \fB\*(T<\fBpop3_unseen\fR\*(T> \fR\*(T<\fB(args)\fR\*(T>
2162 Displays the number of unseen messages in your
2163 global POP3 inbox by default. You can define individual
2164 POP3 inboxes separately by passing arguments to this
2165 object. Arguments are: "host user pass [-i interval (in
2166 seconds)] [-p port] [-e 'command'] [-r retries]". Default
2167 port is 110, default interval is 5 minutes, and default
2168 number of retries before giving up is 5. If the password is
2169 supplied as '*', you will be prompted to enter the password
2173 \fB\*(T<\fBpop3_used\fR\*(T> \fR\*(T<\fB(args)\fR\*(T>
2174 Displays the amount of space (in MiB, 2^20) used
2175 in your global POP3 inbox by default. You can define
2176 individual POP3 inboxes separately by passing arguments to
2177 this object. Arguments are: "host user pass [-i interval
2178 (in seconds)] [-p port] [-e 'command'] [-r retries]". Default
2179 port is 110, default interval is 5 minutes, and default
2180 number of retries before giving up is 5. If the password is
2181 supplied as '*', you will be prompted to enter the password
2185 \fB\*(T<\fBpre_exec\fR\*(T> \fR\*(T<\fBshell command\fR\*(T>
2186 Executes a shell command one time before conky
2187 displays anything and puts output as text.
2190 \fB\*(T<\fBprocesses\fR\*(T> \fR
2191 Total processes (sleeping and running)
2194 \fB\*(T<\fBread_tcp\fR\*(T> \fR\*(T<\fB(host) port\fR\*(T>
2195 Connects to a tcp port on a host (default is
2196 localhost), reads every char available at the moment and
2200 \fB\*(T<\fBreplied_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
2201 Number of mails marked as replied in the
2202 specified mailbox or mail spool if not. Only maildir type
2203 mailboxes are supported, mbox type will return -1.
2206 \fB\*(T<\fBrss\fR\*(T> \fR\*(T<\fBuri interval_in_minutes action (num_par (spaces_in_front))\fR\*(T>
2207 Download and parse RSS feeds. The interval may be
2208 a floating point value greater than 0, otherwise
2209 defaults to 15 minutes. Action may be one of the
2210 following: feed_title, item_title (with num par),
2211 item_desc (with num par) and item_titles (when using
2212 this action and spaces_in_front is given conky places
2213 that many spaces in front of each item). This object is
2214 threaded, and once a thread is created it can't be
2215 explicitly destroyed. One thread will run for each URI
2216 specified. You can use any protocol that Curl
2219 \fB\*(T<\fBrunning_processes\fR\*(T> \fR
2220 Running processes (not sleeping), requires Linux
2224 \fB\*(T<\fBrunning_threads\fR\*(T> \fR
2225 Number of running (runnable) threads. Linux only.
2228 \fB\*(T<\fBscroll\fR\*(T> \fR\*(T<\fBlength (step) text\fR\*(T>
2229 Scroll 'text' by 'step' characters showing
2230 \&'length' number of characters at the same time. The text
2231 may also contain variables. 'step' is optional and defaults
2232 to 1 if not set. If a var creates output on multiple lines
2233 then the lines are placed behind each other separated with
2234 a '|'-sign. If you change the textcolor inside $scroll it
2235 will automatically have it's old value back at the end of
2236 $scroll. The end and the start of text will be separated by
2237 \&'length' number of spaces.
2240 \fB\*(T<\fBseen_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
2241 Number of mails marked as seen in the specified
2242 mailbox or mail spool if not. Only maildir type mailboxes
2243 are supported, mbox type will return -1.
2246 \fB\*(T<\fBshadecolor\fR\*(T> \fR\*(T<\fB(color)\fR\*(T>
2247 Change shading color
2250 \fB\*(T<\fBsmapi\fR\*(T> \fR\*(T<\fB(ARGS)\fR\*(T>
2251 when using smapi, display contents of the
2252 /sys/devices/platform/smapi directory. ARGS are either
2253 \&'(FILENAME)' or 'bat (INDEX) (FILENAME)' to display the
2254 corresponding files' content. This is a very raw method of
2255 accessing the smapi values. When available, better use one
2256 of the smapi_* variables instead.
2259 \fB\*(T<\fBsmapi_bat_bar\fR\*(T> \fR\*(T<\fB(INDEX),(height),(width)\fR\*(T>
2260 when using smapi, display the remaining capacity
2261 of the battery with index INDEX as a bar.
2264 \fB\*(T<\fBsmapi_bat_perc\fR\*(T> \fR\*(T<\fB(INDEX)\fR\*(T>
2265 when using smapi, display the remaining capacity
2266 in percent of the battery with index INDEX. This is a
2267 separate variable because it supports the 'use_spacer'
2268 configuration option.
2271 \fB\*(T<\fBsmapi_bat_power\fR\*(T> \fR\*(T<\fBINDEX\fR\*(T>
2272 when using smapi, display the current power of
2273 the battery with index INDEX in watt. This is a separate
2274 variable because the original read out value is being
2275 converted from mW. The sign of the output reflects charging
2276 (positive) or discharging (negative) state.
2279 \fB\*(T<\fBsmapi_bat_temp\fR\*(T> \fR\*(T<\fBINDEX\fR\*(T>
2280 when using smapi, display the current temperature
2281 of the battery with index INDEX in degree Celsius. This is
2282 a separate variable because the original read out value is
2283 being converted from milli degree Celsius.
2286 \fB\*(T<\fBsony_fanspeed\fR\*(T> \fR
2287 Displays the Sony VAIO fanspeed information if
2288 sony-laptop kernel support is enabled. Linux only.
2291 \fB\*(T<\fBstippled_hr\fR\*(T> \fR\*(T<\fB(space)\fR\*(T>
2292 Stippled (dashed) horizontal line
2295 \fB\*(T<\fBswap\fR\*(T> \fR
2296 Amount of swap in use
2299 \fB\*(T<\fBswapbar\fR\*(T> \fR\*(T<\fB(height),(width)\fR\*(T>
2300 Bar that shows amount of swap in use
2303 \fB\*(T<\fBswapfree\fR\*(T> \fR
2307 \fB\*(T<\fBswapmax\fR\*(T> \fR
2308 Total amount of swap
2311 \fB\*(T<\fBswapperc\fR\*(T> \fR
2312 Percentage of swap in use
2315 \fB\*(T<\fBsysname\fR\*(T> \fR
2316 System name, Linux for example
2319 \fB\*(T<\fBtab\fR\*(T> \fR\*(T<\fB(width, (start))\fR\*(T>
2320 Puts a tab of the specified width, starting from
2321 column 'start'. The unit is pixels for both arguments.
2324 \fB\*(T<\fBtail\fR\*(T> \fR\*(T<\fBlogfile lines (next_check)\fR\*(T>
2325 Displays last N lines of supplied text file. The
2326 file is checked every 'next_check' update. If next_check is
2327 not supplied, Conky defaults to 2. Max of 30 lines can be
2328 displayed, or until the text buffer is filled.
2331 \fB\*(T<\fBtcp_portmon\fR\*(T> \fR\*(T<\fBport_begin port_end item (index)\fR\*(T>
2332 TCP port (both IPv6 and IPv4) monitor for
2333 specified local ports. Port numbers must be in
2334 the range 1 to 65535. Valid items are:
2337 \*(T<\fBTotal number of connections in the
2341 \*(T<\fBRemote ip address\fR\*(T>
2344 \*(T<\fBRemote host name\fR\*(T>
2347 \*(T<\fBRemote port number\fR\*(T>
2350 \*(T<\fBRemote service name from
2351 /etc/services\fR\*(T>
2354 \*(T<\fBLocal ip address\fR\*(T>
2357 \*(T<\fBLocal host name\fR\*(T>
2360 \*(T<\fBLocal port number\fR\*(T>
2363 \*(T<\fBLocal service name from
2364 /etc/services\fR\*(T>
2366 The connection index provides you with access to
2367 each connection in the port monitor. The monitor will
2368 return information for index values from 0 to n-1
2369 connections. Values higher than n-1 are simply ignored.
2370 For the "count" item, the connection index must be
2371 omitted. It is required for all other items.
2375 \fB${tcp_portmon 6881 6999
2377 \*(T<\fBDisplays the number of connections in
2378 the bittorrent port range\fR\*(T>
2380 \fB${tcp_portmon 22 22 rip 0}\fR
2381 \*(T<\fBDisplays the remote host ip of the
2382 first sshd connection\fR\*(T>
2384 \fB${tcp_portmon 22 22 rip 9}\fR
2385 \*(T<\fBDisplays the remote host ip of the
2386 tenth sshd connection\fR\*(T>
2388 \fB${tcp_portmon 1 1024 rhost
2390 \*(T<\fBDisplays the remote host name of the
2391 first connection on a privileged port\fR\*(T>
2393 \fB${tcp_portmon 1 1024 rport
2395 \*(T<\fBDisplays the remote host port of the
2396 fifth connection on a privileged port\fR\*(T>
2398 \fB${tcp_portmon 1 65535 lservice
2400 \*(T<\fBDisplays the local service name of the
2401 fifteenth connection in the range of all
2404 Note that port monitor variables which share the
2405 same port range actually refer to the same monitor, so
2406 many references to a single port range for different
2407 items and different indexes all use the same monitor
2408 internally. In other words, the program avoids creating
2411 \fB\*(T<\fBtemplateN\fR\*(T> \fR\*(T<\fB(arg1)\fR\*(T> \*(T<\fB(arg2)\fR\*(T> \*(T<\fB(arg3 ...)\fR\*(T>
2412 Evaluate the content of the templateN
2413 configuration variable (where N is a value between 0
2414 and 9, inclusively), applying substitutions as
2415 described in the documentation of the corresponding
2416 configuration variable. The number of arguments is
2417 optional, but must match the highest referred index in
2418 the template. You can use the same special sequences in
2419 each argument as the ones valid for a template
2420 definition, e.g. to allow an argument to contain a
2421 whitespace. Also simple nesting of templates is
2424 Here are some examples of template
2429 template1 \e1: ${fs_used \e2} / ${fs_size
2434 The following list shows sample usage of the
2435 templates defined above, with the equivalent syntax
2436 when not using any template at all:
2442 same without template
2450 ${template0 node name}
2457 root: ${fs_free /} / ${fs_size
2462 ${template2\e disk\e root}
2466 ${fs_free /} / ${fs_size
2471 \fB\*(T<\fBtexeci\fR\*(T> \fR\*(T<\fBinterval command\fR\*(T>
2472 Runs a command at an interval inside a thread and
2473 displays the output. Same as $execi, except the command is
2474 run inside a thread. Use this if you have a slow script to
2475 keep Conky updating. You should make the interval slightly
2476 longer then the time it takes your script to execute. For
2477 example, if you have a script that take 5 seconds to
2478 execute, you should make the interval at least 6 seconds.
2479 See also $execi. This object will clean up the thread when
2480 it is destroyed, so it can safely be used in a nested
2481 fashion, though it may not produce the desired behaviour if
2485 \fB\*(T<\fBthreads\fR\*(T> \fR
2489 \fB\*(T<\fBtime\fR\*(T> \fR\*(T<\fB(format)\fR\*(T>
2490 Local time, see man strftime to get more
2491 information about format
2494 \fB\*(T<\fBto_bytes\fR\*(T> \fR\*(T<\fBsize\fR\*(T>
2495 If 'size' is a number followed by a size-unit
2496 (kilobyte,mb,GiB,...) then it converts the size to bytes
2497 and shows it without unit, otherwise it just shows 'size'.
2500 \fB\*(T<\fBtop\fR\*(T> \fR\*(T<\fBtype num\fR\*(T>
2501 This takes arguments in the form:top (name)
2502 (number) Basically, processes are ranked from highest to
2503 lowest in terms of cpu usage, which is what (num)
2504 represents. The types are: "name", "pid", "cpu", "mem",
2505 "mem_res", "mem_vsize", "time", "io_perc", "io_read" and
2506 "io_write". There can be a max of 10 processes listed.
2509 \fB\*(T<\fBtop_io\fR\*(T> \fR\*(T<\fBtype num\fR\*(T>
2510 Same as top, except sorted by the amount of I/O
2511 the process has done during the update interval
2514 \fB\*(T<\fBtop_mem\fR\*(T> \fR\*(T<\fBtype num\fR\*(T>
2515 Same as top, except sorted by mem usage instead
2519 \fB\*(T<\fBtop_time\fR\*(T> \fR\*(T<\fBtype num\fR\*(T>
2520 Same as top, except sorted by total CPU time
2521 instead of current CPU usage
2524 \fB\*(T<\fBtotaldown\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2525 Total download, overflows at 4 GB on Linux with
2526 32-bit arch and there doesn't seem to be a way to know how
2527 many times it has already done that before conky has
2531 \fB\*(T<\fBtotalup\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2532 Total upload, this one too, may overflow
2535 \fB\*(T<\fBtrashed_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
2536 Number of mails marked as trashed in the
2537 specified mailbox or mail spool if not. Only maildir type
2538 mailboxes are supported, mbox type will return -1.
2541 \fB\*(T<\fBtztime\fR\*(T> \fR\*(T<\fB(timezone (format))\fR\*(T>
2542 Local time for specified timezone, see man
2543 strftime to get more information about format. The timezone
2544 argument is specified in similar fashion as TZ environment
2545 variable. For hints, look in /usr/share/zoneinfo. e.g.
2546 US/Pacific, Europe/Zurich, etc.
2549 \fB\*(T<\fBgid_name\fR\*(T> \fR\*(T<\fBgid\fR\*(T>
2550 Name of group with this gid
2553 \fB\*(T<\fBuid_name\fR\*(T> \fR\*(T<\fBuid\fR\*(T>
2554 Username of user with this uid
2557 \fB\*(T<\fBunflagged_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
2558 Number of mails not marked as flagged in the
2559 specified mailbox or mail spool if not. Only maildir type
2560 mailboxes are supported, mbox type will return -1.
2563 \fB\*(T<\fBunforwarded_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
2564 Number of mails not marked as forwarded in the
2565 specified mailbox or mail spool if not. Only maildir type
2566 mailboxes are supported, mbox type will return -1.
2569 \fB\*(T<\fBunreplied_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
2570 Number of mails not marked as replied in the
2571 specified mailbox or mail spool if not. Only maildir type
2572 mailboxes are supported, mbox type will return -1.
2575 \fB\*(T<\fBunseen_mails\fR\*(T> \fR\*(T<\fB(maildir)\fR\*(T> \*(T<\fB(interval)\fR\*(T>
2576 Number of new or unseen mails in the specified
2577 mailbox or mail spool if not. Only maildir type mailboxes
2578 are supported, mbox type will return -1.
2581 \fB\*(T<\fBupdates\fR\*(T> \fR\*(T<\fBNumber of updates\fR\*(T>
2585 \fB\*(T<\fBupspeed\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2586 Upload speed in suitable IEC units
2589 \fB\*(T<\fBupspeedf\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2590 Upload speed in KiB with one decimal
2593 \fB\*(T<\fBupspeedgraph\fR\*(T> \fR\*(T<\fB(netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l)\fR\*(T>
2594 Upload speed graph, colours defined in hex, minus
2595 the #. If scale is non-zero, it becomes the scale for the
2596 graph. Uses a logarithmic scale (to see small numbers) when
2597 you use the -l switch. Takes the switch '-t' to use a
2598 temperature gradient, which makes the gradient values
2599 change depending on the amplitude of a particular graph
2600 value (try it and see).
2603 \fB\*(T<\fBuptime\fR\*(T> \fR
2607 \fB\*(T<\fBuptime_short\fR\*(T> \fR
2608 Uptime in a shorter format
2611 \fB\*(T<\fBuser_names\fR\*(T> \fR
2612 Lists the names of the users logged in
2615 \fB\*(T<\fBuser_number\fR\*(T> \fR
2616 Number of users logged in
2619 \fB\*(T<\fBuser_terms\fR\*(T> \fR
2620 Lists the consoles in use
2623 \fB\*(T<\fBuser_times\fR\*(T> \fR
2624 Lists how long users have been logged in for
2627 \fB\*(T<\fBuser_time\fR\*(T> \fR\*(T<\fBconsole\fR\*(T>
2628 Lists how long the user for the given console has been
2632 \fB\*(T<\fButime\fR\*(T> \fR\*(T<\fB(format)\fR\*(T>
2633 Display time in UTC (universal coordinate time).
2636 \fB\*(T<\fBvoffset\fR\*(T> \fR\*(T<\fB(pixels)\fR\*(T>
2637 Change vertical offset by N pixels. Negative
2638 values will cause text to overlap. See also $offset.
2641 \fB\*(T<\fBvoltage_mv\fR\*(T> \fR\*(T<\fB(n)\fR\*(T>
2642 Returns CPU #n's voltage in mV. CPUs are counted
2643 from 1. If omitted, the parameter defaults to 1.
2646 \fB\*(T<\fBvoltage_v\fR\*(T> \fR\*(T<\fB(n)\fR\*(T>
2647 Returns CPU #n's voltage in V. CPUs are counted
2648 from 1. If omitted, the parameter defaults to 1.
2651 \fB\*(T<\fBweather\fR\*(T> \fR\*(T<\fBURI locID data_type (interval_in_minutes)\fR\*(T>
2652 Download, parse and display METAR data.
2654 For the 'URI', there are two
2657 http://weather.noaa.gov/pub/data/observations/metar/stations/
2659 http://xoap.weather.com/weather/local/
2661 The first one is free to use but the second
2662 requires you to register and obtain your partner ID and
2663 license key. These two must be written, separated by a
2664 space, into a file called .xoaprc which needs to be
2665 placed into your home directory.
2667 \&'locID' must be a valid location identifier for
2668 the required uri. For the NOAA site this must be a
2669 valid ICAO (see for instance
2670 https://pilotweb.nas.faa.gov/qryhtml/icao/). For the
2671 weather.com site this must be a valid location ID (see
2673 http://aspnetresources.com/tools/locid.aspx).
2675 \&'data_type' must be one of the following:
2678 The date and time stamp of the data.
2679 The result depends on the URI used. For the
2680 NOAA site it is date (yyyy/mm/dd) and UTC time.
2681 For the weather.com one it is date
2682 ([m]m/[d]d/yy) and Local Time of the
2687 Air temperature (you can use the
2688 \&'temperature_unit' config setting to change
2693 The highest cloud cover status
2697 Air pressure in millibar
2709 Compass wind direction
2713 Relative humidity in %
2717 Any relevant weather event (rain, snow,
2718 etc.). This is not used if you are querying the
2719 weather.com site since this data is aggregated
2720 into the cloud_cover one
2724 Weather icon (only for
2725 www.weather.com). Can be used together with the
2726 icon kit provided upon registering to their
2729 \&'delay_in_minutes' (optional, default 30) cannot
2730 be less than 30 minutes.
2732 This object is threaded, and once a thread is
2733 created it can't be explicitly destroyed. One thread
2734 will run for each URI specified.
2736 Note that these variables are still EXPERIMENTAL
2737 and can be subject to many future changes.
2739 \fB\*(T<\fBweather_forecast\fR\*(T> \fR\*(T<\fBURI locID day data_type (interval_in_minutes)\fR\*(T>
2740 Download, parse and display weather forecast data
2741 for a given day (daytime only).
2743 For the 'URI', for the time being only
2744 http://xoap.weather.com/weather/local/ is
2745 supported. See 'weather' above for details of usage
2747 \&'locID', see 'weather' above.
2749 \&'day' is a number from 0 (today) to 4 (3 days
2752 \&'data_type' must be one of the following:
2755 \*(T<\fBDay of the week\fR\*(T>
2758 \*(T<\fBDate, in the form MMM DD (ie. Jul 14)\fR\*(T>
2761 \*(T<\fBMinimun temperature (you can use the
2762 \&'temperature_unit' config setting to change
2766 \*(T<\fBMaximum temperature (you can use the
2767 \&'temperature_unit' config setting to change
2771 \*(T<\fBWeather icon. Can be used together with the
2772 icon kit provided upon registering to the weather.com
2776 \*(T<\fBWeather forecast (sunny, rainy, etc.)\fR\*(T>
2779 \*(T<\fBWind speed in km/h\fR\*(T>
2782 \*(T<\fBWind direction\fR\*(T>
2785 \*(T<\fBCompass wind direction\fR\*(T>
2788 \*(T<\fBRelative humidity in %\fR\*(T>
2791 \*(T<\fBProbability of having a
2792 precipitation (in %)\fR\*(T>
2794 \&'delay_in_minutes' (optional, default 210) cannot
2795 be lower than 210 min.
2797 This object is threaded, and once a thread is
2798 created it can't be explicitly destroyed. One thread
2799 will run for each URI specified. You can use any
2800 protocol that Curl supports.
2802 Note that these variables are still EXPERIMENTAL
2803 and can be subject to many future changes.
2805 \fB\*(T<\fBwireless_ap\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2806 Wireless access point MAC address (Linux only)
2809 \fB\*(T<\fBwireless_bitrate\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2810 Wireless bitrate (ie 11 Mb/s) (Linux only)
2813 \fB\*(T<\fBwireless_essid\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2814 Wireless access point ESSID (Linux only)
2817 \fB\*(T<\fBwireless_link_bar\fR\*(T> \fR\*(T<\fB(height),(width) (net)\fR\*(T>
2818 Wireless link quality bar (Linux only)
2821 \fB\*(T<\fBwireless_link_qual\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2822 Wireless link quality (Linux only)
2825 \fB\*(T<\fBwireless_link_qual_max\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2826 Wireless link quality maximum value (Linux only)
2829 \fB\*(T<\fBwireless_link_qual_perc\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2830 Wireless link quality in percents (Linux only)
2833 \fB\*(T<\fBwireless_mode\fR\*(T> \fR\*(T<\fB(net)\fR\*(T>
2834 Wireless mode (Managed/Ad-Hoc/Master) (Linux
2838 \fB\*(T<\fBwords\fR\*(T> \fR\*(T<\fBtextfile\fR\*(T>
2839 Displays the number of words in the given file
2842 \fB\*(T<\fBxmms2_album\fR\*(T> \fR
2843 Album in current XMMS2 song
2846 \fB\*(T<\fBxmms2_artist\fR\*(T> \fR
2847 Artist in current XMMS2 song
2850 \fB\*(T<\fBxmms2_bar\fR\*(T> \fR\*(T<\fB(height),(width)\fR\*(T>
2851 Bar of XMMS2's progress
2854 \fB\*(T<\fBxmms2_bitrate\fR\*(T> \fR
2855 Bitrate of current song
2858 \fB\*(T<\fBxmms2_comment\fR\*(T> \fR
2859 Comment in current XMMS2 song
2862 \fB\*(T<\fBxmms2_date\fR\*(T> \fR
2863 Returns song's date.
2866 \fB\*(T<\fBxmms2_duration\fR\*(T> \fR
2867 Duration of current song
2870 \fB\*(T<\fBxmms2_elapsed\fR\*(T> \fR
2874 \fB\*(T<\fBxmms2_genre\fR\*(T> \fR
2875 Genre in current XMMS2 song
2878 \fB\*(T<\fBxmms2_id\fR\*(T> \fR
2879 XMMS2 id of current song
2882 \fB\*(T<\fBxmms2_percent\fR\*(T> \fR
2883 Percent of song's progress
2886 \fB\*(T<\fBxmms2_playlist\fR\*(T> \fR
2887 Returns the XMMS2 playlist.
2890 \fB\*(T<\fBxmms2_size\fR\*(T> \fR
2891 Size of current song
2894 \fB\*(T<\fBxmms2_smart\fR\*(T> \fR
2895 Prints the song name in either the form "artist -
2896 title" or file name, depending on whats available
2899 \fB\*(T<\fBxmms2_status\fR\*(T> \fR
2900 XMMS2 status (Playing, Paused, Stopped, or
2904 \fB\*(T<\fBxmms2_timesplayed\fR\*(T> \fR
2905 Number of times a song was played (presumably).
2908 \fB\*(T<\fBxmms2_title\fR\*(T> \fR
2909 Title in current XMMS2 song
2912 \fB\*(T<\fBxmms2_tracknr\fR\*(T> \fR
2913 Track number in current XMMS2 song
2916 \fB\*(T<\fBxmms2_url\fR\*(T> \fR
2917 Full path to current song
2920 Conky features a Lua Programming API, and also ships with Lua
2921 bindings for some useful libraries. Conky defines certain global
2922 functions and variables which can be accessed from Lua code running
2925 To use Lua Conky, you first need to make sure you have a version of Conky
2926 with Lua support enabled (``conky -v'' will report this). Scripts
2927 must first be loaded using the lua_load configuration option. You
2928 then call functions in Lua via Conky's $lua, $lua_read, and Lua
2931 Be careful when creating threaded objects through the Lua API. You
2932 could wind up with a whole bunch of threads running if a thread is
2933 created with each iteration.
2935 At this time, the Lua API should not be considered stable and may
2936 change drastically from one release to another as it matures.
2938 NOTE: In order to accommodate certain features in the cairo
2939 library's API, Conky will export a few additional functions for the
2940 creation of certain structures. These are documented below.
2942 \fB\*(T<\fBconky_parse(string)\fR\*(T> \fR\*(T<\fBfunction\fR\*(T>
2943 This function takes a string that is evaluated as
2944 per Conky's TEXT section, and then returns a string
2947 \fB\*(T<\fBconky_set_update_interval(number)\fR\*(T> \fR\*(T<\fBfunction\fR\*(T>
2948 Sets Conky's update interval (in seconds) to
2951 \fB\*(T<\fBconky_window\fR\*(T> \fR\*(T<\fBtable\fR\*(T>
2952 This table contains some information about
2953 Conky's window. The following table describes the
2957 \*(T<\fBWindow's drawable (Xlib Drawable),
2958 requires Lua extras enabled at compile
2962 \*(T<\fBWindow's visual (Xlib Visual), requires
2963 Lua extras enabled at compile time.\fR\*(T>
2966 \*(T<\fBWindow's display (Xlib Display),
2967 requires Lua extras enabled at compile
2971 \*(T<\fBWindow width (in pixels).\fR\*(T>
2974 \*(T<\fBWindow height (in pixels).\fR\*(T>
2976 \fBborder_inner_margin\fR
2977 \*(T<\fBWindow's inner border margin (in
2980 \fBborder_outer_margin\fR
2981 \*(T<\fBWindow's outer border margin (in
2985 \*(T<\fBWindow's border width (in
2989 \*(T<\fBThe x component of the starting
2990 coordinate of text drawing.\fR\*(T>
2993 \*(T<\fBThe y component of the starting
2994 coordinate of text drawing.\fR\*(T>
2997 \*(T<\fBThe width of the text drawing
3001 \*(T<\fBThe height of the text drawing
3004 NOTE: This table is only defined when X support
3007 \fB\*(T<\fBconky_info\fR\*(T> \fR\*(T<\fBtable\fR\*(T>
3008 This table contains some information about
3009 Conky's internal data. The following table describes
3010 the values contained:
3012 \fBupdate_interval\fR
3013 \*(T<\fBConky's update interval (in
3017 \*(T<\fBSystem uptime, in seconds.\fR\*(T>
3019 \fB\*(T<\fBconky_build_info\fR\*(T> \fR\*(T<\fBstring\fR\*(T>
3020 A string containing the build info for this
3021 particular instance of Conky, including the version,
3022 build date, and architecture.
3024 \fB\*(T<\fBconky_build_date\fR\*(T> \fR\*(T<\fBstring\fR\*(T>
3025 A string containing the build date for this
3026 particular instance of Conky.
3028 \fB\*(T<\fBconky_build_arch\fR\*(T> \fR\*(T<\fBstring\fR\*(T>
3029 A string containing the build architecture for
3030 this particular instance of Conky.
3032 \fB\*(T<\fBconky_version\fR\*(T> \fR\*(T<\fBstring\fR\*(T>
3033 A string containing the version of the current
3036 \fB\*(T<\fBconky_config\fR\*(T> \fR\*(T<\fBstring\fR\*(T>
3037 A string containing the path of the current Conky
3040 \fB\*(T<\fBcairo_text_extents_t:create()\fR\*(T> \fR\*(T<\fBfunction\fR\*(T>
3041 Call this function to return a new cairo_text_extents_t structure. A creation function for this structure is not provided by the cairo API. After calling this, you should use tolua.takeownership() on the return value to ensure ownership is passed properly.
3043 \fB\*(T<\fBcairo_font_extents_t:create()\fR\*(T> \fR\*(T<\fBfunction\fR\*(T>
3044 Call this function to return a new cairo_font_extents_t structure. A creation function for this structure is not provided by the cairo API. After calling this, you should use tolua.takeownership() on the return value to ensure ownership is passed properly.
3046 \fB\*(T<\fBcairo_matrix_t:create()\fR\*(T> \fR\*(T<\fBfunction\fR\*(T>
3047 Call this function to return a new cairo_matrix_t structure. A creation function for this structure is not provided by the cairo API. After calling this, you should use tolua.takeownership() on the return value to ensure ownership is passed properly.
3050 \*(T<conky\*(T> \*(T<\fB\-t '${time %D %H:%M}' \-o \-u 30\fR\*(T>
3051 Start Conky in its own window with date
3052 and clock as text and 30 sec update
3055 \*(T<conky\*(T> \*(T<\fB\-a top_left \-x 5 \-y 500 \-d\fR\*(T>
3056 Start Conky to background at coordinates
3059 \*(T<conky\*(T> \*(T<\fB\-C > ~/.conkyrc\fR\*(T>
3060 Do not start Conky, but have it output
3061 the builtin default config file to ~/.conkyrc for
3065 \*(T<\fI${sysconfdir}/conky/conky.conf\fR\*(T>
3066 Default system-wide configuration file.
3067 The value of ${sysconfdir} depends on the
3068 compile-time options (most likely /etc).
3070 \*(T<\fI~/.conkyrc\fR\*(T>
3071 Default personal configuration
3074 Drawing to root or some other desktop window directly
3075 doesn't work with all window managers. Especially doesn't
3076 work well with Gnome and it has been reported that it
3077 doesn't work with KDE either. Nautilus can be disabled from
3078 drawing to desktop with program gconf-editor. Uncheck
3079 show_desktop in /apps/nautilus/preferences/. There is -w
3080 switch in Conky to set some specific window id. You might
3081 find xwininfo -tree useful to find the window to draw to.
3082 You can also use -o argument which makes Conky to create
3083 its own window. If you do try running Conky in its own
3084 window, be sure to read up on the own_window_type settings
3087 \(lahttp://conky.sourceforge.net/\(ra
3089 \(lahttp://www.sourceforge.net/projects/conky\(ra
3091 \(lahttp://wiki.conky.be\(ra
3093 #conky on irc.freenode.net
3095 Copyright (c) 2005-2010 Brenden Matthews, Philip
3096 Kovacs, et. al. Any original torsmo code is licensed under
3097 the BSD license (see LICENSE.BSD for a copy). All code
3098 written since the fork of torsmo is licensed under the GPL
3099 (see LICENSE.GPL for a copy), except where noted
3100 differently (such as in portmon code, timed thread code,
3101 and audacious code which are LGPL, and prss which is an
3104 The Conky dev team (see AUTHORS for a full list of