---

CoolerDash 🐧

This tool allows you to monitoring (display) real-time telemetry data from sensors on an AIO liquid cooler with an integrated LCD display.

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

---

Features

• Plug-In that extends the LCD functionality of CoolerControl
• Support for additional sensor values (CPU/GPU/Liquid)
• Integrated UI interface for customizing all settings
• Display modes - for now
  • Dual Mode (default): Shows CPU and GPU temperatures simultaneously
  • Circle Mode (beta): Alternates between CPU and GPU switch every 5 sec

Special thanks to @codifryed, the founder of CoolerControl

---

System Requirements

Warning

Version 2.0.4+ runs as a CoolerControl plugin. This requires CoolerControl >=3.1.0 with plugin support.

• 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.

---

Installation

Arch-based distributions

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

Distributions pre-builted packages:

Manual installation: All distributions

# 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

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

---

Configuration

Start CoolerControl Service (if not already enabled):

systemctl enable --now coolercontrold.service

CoolerDash Configuration (optional):

In the CoolerControl settings menu, under the plugin tab (beta), you can now use the CoolerDash UI to make your custome settings. Please restart: systemctl restart cc-plugin-coolerdash.service to apply the changes.

Screenshots

comming soon...

---

Advanced Usage

Expand

Build Commands

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

Debugging Steps

# 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

---

Troubleshooting

Expand

Installation Issues

If you see errors like "conflicting files" or "manual installation detected" during Arch/AUR makepkg -si, CoolerDash was previously installed manually via make install.

Solution:

sudo make uninstall

Remove any leftover legacy files:

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

Check CoolerControl devices

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
      }
}

---

Documentation

Expand

• Configuration Guide - All configuration options
• Supported Devices - Confirmed working hardware
• Display Modes Guide - Dual and Circle mode reference
• Developer Guide - Architecture and API integration
• Display Detection - Display shape detection
• CoolerControl API Guide - API module documentation

---

Community & Support

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

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