4 <command><option>addr</option></command>
5 <option>(interface)</option>
8 IP address for an interface
9 <para></para></listitem>
14 <command><option>acpiacadapter</option></command>
17 ACPI ac adapter state.
18 <para></para></listitem>
23 <command><option>acpifan</option></command>
27 <para></para></listitem>
32 <command><option>acpitemp</option></command>
35 ACPI temperature in C.
36 <para></para></listitem>
41 <command><option>acpitempf</option></command>
44 ACPI temperature in F.
45 <para></para></listitem>
50 <command><option>adt746xcpu</option></command>
53 CPU temperature from therm_adt746x
54 <para></para></listitem>
59 <command><option>adt746xfan</option></command>
62 Fan speed from therm_adt746x
63 <para></para></listitem>
68 <command><option>alignr</option></command>
69 <option>(num)</option>
72 Right-justify text, with space of N
73 <para></para></listitem>
78 <command><option>alignc</option></command>
79 <option>(num)</option>
83 <para></para></listitem>
88 <command><option>battery</option></command>
89 <option>(num)</option>
92 Remaining capacity in ACPI or APM battery. ACPI battery number can be given as argument (default is BAT0).
93 <para></para></listitem>
98 <command><option>buffers</option></command>
101 Amount of memory buffered
102 <para></para></listitem>
107 <command><option>cached</option></command>
110 Amount of memory cached
111 <para></para></listitem>
116 <command><option>color</option></command>
117 <option>(color)</option>
120 Change drawing color to color
121 <para></para></listitem>
126 <command><option>cpu</option></command>
129 CPU usage in percents
130 <para></para></listitem>
135 <command><option>cpubar</option></command>
136 <option>(height),(width)</option>
139 Bar that shows CPU usage, height is bar's height in pixels
140 <para></para></listitem>
145 <command><option>cpugraph</option></command>
146 <option>(height),(width) (gradient colour 1) (gradient colour 2)</option>
149 CPU usage graph, with optional colours in hex, minus the #.
150 <para></para></listitem>
155 <command><option>downspeed</option></command>
159 Download speed in kilobytes
160 <para></para></listitem>
165 <command><option>downspeedf</option></command>
169 Download speed in kilobytes with one decimal
170 <para></para></listitem>
175 <command><option>downspeedgraph</option></command>
176 <option>net, (height),(width) (gradient colour 1) (gradient colour 2)</option>
179 Download speed graph, colours defined in hex, minus the #.
180 <para></para></listitem>
185 <command><option>else</option></command>
188 Text to show if any of the above are not true
189 <para></para></listitem>
194 <command><option>exec</option></command>
195 <option>shell command</option>
198 Executes a shell command and displays the output in conky. warning: this takes a lot more resources than other variables. I'd recommend coding wanted behaviour in C and posting a patch.
199 <para></para></listitem>
204 <command><option>execbar</option></command>
205 <option>shell command</option>
208 Same as exec, except if the first value return is a value between 0-100, it will use that number for a bar. The size for the bar is currently fixed, but that may change in the future.
209 <para></para></listitem>
214 <command><option>execgraph</option></command>
215 <option>shell command</option>
218 Same as execbar, but graphs values
219 <para></para></listitem>
224 <command><option>execi</option></command>
225 <option>interval, shell command</option>
228 Same as exec but with specific interval. Interval can't be less than update_interval in configuration.
229 <para></para></listitem>
234 <command><option>font</option></command>
235 <option>font</option>
238 Specify a different font. Only applies to one line.
239 <para></para></listitem>
245 <command><option>freq</option></command>
248 Returns CPU frequency in MHz
249 <para></para></listitem>
253 <command><option>freq_g</option></command>
256 Returns CPU frequency in GHz
257 <para></para></listitem>
262 <command><option>fs_bar</option></command>
263 <option>(height),(width) fs</option>
266 Bar that shows how much space is used on a file system. height is the height in pixels. fs is any file on that file system.
267 <para></para></listitem>
272 <command><option>fs_free</option></command>
273 <option>(fs)</option>
276 Free space on a file system available for users.
277 <para></para></listitem>
282 <command><option>fs_free_perc</option></command>
283 <option>(fs)</option>
286 Free percentage of space on a file system available for users.
287 <para></para></listitem>
292 <command><option>fs_size</option></command>
293 <option>(fs)</option>
297 <para></para></listitem>
302 <command><option>fs_used</option></command>
303 <option>(fs)</option>
306 File system used space
307 <para></para></listitem>
312 <command><option>hr</option></command>
313 <option>(height)</option>
316 Horizontal line, height is the height in pixels
317 <para></para></listitem>
322 <command><option>i2c</option></command>
323 <option>(dev), type, n</option>
326 I2C sensor from sysfs (Linux 2.6). dev may be omitted if you have only one I2C device. type is either in (or vol) meaning voltage, fan meaning fan or temp/tempf (first in C, second in F) meaning temperature. n is number of the sensor. See /sys/bus/i2c/devices/ on your local computer.
327 <para></para></listitem>
332 <command><option>if_running</option></command>
333 <option>(process)</option>
336 if PROCESS is running, display everything if_running and the matching $endif
337 <para></para></listitem>
342 <command><option>if_existing</option></command>
343 <option>(file)</option>
346 if FILE exists, display everything between if_existing and the matching $endif
347 <para></para></listitem>
352 <command><option>if_mounted</option></command>
353 <option>(mountpoint)</option>
356 if MOUNTPOINT is mounted, display everything between if_mounted and the matching $endif
357 <para></para></listitem>
362 <command><option>kernel</option></command>
366 <para></para></listitem>
371 <command><option>linkstatus</option></command>
372 <option>(interface)</option>
375 Get the link status for wireless connections
376 <para></para></listitem>
381 <command><option>loadavg</option></command>
384 (1,2,3)> System load average, 1 is for past 1 minute, 2 for past 5 minutes and 3 for past 15 minutes.
385 <para></para></listitem>
390 <command><option>machine</option></command>
393 Machine, i686 for example
394 <para></para></listitem>
399 <command><option>mails</option></command>
402 Mail count in mail spool. You can use program like fetchmail to get mails from some server using your favourite protocol. See also new_mails.
403 <para></para></listitem>
408 <command><option>mem</option></command>
411 Amount of memory in use
412 <para></para></listitem>
417 <command><option>membar</option></command>
418 <option>(height),(width)</option>
421 Bar that shows amount of memory in use
422 <para></para></listitem>
427 <command><option>memmax</option></command>
430 Total amount of memory
431 <para></para></listitem>
436 <command><option>memperc</option></command>
439 Percentage of memory in use
440 <para></para></listitem>
445 <command><option>ml_upload_counter</option></command>
448 total session upload in mb
449 <para></para></listitem>
454 <command><option>ml_download_counter</option></command>
457 total session download in mb
458 <para></para></listitem>
463 <command><option>ml_nshared_files</option></command>
466 number of shared files
467 <para></para></listitem>
472 <command><option>ml_shared_counter</option></command>
475 total session shared in mb, buggy in some mldonkey versions
476 <para></para></listitem>
481 <command><option>ml_tcp_upload_rate</option></command>
484 tcp upload rate in kb/s
485 <para></para></listitem>
490 <command><option>ml_tcp_download_rate</option></command>
493 tcp download rate in kb/s
494 <para></para></listitem>
499 <command><option>ml_udp_upload_rate</option></command>
502 udp upload rate in kb/s
503 <para></para></listitem>
508 <command><option>ml_udp_download_rate</option></command>
511 udp download rate in kb/s
512 <para></para></listitem>
517 <command><option>ml_ndownloaded_files</option></command>
520 number of completed files
521 <para></para></listitem>
526 <command><option>ml_ndownloading_files</option></command>
529 number of downloading files
530 <para></para></listitem>
535 <command><option>mpd_artist</option></command>
538 Artist in current MPD song must be enabled at compile
539 <para></para></listitem>
544 <command><option>mpd_album</option></command>
547 Album in current MPD song
548 <para></para></listitem>
553 <command><option>mpd_bar</option></command>
554 <option>(height),(width)</option>
557 Bar of mpd's progress
558 <para></para></listitem>
563 <command><option>mpd_bitrate</option></command>
566 Bitrate of current song
567 <para></para></listitem>
572 <command><option>mpd_status</option></command>
575 Playing, stopped, et cetera.
576 <para></para></listitem>
581 <command><option>mpd_title</option></command>
584 Title of current MPD song
585 <para></para></listitem>
590 <command><option>mpd_vol</option></command>
594 <para></para></listitem>
599 <command><option>mpd_elapsed</option></command>
603 <para></para></listitem>
608 <command><option>mpd_length</option></command>
612 <para></para></listitem>
617 <command><option>mpd_percent</option></command>
620 Percent of song's progress
621 <para></para></listitem>
626 <command><option>new_mails</option></command>
629 Unread mail count in mail spool.
630 <para></para></listitem>
635 <command><option>nodename</option></command>
639 <para></para></listitem>
644 <command><option>outlinecolor</option></command>
645 <option>(color)</option>
649 <para></para></listitem>
654 <command><option>pre_exec</option></command>
655 <option>shell command</option>
658 Executes a shell command one time before conky displays anything and puts output as text.
659 <para></para></listitem>
664 <command><option>processes</option></command>
667 Total processes (sleeping and running)
668 <para></para></listitem>
673 <command><option>running_processes</option></command>
676 Running processes (not sleeping), requires Linux 2.6
677 <para></para></listitem>
682 <command><option>shadecolor</option></command>
683 <option>(color)</option>
687 <para></para></listitem>
692 <command><option>stippled_hr</option></command>
693 <option>(space)</option>
696 Stippled (dashed) horizontal line
697 <para></para></listitem>
702 <command><option>swapbar</option></command>
703 <option>(height),(width)</option>
706 Bar that shows amount of swap in use
707 <para></para></listitem>
712 <command><option>swap</option></command>
715 Amount of swap in use
716 <para></para></listitem>
721 <command><option>swapmax</option></command>
725 <para></para></listitem>
730 <command><option>swapperc</option></command>
733 Percentage of swap in use
734 <para></para></listitem>
739 <command><option>sysname</option></command>
742 System name, Linux for example
743 <para></para></listitem>
748 <command><option>offset</option></command>
749 <option>(pixels)</option>
752 Move text over by N pixels. See also $voffset.
753 <para></para></listitem>
758 <command><option>tail</option></command>
761 logfile, lines interval> Displays last N lines of supplied text text file. If interval is not supplied, Conky assumes 2x Conky's interval. Max of 30 lines. Max of 30 lines can be displayed.
762 <para></para></listitem>
767 <command><option>time</option></command>
768 <option>(format)</option>
771 Local time, see man strftime to get more information about format
772 <para></para></listitem>
777 <command><option>totaldown</option></command>
781 Total download, overflows at 4 GB on Linux with 32-bit arch and there doesn't seem to be a way to know how many times it has already done that before conky has started.
782 <para></para></listitem>
787 <command><option>top</option></command>
788 <option>type, num</option>
791 This takes arguments in the form:top (name) (number) Basically, processes are ranked from highest to lowest in terms of cpu usage, which is what (num) represents. The types are: "name", "pid", "cpu", and mem". There can be a max of 10 processes listed.
792 <para></para></listitem>
797 <command><option>top_mem</option></command>
798 <option>type, num</option>
801 Same as top, except sorted by mem usage instead of cpu
802 <para></para></listitem>
807 <command><option>totalup</option></command>
811 Total upload, this one too, may overflow
812 <para></para></listitem>
817 <command><option>updates</option></command>
818 <option>Number of updates</option>
822 <para></para></listitem>
827 <command><option>upspeed</option></command>
831 Upload speed in kilobytes
832 <para></para></listitem>
837 <command><option>upspeedf</option></command>
841 Upload speed in kilobytes with one decimal
842 <para></para></listitem>
847 <command><option>upspeedgraph</option></command>
848 <option>net, (height),(width) (gradient colour 1) (gradient colour 2)</option>
851 Upload speed graph, colours defined in hex, minus the #.
852 <para></para></listitem>
857 <command><option>uptime</option></command>
861 <para></para></listitem>
866 <command><option>uptime_short</option></command>
869 Uptime in a shorter format
870 <para></para></listitem>
875 <command><option>seti_prog</option></command>
878 Seti@home current progress
879 <para></para></listitem>
884 <command><option>seti_progbar</option></command>
885 <option>(height),(width)</option>
888 Seti@home current progress bar
889 <para></para></listitem>
894 <command><option>seti_credit</option></command>
897 Seti@home total user credit
898 <para></para></listitem>
902 <command><option>voffset</option></command>
903 <option>(pixels)</option>
906 Change verticle offset by N pixels. Negative values will cause text to overlap. See also $offset.
907 <para></para></listitem>