Skip to content

Configuration Settings

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

This is a list of all configuration settings that are available in the most recent git version of conky, this list is automatically updated daily. Configuration settings should be placed like this in the config file:

Old syntax

  • The configuration settings should be at the start of the configfile.

  • Each configuration setting has to be on a separate line, that line must start with the name of the setting followed by a space and the argument(s). Settings without argument(s) have the word yes or no as argument to specify if they should be set or not.

  • The configuration settings should be followed by a line that only contains the word TEXT (If there are no configuration settings, the configfile should start with this line).

Example:

update_interval 10
out_to_console yes
out_to_stderr no
TEXT

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:

  • Start the settings with conky.config = { and end them with }.

  • A setting begins with its name, is followed by a = and ends with the arguments(s) between ' or ".

  • Settings without arguments can have "yes" or "no" as arguments or you can use true or false without ' or ".

  • Settings should be seperated by a ,.

  • You should not use quotes when the argument is a number or a boolean.

Example:

conky.config={ update_interval=10, out_to_console=true, out_to_stderr="no"}

TODO: Add setting listing