Skip to content

Configuration Variables

Georgi Valkov edited this page Dec 26, 2012 · 1 revision

This is a list of all variables that are available in the most recent git version of conky, this list is automatically updated daily. Remember, "the most recent git version" is not the same as "the most recent stable version", so if you are using the version of conky provided by your distribution some of these vars may not be available to you. Variables should placed like this in the configfile:

Old syntax

  • The variables should be used inside the text section, that's everything after the TEXT line that ends the configuration settings.

  • Variables without an argument should be written like this $variable. Variables that have arguments should be written like this ${variable argument1 argument2}.

Example:

TEXT
I am on ${wireless_ap wlan0} and there
are $user_number users on my system

New syntax (Conky 2.0 and higher)

The new syntax is in lua so if you know lua you can also write your configfile in other ways, if you don't know lua follow the rules below:

  • The variables should be used inside the text section. Start the text section with conky.text = \[\[ and end it with \]\].

  • Variables without a argument should be written like this $variable. Variables that have arguments should be written like this ${variable argument1 argument2}

Example:

conky.text = [[
I am on ${wireless_ap wlan0} and there
are $user_number users on my system
]]