2019-02-25 18:28:56 +00:00
|
|
|
[](https://travis-ci.org/brndnmtthws/conky) [](https://gitlab.com/brndnmtthws-oss/conky/commits/master) [](https://gitlab.com/brndnmtthws-oss/conky/commits/master)
|
|
|
|
|
|
2019-01-09 16:14:26 +00:00
|
|
|
<p align="center"><img width="300" src="logo/conky-logotype-horizontal-violet.png"></p>
|
2012-12-26 00:57:10 +00:00
|
|
|
|
|
|
|
|
**Conky** is a free, light-weight system monitor for X, that displays
|
|
|
|
|
any kind of information on your desktop.
|
|
|
|
|
|
2019-01-03 01:17:09 +00:00
|
|
|
👉 Grab the [latest release from GitHub](https://github.com/brndnmtthws/conky/releases/latest).
|
|
|
|
|
|
|
|
|
|
[📹 An introduction to Conky (YouTube)](https://www.youtube.com/watch?v=bHtpLEoRKmg&t=19s).
|
2015-11-18 15:47:45 +00:00
|
|
|
|
2019-03-03 15:27:07 +00:00
|
|
|
## Features
|
2012-12-26 00:57:10 +00:00
|
|
|
|
|
|
|
|
Conky can display more than 300 built-in objects, including support for:
|
|
|
|
|
|
2019-03-03 15:27:07 +00:00
|
|
|
- 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][], [Audacious][]).
|
|
|
|
|
- Can be extended using built-in [**Lua**](lua) support, or any of your
|
|
|
|
|
own scripts and programs ([more](https://github.com/brndnmtthws/conky/wiki#tutorial)).
|
|
|
|
|
- Built-in [**Imlib2**][imlib2] and [**Cairo**][cairo] bindings for arbitrary drawing
|
|
|
|
|
with Lua ([more](https://github.com/brndnmtthws/conky/wiki/Lua)).
|
|
|
|
|
- Runs on Linux, FreeBSD, OpenBSD, DragonFlyBSD, NetBSD, Solaris, Haiku OS, and macOS!
|
2012-12-26 00:57:10 +00:00
|
|
|
|
|
|
|
|
... and much much more.
|
|
|
|
|
|
|
|
|
|
Conky can display information either as text, or using simple progress
|
|
|
|
|
bars and graph widgets, with different fonts and colours.
|
|
|
|
|
|
2019-03-03 15:27:07 +00:00
|
|
|
## Screenshots
|
2012-12-26 00:57:10 +00:00
|
|
|
|
2013-03-28 21:29:47 +00:00
|
|
|
[](https://raw.github.com/wiki/brndnmtthws/conky/configs/brenden/screenshot.png)
|
|
|
|
|
[](https://raw.github.com/wiki/brndnmtthws/conky/configs/ke49/screenshot.png)
|
|
|
|
|
[](https://raw.github.com/wiki/brndnmtthws/conky/configs/jc/screenshot.png)
|
2012-12-26 00:57:10 +00:00
|
|
|
|
2018-08-07 19:58:41 +00:00
|
|
|
See the User Configs below for more screenshots and associated config files.
|
2012-12-26 00:57:10 +00:00
|
|
|
|
2019-03-03 15:27:07 +00:00
|
|
|
## Documentation
|
2012-12-26 00:57:10 +00:00
|
|
|
|
2013-09-13 20:49:55 +00:00
|
|
|
The [GitHub Wiki](https://github.com/brndnmtthws/conky/wiki) serves as a central hub for all of
|
2018-08-07 19:58:41 +00:00
|
|
|
Conky's documentation.
|
2012-12-26 00:57:10 +00:00
|
|
|
|
2019-03-03 15:27:07 +00:00
|
|
|
- [Installation](https://github.com/brndnmtthws/conky/wiki/Installation)
|
|
|
|
|
- [Configuration Settings](https://github.com/brndnmtthws/conky/wiki/Configurations)
|
|
|
|
|
- [User Configs](https://github.com/brndnmtthws/conky/wiki/Configs)
|
|
|
|
|
- [Frequently Asked Questions](https://github.com/brndnmtthws/conky/wiki/FAQ)
|
2012-12-26 00:57:10 +00:00
|
|
|
|
2019-03-03 15:27:07 +00:00
|
|
|
## License
|
2012-12-26 00:57:10 +00:00
|
|
|
|
2019-03-03 02:34:53 +00:00
|
|
|
Conky is licensed under the terms of the [GPLv3](LICENSE) license.
|
2012-12-26 00:57:10 +00:00
|
|
|
|
2019-03-03 15:27:07 +00:00
|
|
|
## Contributing
|
|
|
|
|
|
|
|
|
|
Contributions are welcome from anyone.
|
2016-07-13 14:29:51 +00:00
|
|
|
|
2018-08-07 19:58:41 +00:00
|
|
|
To report bugs or issues, open [new issues](https://github.com/brndnmtthws/conky/issues/new).
|
|
|
|
|
To submit code changes, open [new pull requests](https://github.com/brndnmtthws/conky/compare).
|
2016-07-13 14:29:51 +00:00
|
|
|
|
2019-03-03 15:27:07 +00:00
|
|
|
Patches submitted in issues, email, or elsewhere may be ignored. When submitting PRs, please:
|
|
|
|
|
|
|
|
|
|
- Describe the changes, why they were necessary, etc
|
|
|
|
|
- Describe how the changes affect existing behaviour
|
|
|
|
|
- Describe how you tested and validated your changes
|
|
|
|
|
- Include unit tests when appropriate
|
|
|
|
|
- Include any relevant screenshots/evidence demonstrating that the changes work and have been tested
|
|
|
|
|
- Any new source files should include a GPLv3 license header
|
|
|
|
|
- Any contributed code must be GPLv3 licensed
|
|
|
|
|
- Always leave the code better than you found it
|
|
|
|
|
- PRs with failed checks may be ignored or closed; please make sure
|
|
|
|
|
the build and checks pass if possible (and notify someone when the build
|
|
|
|
|
system is not working)
|
|
|
|
|
|
|
|
|
|
[mpd]: https://musicpd.org/
|
|
|
|
|
[xmms2]: https://github.com/xmms2/wiki/wiki
|
|
|
|
|
[audacious]: https://audacious-media-player.org/
|
2018-08-07 19:58:41 +00:00
|
|
|
[luawiki]: https://en.wikipedia.org/wiki/Lua_%28programming_language%29
|
2019-03-03 15:27:07 +00:00
|
|
|
[imlib2]: https://docs.enlightenment.org/api/imlib2/html/
|
2018-08-07 19:58:41 +00:00
|
|
|
[cairo]: https://www.cairographics.org/
|
