Version Release License Conky Lua Platform Issues Last Commit

Status: Stable
Current Version: v2.0
Legacy Version: v1.10 (Lua-based, archived)

• 🇺🇸 You are reading the English version.
• 🇧🇷 Portuguese version

Version 2.0 – Complete migration from legacy Conky 1.10 + Lua to a pure Conky 1.22+ configuration, no language Lua required.

This project provides a modern, elegant, and highly customizable Conky setup, featuring:

• 🌦️ Weather (OpenWeatherMap)
• 🌙 Moon phases (local generation, no NASA dependency)
• 📊 CPU / RAM / Disk / Network monitoring
• 🧩 NVIDIA GPU stats (optional)
• 🖥️ Multi-resolution layouts (1080p / 2K)
• 🌍 Multi-language support (EN / PT-BR auto-detected)
• ❌ Fully Lua-free configuration
• 🚀 Compatible with AppImage (no installation required)

conky/
├── conkyrc/
│ ├── .conkyrc_1080p
│ └── .conkyrc_2k
├── images/
│ ├── weather icons
│ └── wind icons
├── fonts/
├── printscreen/
├── time.sh
├── GetMoon.sh
├── lune_die.sh
├── moon.pl
├── moon_age.pl
├── moon_texture.jpg
├── conky.sh
└── README.md

Legacy support is preserved in:

• Branch: legacy-1.10
• Tag: v1.10-legacy

This project follows Semantic Versioning and documents all notable changes in CHANGELOG.md.

print

• Conky ≥ 1.22
• curl
• xmllint
• perl
• lm-sensors

• nvidia-smi (for NVIDIA GPUs)

Weather data uses OpenWeatherMap XML API.

The first 1,000 API calls per day are FREE

👉 https://openweathermap.org/api

mkdir -p ~/.config/conky
nano ~/.config/conky/secrets.conf
chmod 600 ~/.config/conky/secrets.conf

OWM_APPID=YOUR_API_KEY_HERE

The key is never hardcoded in .conkyrc.

Moon phases are generated locally, no HTTP requests.

• Replaces the old NASA-based solution
• Works on both v1.10 and v2.0
• Supports PT-BR translation automatically

Scripts involved:

• GetMoon.sh
• lune_die.sh
• moon.pl
• moon_age.pl

Internal Scripts

• time.sh
  Central weather, wind, moon, and localization logic. All data parsing and language switching happens here.

No installation required.

git clone https://github.com/wekers/conky.git
cd conky
# download AppImage from https://github.com/brndnmtthws/conky/releases
chmod +x conky-ubuntu-24.04-x86_64-v1.22.2.AppImage
./conky-ubuntu-24.04-x86_64-v1.22.2.AppImage -c conkyrc/.conkyrc_2k

Or for Full HD:

./conky-ubuntu-24.04-x86_64-v1.22.2.AppImage -c conkyrc/.conkyrc_1080p

pip3 install pyyaml Jinja2

tar -zxvf conky-1.22.2.tar.gz
cd conky-1.22.2
mkdir build && cd build
cmake \
 -DCMAKE_INSTALL_PREFIX=/usr \
 -DBUILD_DOCS=OFF \
 -DBUILD_EXTRAS=ON \
 -DBUILD_XDBE=ON \
 -DBUILD_CURL=ON \
 -DBUILD_WLAN=ON \
 -DBUILD_RSS=ON \
 -DBUILD_PULSEAUDIO=ON \
 -DBUILD_MPD=ON \
 -DBUILD_IMLIB2=ON \
 -DBUILD_LUA_CAIRO=ON \
 -DBUILD_LUA_IMLIB2=ON \
 -DBUILD_WAYLAND=ON \
 -DBUILD_MOUSE_EVENTS=ON \
 -DCMAKE_BUILD_TYPE=Release ..
make
sudo make install

./conky.sh

or manually:

conky -c conkyrc/.conkyrc_2k

Language is auto-detected via LANG.

Applies to:

• Weather labels
• Moon phases
• Wind descriptions

This project was fully refactored in version 2.0 due to:

• Upstream API changes (NASA / Moon data)
• Conky Lua instability and maintenance cost
• Desire for a portable, AppImage-friendly setup

Version 2.0 removes all Lua dependencies and relies only on: Bash, Perl (local), and native Conky features.

• ❌ No Lua
• ✅ Native Conky objects
• ✅ Portable configs
• ✅ Easier maintenance
• ✅ Compatible with Wayland & X11
• ✅ Secure secrets handling

If you still use Conky 1.10:

git checkout legacy-1.10

Tag:

git checkout v1.10-legacy

MIT License
© Fernando Gilli