liquidctl

Cross-platform command-line tool and driver suite for monitoring and controlling liquid coolers, fan controllers, and RGB lighting devices.

  • Tools & Utilities
Cross-platform command-line tool and driver suite for monitoring and controlling liquid coolers, fan controllers, and RGB lighting devices. Provides a unified interface for supported cooling hardware, eliminating the need for separate vendor software, and is well suited to headless servers and containerized deployments.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

61/100 Good

Maintained
60last commit 158 days ago
Popular
692,706 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
77no serious findings, CI, tests, OpenSSF Scorecard 4.9/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 40 days ago

GitHub stars
2,706
Open issues
111
Last commit
2026-06-16
Latest release
v1.16.0
License
GPL-3.0
Activity
stale

Checked 10 days ago - source: GitHub (liquidctl/liquidctl)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install liquidctl with pip or Homebrew Use pip (Python's package installer) with `python -m pip install liquidctl` on most systems, or `brew install liquidctl` on macOS, to install the stable version. This gives you the `liquidctl` command; without it you cannot control your cooling or RGB hardware. source
  • Run liquidctl initialize all After installing, run `liquidctl initialize all` to set up every connected device. If you skip this, devices may not respond correctly or may not report their firmware versions. source
  • Reinitialize after power-off or hardware changes For some devices such as NZXT Kraken, run `liquidctl initialize` again after a full power-off (Mechanical Off) or after changing cables or accessories. This refreshes device detection so fans, pumps, and LEDs keep working correctly. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What command should I run after installing liquidctl to set up connected devices?

Run liquidctl initialize all after installing to set up every connected device. If you skip it, devices may not respond correctly or report firmware versions.

Can I control an AIO liquid cooler from Docker on unRAID?

The thread explains how to run liquidctl in a Docker container on unRAID to control an AIO liquid cooler. This avoids using a full Windows or Linux VM for cooler control.

How can I install liquidctl from the AUR on Arch Linux?

Install an AUR helper such as paru, then run paru liquidctl -git. It fetches dependencies, builds it, packages it, and installs or replaces the repository version.

Where can I find the complete list of liquidctl commands and options?

The complete list of commands and options is in liquidctl --help and the man page. The documentation covers the most common operations.

Answers sourced from github.com, github.com, www.reddit.com, www.reddit.com

Community

Collected 53 days ago - public community threads