Use it successfully myself – maybe it will help you too! ❤️

• Extends the LCD functionality of CoolerControl with additional features.
• Support for additional sensor values, and a sophisticated, customizable user interface.
• Two display modes:
  • Dual Mode (default): Shows CPU and GPU temperatures simultaneously
  • Circle Mode (beta): Alternates between CPU and GPU every 5 sec. - optimized for round high-resolution displays (>240x240px)

Special thanks to @codifryed, the founder of CoolerControl

• OS: Linux
• CoolerControl: Version >=3.1.0 REQUIRED - must be installed and running Installation Guide
• CPU: x86-64-v3 compatible (Intel Haswell+ / AMD Excavator+)
• LCD: AIO liquid cooler LCD displays (NZXT, etc.)

See the Supported Devices for confirmed working hardware. In principle, all devices supported by CoolerControl/liquidctl should work with CoolerDash. You can submit a device confirmation to help expand the list.

• Using an AUR helper:

# STEP 1: Install
yay -S coolerdash-git
#OR any other AUR helper

• Manual installation:

# STEP 1: Clone repository
git clone https://github.com/damachine/coolerdash.git
cd coolerdash

# STEP 2: Build and install (auto-detects Linux distribution and installs dependencies)
make install

# STEP 3: Reload systemd configuration
systemctl daemon-reload

# STEP 4: Restart CoolerControl to load the plugin
sudo systemctl restart coolercontrold

For manual installations, make sure all required dependencies are installed correctly. Manual installations need to be updated manually.

Start CoolerControl Service (if not already enabled):

systemctl enable --now coolercontrold.service

CoolerDash Configuration (optional):

Edit /etc/coolercontrol/plugins/coolerdash/config.ini and adjust settings as needed.

Then restart: systemctl restart cc-plugin-coolerdash.service to apply the changes.

Display Modes:

• Dual (default): CPU + GPU simultaneously (all displays)
• Circle: Alternates CPU/GPU every 5s (round displays >240x240px)

Enable Circle Mode: Edit config.ini → [display] section → mode=circle

make            # Standard C99 build
make clean      # Clean up
make install    # System installation with dependency auto-detection
make uninstall  # Remove installation (service, binary, files)
make debug      # Debug build with AddressSanitizer
make help       # Show all options

# 1. Check CoolerControl status
systemctl status coolercontrold
curl http://localhost:11987/devices

# 2. Test CoolerDash manually (with clean output)
/etc/coolercontrol/plugins/coolerdash/coolerdash

# 3. Test CoolerDash with detailed verbose logging
/etc/coolercontrol/plugins/coolerdash/coolerdash --verbose
# or short form:
/etc/coolercontrol/plugins/coolerdash/coolerdash -v

# 4. Debug build for detailed information (if needed)
make debug && /etc/coolercontrol/plugins/coolerdash/coolerdash --verbose

# 5. Check plugin logs (STATUS messages always visible)
journalctl -xeu coolercontrold.service -f

# 6. View recent logs with context
journalctl -u coolercontrold.service -n 50

sudo make uninstall

sudo rm -rf /opt/coolerdash/ \
            /etc/coolerdash/ \
            /etc/systemd/system/coolerdash.service

liquidctl --version
# Expected: liquidctl v1.15.0 (or newer)

curl http://localhost:11987/devices | jq

{
      "name": "NZXT Kraken 2023",
      "type": "Liquidctl",
      "type_index": 1,
      "uid": "8d4becb03bca2a8e8d4213ac376a1094f39d2786f688549ad3b6a591c3affdf9",
      "lc_info": {
        "driver_type": "KrakenZ3",
        "firmware_version": "2.0.0",
        "unknown_asetek": false
      }
}

Questions or ideas? Join our Discussions or open an Issue.

Support the project:
• ⭐ Star this repo
• 🐛 Report bugs
• 🔄 Share with others
• 📝 Contribute
•