SkillAgentSearch skills...

Liquidctl

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

GenerateConvertImprove

Install / Use

/learn @liquidctl/Liquidctl
About this skill

Quality Score

0/100

Supported Platforms

Universal

README

liquidctl – liquid cooler control

Cross-platform tool and drivers for liquid coolers and other devices

Our Discord server Status of the tests CII Best Practices

$ liquidctl list
Device #0: Corsair Vengeance RGB DIMM2
Device #1: Corsair Vengeance RGB DIMM4
Device #2: NZXT Smart Device (V1)
Device #3: NZXT Kraken X (X42, X52, X62 or X72)

# liquidctl initialize all
NZXT Smart Device (V1)
├── Firmware version             1.7
├── LED accessories                2
├── LED accessory type    HUE+ Strip
└── LED count (total)             20

NZXT Kraken X (X42, X52, X62 or X72)
└── Firmware version    6.2

# liquidctl status
NZXT Smart Device (V1)
├── Fan 1 speed            1499  rpm
├── Fan 1 voltage         11.91  V
├── Fan 1 current          0.05  A
├── Fan 1 control mode      PWM
├── Fan 2 [...]
├── Fan 3 [...]
└── Noise level              61  dB

NZXT Kraken X (X42, X52, X62 or X72)
├── Liquid temperature    34.7  °C
├── Fan speed              798  rpm
└── Pump speed            2268  rpm

# liquidctl status --match vengeance --unsafe=smbus,vengeance_rgb
Corsair Vengeance RGB DIMM2
└── Temperature    37.5  °C

Corsair Vengeance RGB DIMM4
└── Temperature    37.8  °C

# liquidctl --match kraken set fan speed  20 30  30 50  34 80  40 90  50 100
# liquidctl --match kraken set pump speed 70
# liquidctl --match kraken set sync color fixed 0080ff
# liquidctl --match "smart device" set led color moving-alternating "hsv(30,98,100)" "hsv(30,98,10)" --speed slower

Contents

  1. Supported devices
  2. Installation
    1. Linux distributions
    2. [macOS Homebrew]
    3. [FreeBSD and DragonFly BSD Ports]
    4. [Manual installation]
      1. [Linux dependencies]
      2. [macOS system dependencies]
      3. [Windows system dependencies]
      4. [Creating a virtual environment]
      5. [Installing from PyPI or GitHub]
      6. [Allowing access to the devices]
      7. [Additional files]
    5. [Working locally]
  3. [The command-line interface]
    1. [Listing and selecting devices]
    2. [Initializing and interacting with devices]
    3. [Supported color specification formats]
  4. [Using liquidctl in other programs and scripts]
  5. [Automation and running at boot]
    1. [Set up Linux using systemd]
    2. [Set up Windows using Task Scheduler]
    3. [Set up macOS using various methods]
  6. [Troubleshooting]
  7. [Additional documentation]
  8. [License]
  9. [Related projects]

Supported devices

The following devices are supported by liquidctl. In the table, MRLV stands for the minimum recommended liquidctl version. The linked documents contain specific usage instructions and other useful information.

<!-- The table is manually sorted to keep certain device families, like confusing generations of Corsair coolers and NZXT Smart Devices, in chronological order. Categories are sorted in a somewhat subjective "from more to less liquid control-ly" order. Common prefixes or suffixes are deduplicated and brought before device differentiators: for example, "Platinum H100i, H100i SE, H115i" instead of "H100i Platinum, H100i Platinum SE, H115i Platinum". If a newly supported device is a member of an already supported family, the family is temporarily split between old and new devices until the next release. Device notes are sorted alphabetically, major (upper case) notes before minor (lower case) ones. -->

| Type | Device family and specific documentation | Notes | MRLV | | :-- | :-- | :-- | :-: | | AIO liquid cooler | ASUS Ryujin II 360 | p | 1.14.0 | | AIO liquid cooler | ASUS Ryujin III 360, EVA, Extreme, White | p | 1.16.0 | | AIO liquid cooler | ASUS Ryuo I 240 | p | 1.16.0 | | AIO liquid cooler | Corsair Hydro H110i GT | p | 1.14.0 | | AIO liquid cooler | Corsair Hydro H80i GT, H100i GTX, H110i GTX | Z | 1.9.1 | | AIO liquid cooler | Corsair Hydro H80i v2, H100i v2, H115i | Z | 1.9.1 | | AIO liquid cooler | Corsair Hydro Pro H100i, H115i, H150i | Z | 1.9.1 | | AIO liquid cooler | Corsair Hydro Platinum H100i, H100i SE, H115i | | 1.8.1 | | AIO liquid cooler | Corsair Hydro Pro XT H60i, H100i, H115i, H150i | | 1.8.1 | | AIO liquid cooler | Corsair iCUE Elite Capellix H100i, H115i, H150i | Bp | 1.14.0 | | AIO liquid cooler | Corsair iCUE Elite RGB H100i, H115i, H150i | | 1.14.0 | | AIO liquid cooler | EVGA CLC 120 (CL12), 240, 280, 360 | Z | 1.9.1 | | AIO liquid cooler | Lian Li GA II LCD | p | 1.16.0 | | AIO liquid cooler | MSI MPG Coreliquid K360 | p | 1.14.0 | | AIO liquid cooler | NZXT Kraken M22 | | 1.10.0 | | AIO liquid cooler | NZXT Kraken X40, X60 | LZ | 1.9.1 | | AIO liquid cooler | NZXT Kraken X31, X41, X61 | LZ | 1.9.1 | | AIO liquid cooler | NZXT Kraken X42, X52, X62, X72 | h | 1.11.1 | | AIO liquid cooler | NZXT Kraken X53, X63, X73 | h | 1.11.1 | | AIO liquid cooler | NZXT Kraken Z53, Z63, Z73 | h | 1.14.0 | | AIO liquid cooler | NZXT Kraken 2023 Standard, Elite | p | 1.14.0 | | AIO liquid cooler | NZXT Kraken 2024 Elite RGB | p | 1.15.0 | | AIO liquid cooler | NZXT Kraken 2024 Plus | | 1.16.0 | | Pump controller | Aquacomputer D5 Next | hp | 1.15.0 | | Fan/LED controller | Aquacomputer Farbwerk | hp | 1.16.0 | | Fan/LED controller | Aquacomputer Farbwerk 360 | hp | 1.15.0 | | Fan/LED controller | Aquacomputer Octo | hp | 1.15.0 | | Fan/LED controller | Aquacomputer Quadro | hp | 1.15.0 | | Fan/LED controller | Corsair Commander Pro | h | 1.11.1 | | Fan/LED controller | Corsair Commander Core, Core XT, ST | Bp | 1.14.0 | | Fan/LED controller | Corsair Lighting Node Core, Pro | | 1.8.1 | | Fan/LED controller | Corsair Obsidian 1000D | | 1.9.1 | | Fan/LED controller | Lian Li Uni SL, SL v2, AL, AL v2, SL-Infinity | | 1.16.0 | | Fan/LED controller | NZXT Grid+ V3 | h | 1.11.1 | | Fan/LED controller | NZXT Smart Device | h | 1.11.1 | | Fan/LED controller | NZXT HUE 2, HUE 2 Ambient | | 1.7.2 | | Fan/LED controller | NZXT Smart Device V2 | h | 1.11.1 | | Fan/LED controller | NZXT H1 V2 | | 1.10.0 | | Fan/LED controller | NZXT RGB & Fan Controller | h | 1.11.1 | | Fan/LED controller | NZXT RGB & Fan Controller (3+6 channels) | hp | 1.12.1 | | Fan/LED controller | NZXT 2023 RGB Controller | | 1.16.0 | | Fan/LED controller | NZXT Control Hub | | git | | Power supply | Corsair HX750i, HX850i, HX1000i, HX1200i, HX1500i | h | 1.14.0 | | Power supply | Corsair ATX 3.1 HX1200i | h | 1.16.0 | | Power supply | Corsair RM650i, RM750i, RM850i, RM1000i | h | 1.14.0 | | Power supply | NZXT E500, E650, E850 | p | 1.7.2 | | Motherboard RGB | ASUS Aura LED motherboards | | 1.10.0 | | Motherboard RGB | Gigabyte RGB Fusion 2.0 motherboards | | 1.5.2 | | Graphics card RGB | Select ASUS GTX and RTX cards | BUx | 1.9.1 | | Graphics card RGB | Select EVGA GTX 1070, 1070 Ti and 1080 cards | BUx | 1.9.1 | | DDR4 memory | Corsair Vengeance RGB | BUax | 1.7.2 | | DDR4 memory | Generic DDR4 temperature sensor | BUax | 1.8.1 |

B: Broken in at least one significant way.<br> L: Requires the --legacy-690lc flag.<br> U: Requires --unsafe features.<br> Z: Requires replacing the device driver [on Windows][Windows system dependencies].<br> a: Architecture-specific limitations.<br> h: Can leverage hwmon driver.<br> p: Only partially supported.<br> x: Only supported on Linux.<br>

Installation

The following sections cover the various methods to set up liquidctl.

Linux distributions

A considerable number of Linux distributions already package liquidctl, generally at fairly recent versions.

# Alpine
sudo apk add liquidctl

# Arch/Artix/[Manjaro]/Parabola
sudo pacman -S liquidctl

# Fedora
sudo dnf install liquidctl

# Manjaro
sudo pamac install liquidctl

liquidctl

View profile

View on GitHub
GitHub Stars2.6k
CategoryDevelopment
Updated1d ago
Forks263
liquidctl/liquidctl

Languages

Python

Security Score

100/100

Audited on Mar 28, 2026

No findings