Home

Conky is a free, light-weight system monitor for X, that displays any information on your desktop. Conky is licensed under the GPL and runs on Linux and BSD.

The latest stable release of Conky is 1.8.1.

To learn more, you can read about Conky.

Read the documentation for FAQs, the manual, configuration settings, and installation notes for various platforms.

Visit our Sourceforge project page to file bugs, feature requests, and more.

Join us in #conky on irc.freenode.net to discuss Conky.

You can also contact us via the mailing lists.

Features

Conky has more than 300 built in objects, including support for:

• a plethora of OS stats (uname, uptime, CPU usage, mem usage, disk usage, "top" like process stats, and network monitoring, just to name a few)
• built in IMAP and POP3 support
• built in support for many popular music players (MPD, XMMS2, BMPx, Audacious)
• can be extended using built in Lua support, or any of your own scripts and programs (tell me more!)
• built in Imlib2 and Cairo bindings for arbitrary drawing with Lua (tell me more!)

... and much much more.

Conky can display this info either as text, or using simple progress bars and graph widgets, with different fonts and colours.

Screenshots

See more screenshots and their conky config files.

Getting Involved

There is always plenty to be done, such as adding new features, testing, writing docs et cetera. If you're interested in contributing, please feel free to do so by using the handy tools on the sourceforge project page, including the mailing lists. You can get the latest code by cloning the anonymous git repo like so:

$ git clone git://git.omp.am/conky.git

An online view of latest Conky is available at http://git.omp.am/?p=conky.git;a=summary

Notes on Submitting Patches

Patch submission checklist:

1. Ensure your patch applies cleanly against the latest prerelease package, or the git 'master' branch.
2. There is a script in the git repo called 'check_docs.py' used for checking documentation consistency. Please run this before submitting the patch, as it will point out anything you may have forgot to document.
3. Use the ``--enable-testing'' configure option to turn on pedantic compiler warnings. This helps to maintain Conky's portability.
4. Please use the SourceForge patch tracker to submit patches to ensure they don't get forgotten. You can also email them, but there is a good chance they will get lost in an inbox somewhere.