# liquidctl/liquidctl

Cross-platform CLI and Python drivers for AIO liquid coolers and other devices

Repository: https://github.com/liquidctl/liquidctl
Canonical: https://ross.abutalabs.com/products/liquidctl
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: corsair, evga, nzxt, liquid-cooler, fan-controller, power-supply, led-controller, gigabyte, asus, dram, graphics-card, aquacomputer, cross-platform, driver, python
Last push: 2026-06-16T10:34:48+00:00

## Health v2 (maintenance only)
Score: 74/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 87, release rhythm 41, longevity 100
- inputs: {"age_days": 2960, "days_push": 78, "days_rel": 183, "gap_med": 212.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2670, forks 290 (observed 2026-08-28T04:07:09.422296+00:00)

## What it is
liquidctl is a cross-platform command-line tool and Python driver library for controlling AIO liquid coolers, fan controllers, LED controllers, power supplies, and other PC hardware from brands like NZXT, Corsair, ASUS, and EVGA. It lets users monitor temperatures and fan speeds and configure fan curves, pump speeds, and RGB lighting from the terminal or scripts.

## Use cases
- control nzxt kraken fan speed from linux
- set rgb lighting on corsair ram
- monitor liquid temperature and pump speed
- automate fan curves at boot with systemd
- control asus aura led strips from command line
- read power supply status in scripts
- control aquacomputer devices on macos

## When to choose
- you want terminal or scriptable control of PC cooling and RGB hardware
- you need cross-platform support including Linux, macOS, Windows, and BSD
- you want to automate fan/LED settings at boot or via cron/systemd

## When to avoid
- you want a polished GUI for fan and RGB control
- your device is not on the supported hardware list
- you need low-level sensor monitoring of arbitrary system components beyond supported devices

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, monitoring, configuration-management
- domain: hardware, developer-tools
- platform: windows, bsd, python, cross-platform, cli
- tags: liquid-cooler, fan-controller, led-controller, power-supply, rgb-lighting, aio-cooler, hardware-monitoring, usb-hid, dram, graphics-card, driver, command-line, linux, macos

## Member repositories
- liquidctl/liquidctl (main) score 74

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:09.422296+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:18:10.739877+00:00, confidence not recorded.
  - readme: https://github.com/liquidctl/liquidctl (fetched 2026-08-28T04:07:09.422296+00:00, sha 8d505069e257)
  - registry_pypi: https://pypi.org/pypi/liquidctl/json (fetched 2026-08-29T10:00:46.794164+00:00, sha 9c7501a23234)
- Data as of 2026-08-30T08:39:29.467469+00:00.