| Variable | Arguments () = optional | Explanation | Example |
|---|---|---|---|
| addr | (interface) | IP address for an interface | |
| acpiacadapter | ACPI ac adapter state. | ||
| acpifan | ACPI fan state | ||
| acpitemp | ACPI temperature. | ||
| adt746xcpu | CPU temperature from therm_adt746x | ||
| adt746xfan | Fan speed from therm_adt746x | ||
| alignr | (num) | Right-justify text, with space of N | |
| alignc | (num) | Align text to centre | |
| battery | (num) | Remaining capacity in ACPI or APM battery. ACPI battery number can be given as argument (default is BAT0). | |
| buffers | Amount of memory buffered | ||
| cached | Amount of memory cached | ||
| color | (color) | Change drawing color to color | |
| cpu | CPU usage in percents | ||
| cpubar | (height) | Bar that shows CPU usage, height is bar's height in pixels | |
| cpugraph | (height, width, gradient colour 1, gradient colour 2) | CPU usage graph, with optional colours in hex, minus the #. | |
| downspeed | net | Download speed in kilobytes | |
| downspeedf | net | Download speed in kilobytes with one decimal | |
| downspeedgraph | net, (height, width, gradient colour 1, gradient colour 2) | Download speed graph, colours defined in hex, minus the #. | |
| else | Text to show if any of the above are not true | ||
| exec | shell command | 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. | |
| execbar | shell command | 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. | |
| execgraph | shell command | Same as execbar, but graphs values | |
| execi | interval, shell command | Same as exec but with specific interval. Interval can't be less than update_interval in configuration. | |
| font | font | Specify a different font. Only applies to one line. | |
| fs_bar | (height, fs) | 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. | |
| fs_free | (fs) | Free space on a file system available for users. | |
| fs_free_perc | (fs) | Free percentage of space on a file system available for users. | |
| fs_size | (fs) | File system size | |
| fs_used | (fs) | File system used space | |
| hr | (height) | Horizontal line, height is the height in pixels | |
| i2c | (dev), type, n | 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. | |
| if_running | (process) | if PROCESS is running, display everything if_running and the matching $endif | |
| if_existing | (file) | if FILE exists, display everything between if_existing and the matching $endif | |
| if_mounted | (mountpoint) | if MOUNTPOINT is mounted, display everything between if_mounted and the matching $endif | |
| kernel | Kernel version | ||
| linkstatus | (interface) | Get the link status for wireless connections | |
| loadavg | (1,2,3)> System load average, 1 is for past 1 minute, 2 for past 5 minutes and 3 for past 15 minutes. | ||
| machine | Machine, i686 for example | ||
| mails | 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. | ||
| mem | Amount of memory in use | ||
| membar | (height) | Bar that shows amount of memory in use | |
| memmax | Total amount of memory | ||
| memperc | Percentage of memory in use | ||
| metar_ob_time | self-explanatory | ||
| metar_temp | self-explanatory | ||
| metar_tempf | temp in F | ||
| metar_windchill | self-explanatory | ||
| metar_dew_poin | self-explanatory | ||
| metar_rh | self-explanatory | ||
| metar_windspeed | self-explanatory | ||
| metar_winddir | self-explanatory | ||
| metar_swinddir | self-explanatory | ||
| metar_cloud | self-explanatory | ||
| metar_u2d_time | self-explanatory | ||
| ml_upload_counter | total session upload in mb | ||
| ml_download_counter | total session download in mb | ||
| ml_nshared_files | number of shared files | ||
| ml_shared_counter | total session shared in mb, buggy in some mldonkey versions | ||
| ml_tcp_upload_rate | tcp upload rate in kb/s | ||
| ml_tcp_download_rate | tcp download rate in kb/s | ||
| ml_udp_upload_rate | udp upload rate in kb/s | ||
| ml_udp_download_rate | udp download rate in kb/s | ||
| ml_ndownloaded_files | number of completed files | ||
| ml_ndownloading_files | number of downloading files | ||
| mpd_artist | Artist in current MPD song must be enabled at compile | ||
| mpd_album | Album in current MPD song | ||
| mpd_bar | height | Bar of mpd's progress | |
| mpd_bitrate | Bitrate of current song | ||
| mpd_status | Playing, stopped, et cetera. | ||
| mpd_title | Title of current MPD song | ||
| mpd_vol | MPD's volume | ||
| mpd_elapsed | Song's elapsed time | ||
| mpd_length | Song's length | ||
| mpd_percent | Percent of song's progress | ||
| new_mails | Unread mail count in mail spool. | ||
| nodename | Hostname | ||
| outlinecolor | (color) | Change outline color | |
| pre_exec | shell command | Executes a shell command one time before conky displays anything and puts output as text. | |
| processes | Total processes (sleeping and running) | ||
| running_processes | Running processes (not sleeping), requires Linux 2.6 | ||
| shadecolor | (color) | Change shading color | |
| stippled_hr | (space) | Stippled (dashed) horizontal line | |
| swapbar | (height) | Bar that shows amount of swap in use | |
| swap | Amount of swap in use | ||
| swapmax | Total amount of swap | ||
| swapperc | Percentage of swap in use | ||
| sysname | System name, Linux for example | ||
| offse | pixels | Move text over by N pixels | |
| tail | 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. | ||
| time | (format) | Local time, see man strftime to get more information about format | |
| totaldown | net | 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. | |
| top | type, num | 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. | |
| top_mem | type, num | Same as top, except sorted by mem usage instead of cpu | |
| totalup | net | Total upload, this one too, may overflow | |
| updates | Number of updates | for debugging | |
| upspeed | net | Upload speed in kilobytes | |
| upspeedf | net | Upload speed in kilobytes with one decimal | |
| upspeedgraph | net, (height, width, gradient colour 1, gradient colour 2) | Upload speed graph, colours defined in hex, minus the #. | |
| uptime | Uptime | ||
| uptime_short | Uptime in a shorter format | ||
| seti_prog | Seti@home current progress | ||
| seti_progbar | (height) | Seti@home current progress bar | |
| seti_credit | Seti@home total user credit |