Variable |
Arguments () = optional |
Explanation |
addr |
interface |
IP address for an interface
|
acpiacadapter |
|
ACPI ac adapter state.
|
acpifan |
|
ACPI fan state
|
acpitemp |
|
ACPI temperature in C.
|
acpitempf |
|
ACPI temperature in F.
|
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
|
apm_adapter |
|
Display APM AC adapter status (FreeBSD only)
|
apm_battery_life |
|
Display APM battery life in percent (FreeBSD only)
|
apm_battery_time |
|
Display remaining APM battery life in hh:mm:ss or "unknown" if
AC adapterstatus is on-line or charging (FreeBSD only)
|
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 |
(cpuN) |
CPU usage in percents. For SMP machines, the CPU number can be provided as an argument. cpu0 is the total usage, and >=cpu1 are individual CPUs.
|
cpubar |
(cpu number) (height),(width) |
Bar that shows CPU usage, height is bar's height in pixels. See $cpu for more info on SMP.
|
cpugraph |
(cpu number) (height),(width) (gradient colour 1) (gradient colour 2) |
CPU usage graph, with optional colours in hex, minus the #. See $cpu for more info on SMP.
|
diskio |
|
Displays current disk IO.
|
diskiograph |
(height),(width) (gradient colour 1) (gradient colour 2) (scale) |
Disk IO graph, colours defined in hex, minus the #. If scale is non-zero, it becomes the scale for the graph.
|
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) (scale) |
Download speed graph, colours defined in hex, minus the #. If scale is non-zero, it becomes the scale for the graph.
|
else |
|
Text to show if any of the above are not true
|
exec |
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 |
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 |
command |
Same as execbar, but graphs values.
|
execi |
interval command |
Same as exec but with specific interval. Interval can't be less than update_interval in configuration. See also $texeci
|
execibar |
interval command |
Same as execbar, except with an interval
|
execigraph |
interval command |
Same as execigraph, but takes an interval arg graphs values
|
font |
font |
Specify a different font. Only applies to one line.
|
freq |
|
Returns CPU frequency in MHz
|
freq_g |
|
Returns CPU frequency in GHz
|
freq_dyn |
|
Returns CPU frequency in MHz, but is calculated by counting to clock cycles to complete an instruction. Only available for x86/amd64.
|
freq_dyn_g |
|
Returns CPU frequency in GHz, but is calculated by counting to clock cycles to complete an instruction. Only available for x86/amd64.
|
fs_bar |
(height),(width) 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
|
head |
logfile lines (interval) |
Displays first N lines of supplied text text file. If interval is not supplied, Conky assumes 2x Conky's interval. Max of 30 lines can be displayed, or until the text buffer is filled.
|
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.
|
i8k_ac_status |
|
If running the i8k kernel driver for Inspiron laptops, displays whether ac power is on, as listed in /proc/i8k (translated to human-readable). Beware that this is by default not enabled by i8k itself.
|
i8k_bios |
|
If running the i8k kernel driver for Inspiron laptops, displays the bios version as listed in /proc/i8k.
|
i8k_buttons_status |
|
If running the i8k kernel driver for Inspiron laptops, displays the volume buttons status as listed in /proc/i8k.
|
i8k_cpu_temp |
|
If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in celsius, as reported by /proc/i8k.
|
i8k_cpu_tempf |
|
If running the i8k kernel driver for Inspiron laptops, displays the cpu temperature in farenheit, as reported by /proc/i8k.
|
i8k_left_fan_rpm |
|
If running the i8k kernel driver for Inspiron laptops, displays the left fan's rate of rotation, in revolutions per minute as listed in /proc/i8k. Beware, some laptops i8k reports these fans in reverse order.
|
i8k_left_fan_status |
|
If running the i8k kernel driver for Inspiron laptops, displays the left fan status as listed in /proc/i8k (translated to human-readable). Beware, some laptops i8k reports these fans in reverse order.
|
i8k_right_fan_rpm |
|
If running the i8k kernel driver for Inspiron laptops, displays the right fan's rate of rotation, in revolutions per minute as listed in /proc/i8k. Beware, some laptops i8k reports these fans in reverse order.
|
i8k_right_fan_status |
|
If running the i8k kernel driver for Inspiron laptops, displays the right fan status as listed in /proc/i8k (translated to human-readable). Beware, some laptops i8k reports these fans in reverse order.
|
i8k_serial |
|
If running the i8k kernel driver for Inspiron laptops, displays your laptop serial number as listed in /proc/i8k.
|
i8k_version |
|
If running the i8k kernel driver for Inspiron laptops, displays the version formatting of /proc/i8k.
|
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),(width) |
Bar that shows amount of memory in use
|
memmax |
|
Total amount of memory
|
memperc |
|
Percentage of memory in use
|
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),(width) |
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),(width) |
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
|
texeci |
interval command |
Runs a command at an interval inside a thread and displays the output. Same as $execi, except the command is run inside a thread. Use this if you have a slow script to keep Conky updating. You should make the interval slightly longer then the time it takes your script to execute. For example, if you have a script that take 5 seconds to execute, you should make the interval at least 6 seconds. See also $execi.
|
offset |
(pixels) |
Move text over by N pixels. See also $voffset.
|
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 can be displayed, or until the text buffer is filled.
|
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) (scale) |
Upload speed graph, colours defined in hex, minus the #. If scale is non-zero, it becomes the scale for the graph.
|
uptime |
|
Uptime
|
uptime_short |
|
Uptime in a shorter format
|
seti_prog |
|
Seti@home current progress
|
seti_progbar |
(height),(width) |
Seti@home current progress bar
|
seti_credit |
|
Seti@home total user credit
|
voffset |
(pixels) |
Change verticle offset by N pixels. Negative values will cause text to overlap. See also $offset.
|