{"id":47604544,"url":"https://github.com/jxai/lean-conky-config","last_synced_at":"2026-04-01T19:04:13.791Z","repository":{"id":41885684,"uuid":"343713571","full_name":"jxai/lean-conky-config","owner":"jxai","description":"Lean Conky config that just works","archived":false,"fork":false,"pushed_at":"2026-03-31T00:38:31.000Z","size":1425,"stargazers_count":169,"open_issues_count":2,"forks_count":35,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-03-31T03:41:58.497Z","etag":null,"topics":["conky","conky-config","conky-configurations","conky-theme","conkyrc","linux-desktop","system-monitoring"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jxai.png","metadata":{"files":{"readme":"docs/README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["jxai"]}},"created_at":"2021-03-02T09:18:36.000Z","updated_at":"2026-03-31T00:38:35.000Z","dependencies_parsed_at":"2024-09-06T12:57:08.044Z","dependency_job_id":"4d18b562-89fc-497e-be6e-aed19b2d71cb","html_url":"https://github.com/jxai/lean-conky-config","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/jxai/lean-conky-config","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxai%2Flean-conky-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxai%2Flean-conky-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxai%2Flean-conky-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxai%2Flean-conky-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jxai","download_url":"https://codeload.github.com/jxai/lean-conky-config/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jxai%2Flean-conky-config/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291029,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["conky","conky-config","conky-configurations","conky-theme","conkyrc","linux-desktop","system-monitoring"],"created_at":"2026-04-01T19:04:08.578Z","updated_at":"2026-04-01T19:04:13.777Z","avatar_url":"https://github.com/jxai.png","language":"Lua","funding_links":["https://github.com/sponsors/jxai"],"categories":[],"sub_categories":[],"readme":"# Lean Conky Config\n\n\u003cimg align=\"right\" height=\"800\" src=\"./screenshot.jpg\"\u003e\n\nLean Conky Config (LCC) is, well, a lean [Conky](https://github.com/brndnmtthws/conky/wiki) config that just works.\n\n## Features\n\n- **Simple**: works out of the box, automatically discovers storage, network etc.; supports **any** screen resolution (4K, 2K, 1080p ...) with a **single config**\n- **Elegant**: clean, sleek and functional layout\n- **Customizable**: pick the components you love to build the panel, change colors and fonts with ease\n- **Extensible**: modular system, template-based component design, easy to extend\n\n## Installation\n\nLCC works with Conky 1.10.0 or above. If you haven't, install Conky first. On Ubuntu/Debian:\n\n```bash\nsudo apt install conky\n```\n\nFor other operating systems, refer to [Conky documentation](https://github.com/brndnmtthws/conky/wiki/Installation).\n\nYou can find the latest release of LCC [here](https://github.com/jxai/lean-conky-config/releases/latest), to install just download the package and decompress it into a directory of your choice. If you want to try the current dev version, download [this file](https://github.com/jxai/lean-conky-config/archive/refs/heads/master.zip) instead, or clone the repository:\n\n```bash\ngit clone https://github.com/jxai/lean-conky-config [/path/to/lean-conky-config]\n```\n\nIf `~/.config/conky` doesn't exist yet, you may simply use that path which is the default for Conky config.\n\nIt is recommended to install the [LCC font](#Enabledisable-LCC-font), but that is optional.\n\n## How to Run\n\nStart Conky/LCC by:\n\n```bash\n/path/to/lean-conky-config/start-lcc.sh\n```\n\nIn a few seconds you should see the panel showing up, docked to the right side your desktop. If you have multiple monitors, the panel should appear on one of them.\n\nIf there are Conky instances running already, the LCC script will terminate them first. The script is selective and only kills processes started by itself.\n\n### Use AppImage or a custom Conky binary\n\nYou might have installed Conky [as an AppImage](https://github.com/brndnmtthws/conky#quickstart) or built it from source, and the binary is not at a standard location. If it is the only Conky installation, you might simply symlink to it from system paths (e.g. `~/.local/bin` or `/usr/local/bin`). In case you have multiple Conky executables and want a specific one for LCC to use, start it this way:\n\n```bash\n/path/to/lean-conky-config/start-lcc.sh -p /path/to/your/conky\n```\n\nConky [releases](https://github.com/brndnmtthws/conky/releases) AppImage packages officially, give it a try if a more recent version is preferred. For instance, if the network meters [show nothing](brndnmtthws/conky#1307), you might need v1.17 or above.\n\n### Auto-start\n\nIn order to auto-start Conky on Ubuntu, follow [this tutorial](https://linuxconfig.org/ubuntu-20-04-system-monitoring-with-conky-widgets#h2-enable-conky-to-start-at-boot), replacing Command with the `start-lcc.sh` command line you have run successfully (note that you need to specify the full path to the script). For other desktop environments, check the information [here](https://wiki.archlinux.org/index.php/Autostarting#On_desktop_environment_startup).\n\n### Enable/disable LCC font\n\nYou might have noticed the icons and LCD-style time in the screenshot above. LCC renders them with a custom font named `LeanConkyConfig`, which is automatically installed in your local font directory (`~/.local/share/fonts`) when LCC starts. If you don't see the font in effect, likely your desktop environment doesn't load it properly. In this case you can manually install the font, located at `font/lean-conky-config.otf`. This is optional though. LCC is designed to just work, it would fall back gracefully instead of breaking the layout, even if the font is not loaded by the system.\n\nIn case you prefer the plain font and simple layout, here's a workaround to disable the LCC font:\n\n```bash\n/path/to/lean-conky-config/font/install -u \u0026\u0026 \\\ntouch ~/.local/share/fonts/lean-conky-config.otf\n```\n\nAnd to re-enable it:\n\n```bash\n/path/to/lean-conky-config/font/install -f\n```\n\n### Automatic device discovery\n\nUnlike many other Conky configs out there, LCC works out of the box. It automatically discover network interfaces and mounted disks, so you don't have to manually configure them. Moreover, it monitors device changes. When WiFi is toggled, the NETWORK section is dynamically updated; and when you plug/unplug USB drives, DISK USAGE will reflect almost instantly.\n\n## Customization\n\nWhile LCC is made to work out of the box, it is also designed to serve your needs for customization. To get started, create your local configuration file `local.conf`:\n\n```bash\ncp local.conf.example local.conf\n```\n\nand make changes there (instead of directly in `conky.conf`), this way your custom settings wouldn't get lost when LCC itself is updated.\n\n### Scale to fit your screen\n\nIn a plain Conky config, layout parameters (`voffset` and `goto` values, font sizes etc.) are hard-coded, making it difficult to adapt to different screen resolutions. When you try a new config from the web, you might find it to appear too large or too small on your desktop, and have to manually adjust many parameters, rather tedious work.\n\nLCC addresses this issue elegantly. To globally scale the panel while **preserving the layout**, simply change the `lcc.config.scale` variable in your `local.conf`, a value larger than 1 magnifies the LCC panel to fit a monitor of higher resolution.\n\nUnder the hood, LCC achieves this by offering a few transform functions (defined in `tform.lua`), which you can apply to numerical values that need to be changed on-the-fly:\n\n- `T_.sr`: **s**cale and **r**ound to the nearest integer, suitable for most use cases where an integer value is required.\n- `T_.sc`: **sc**ale to a floating-point number, suitable for situations where precise sizing is desired, e.g. font size.\n- `T_.sh`: **s**cale to a multiple of 0.5 (**h**alf), _might_ be useful in case such an option is needed.\n\nFor values embedded in a string, wrap them with `$sr{}`/`$sc{}` and tranform the whole string with the `T_` function, e.g.:\n\n```lua\nfont = T_ \"sans-serif:normal:size=$sc{8}\"\n```\n\n### Pick your favorite colors and fonts\n\nColors can be customized through standard Conky settings.\n\nTo make it easy to customize fonts, LCC implements a **named fonts** mechanism. Fonts for different elements are defined in the `lcc.fonts` table.\n\nCheck `local.conf.example` to see how various settings can be customized. For a full reference, dig `conky.conf`.\n\n### Components\n\nLCC is modular. The panel consists of components which you can freely pick and organize. Currently the following core components are available:\n\n- `datetime`\n- `weather`\n- `system`\n- `cpu`\n- `memory`\n- `storage`\n- `network`\n\nTo include any of them, add an entry in the `lcc.panel` table, e.g.:\n\n```\n{ \"\u003ccomponent\u003e\", [\u003carg1\u003e, \u003carg2\u003e, ...] },\n```\n\nIf no arguments are required, the entry can just be a string:\n\n```\n\"\u003ccomponent\u003e\",\n```\n\nCheck `local.conf.example` for examples. You might notice a special component `vspace`, which is used to trim the trailing panel space at the bottom. It can also insert a vertical spacing if a positive height is given.\n\n### Weather\n\nThe `weather` component shows current conditions and a 3-day forecast. It supports the following options:\n\n- `location` (default: `\"auto\"`): Location to query weather for. If `\"auto\"`, it is guessed from your IP. If the auto location is not accurate, specify a city name (e.g. `\"London\"` or `\"London, UK\"`) or coordinates (e.g. `\"51.5,-0.12\"`).\n- `interval` (default: `900`): Interval in seconds to refresh weather data.\n- `backend` (default: `\"openmeteo\"`): Weather data provider. Supported backends are `\"openmeteo\"` ([Open-Meteo](https://open-meteo.com/)) and `\"wttrin\"` ([wttr.in](https://wttr.in/)).\n- `metric` (default: `1`): Set to `0` for imperial units (°F, mph, in), or `1` for metric (°C, km/h, mm).\n\n### GPU support\n\nLCC comes with a component supporting Nvidia GPUs, `gpu.nvidia`, which is not enabled by default (because not every system is equipped with an Nvidia GPU). To enable it, add a `gpu.nvidia` entry to `lcc.panel`.\n\nUnder the hood, `gpu.nvidia` has two backends. The preferred one depends on Python and `pynvml`, and you need to install that package first, e.g.:\n\n```bash\npip install pynvml\n```\n\nIf the `pynvml` backend doesn't work, `gpu.nvidia` falls back to a backend offered by Conky itself, which is less powerful. In case your Conky was not compiled with `nvidia` support, an error message would show up in the LCC panel.\n\n### Customize storage mountpoints\n\nIn the STORAGE section, LCC by default shows mountpoints from local filesystems most commonly found on major Linux distros. In case you don't see some of your drives, or on the other hand would rather hide certain mountpoints, LCC offers several configurable options in `lcc.config` to help you:\n\n- `storage_include_fs`: Extra filesystem types to show, specified as a comma-separated string e.g. `\"cifs,nfs\"`. To find the supported types, you may check `/proc/filesystems` or `/lib/modules/$(uname -r)/kernel/fs`.\n- `storage_exclude_fs`: Filesystems you want to hide, a comma-separated string e.g. `\"fat,ntfs\"`.\n- `storage_exclude_paths`: An array of [Lua patterns](https://www.lua.org/pil/20.2.html) matching specific mountpoints you want to hide. If a mountpoint matches any of the patterns it won't show up. Check `local.conf.example`.\n\n## More Information\n\nCheck official Conky documentation:\n\n- [Configuration Settings](http://conky.sourceforge.net/config_settings.html)\n- [Objects/Variables](http://conky.sourceforge.net/variables.html)\n\nIn fact, the `man` page might provide more up-to-date information for the Conky version installed on your system:\n\n```bash\nman -P \"less -p 'CONFIGURATION SETTINGS'\" conky\nman -P \"less -p 'OBJECTS/VARIABLES'\" conky\n```\n\nAlso, here is a great [third-party reference](http://www.ifxgroup.net/conky.htm) with examples.\n\n## Support\n\nIf you find this project useful, consider [becoming a sponsor :heart:](https://github.com/sponsors/jxai) to help me keep it maintained and evolving.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjxai%2Flean-conky-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjxai%2Flean-conky-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjxai%2Flean-conky-config/lists"}