1LIQUIDCTL(8) System Manager's Manual LIQUIDCTL(8)
2
6 liquidctl - monitor and control liquid coolers and other devices
7
9 liquidctl [options] list
10 liquidctl [options] initialize [all]
11 liquidctl [options] status
12 liquidctl [options] set channel speed (temperature percentage) ...
13 liquidctl [options] set channel speed percentage
14 liquidctl [options] set channel color mode [color ...]
15 liquidctl --version
16 liquidctl --help
17
19 liquidctl is a utility for overseeing and controlling some hardware
20 monitoring devices not yet supported at the kernel level. Because liq‐
21 uidctl directly accesses the hardware devices, root privileges are gen‐
22 erally required, though this can be avoided with appropriate udev
23 rules.
24 liquidctl list outputs all compatible devices found on the system. In
26 case more than one device is found, the desired one can be selected for
27 later invocations with --match=substring, where substring matches part
28 of the desired device's description using a case insensitive compari‐
29 son.
30 liquidctl list --verbose enables the display of additional identifiers
32 and addresses that can also be used to select specific devices. These
33 can be better suited for certain use cases, such as non-interactive
34 scripts.
35 liquidctl initialize prepares a device for later commands, and most de‐
37 vices must be initialized after every boot or when resuming from a sus‐
38 pended state. Unless finer control is required, all devices can be
39 initialized at once with liquidctl initialize all. Some devices may
40 output some information at this stage.
41 liquidctl status displays the status of all devices that match the pro‐
43 vided filtering options.
44 liquidctl set channel speed allows the user to set fan and pump speeds.
46 These, depending on the device, can be set to fixed duty values, vari‐
47 able temperature\[u2013]duty curves, or both.
48 liquidctl set channel color allows the user to configure and set light‐
50 ing modes. Supported lighting modes and additional options vary by de‐
51 vice and are listed in later sections of this manual. Each color can
52 be specified as:
53 • hexadecimal RGB with or without prefix '0x': ff7f3f;
55 • decimal RGB triple, R,G,B ∊ [0, 255]: rgb(255,127,63);
57 • hue-saturation-value HSV triple, H ∊ [0, 360], S,V ∊ [0, 100]:
59 hsv(20,75,100);
60 • hue-saturation-lightness HSL triple, H ∊ [0, 360], S,L ∊ [0,
62 100]: hsl(20,100,62).
63 liquidctl set channel screen allows the user to configure the LCD
65 screen integrated into some AIO models.
66 liquidctl automatically detects when a kernel driver is bound to the
69 device and, whenever possible, uses it instead of directly accessing
70 the device. Alternatively, direct access to the device can be forced
71 with --direct-access.
72
74 Device selection options
75 Devices can be selected using one or more values taken from list --ver‐
76 bose.
77 -m substring, --match=substring
79 Filter devices by case insensitive substring of device descrip‐
80 tion.
81 -n number, --pick=number
83 Pick among many results for a given filter.
84 --vendor=id
86 Filter devices by hexadecimal vendor id.
87 --product=id
89 Filter devices by hexadecimal product id.
90 --release=number
92 Filter devices by hexadecimal release number.
93 --serial=number
95 Filter devices by serial number.
96 --bus=bus
98 Filter devices by bus.
99 --address=address
101 Filter devices by address in bus.
102 --usb-port=port
104 Filter devices by USB port in bus.
105 -d index, --device=index
107 (Deprecated), select device by listing index.
108 Animation options
110 Some devices and animation modes support additional options.
111 --speed=value
113 Abstract animation speed (device/mode specific).
114 --time-per-color=value
116 Time to wait on each color (seconds).
117 --time-off=value
119 Time to wait with the LED turned off (seconds).
120 --alert-threshold=number
122 Threshold temperature for a visual alert (degrees Celsius).
123 --alert-color=color
125 Color used by the visual high temperature alert.
126 --direction=string
128 If the pattern should move forward or backward.
129 --start-led=number
131 The first led to start the effect at.
132 --maximum-leds=number
134 The number of LED's the effect should apply to.
135 Other options
137 --fan-mode=channel:mode[,...]
138 Set the fan modes.
139 --single-12v-ocp
141 Enable single rail +12V OCP.
142 --pump-mode=mode
144 Set the pump mode.
145 --temperature-sensor=number
147 The temperature sensor number for the Commander Pro.
148 --legacy-690lc
150 Use Asetek 690LC in legacy mode (old Krakens).
151 --non-volatile
153 Store on non-volatile controller memory.
154 --direct-access
156 Directly access the device despite kernel drivers.
157 --unsafe=features
159 Comman-separated bleeding-edge features to enable.
160 -v, --verbose
162 Output additional information.
163 -g, --debug
165 Show debug information on stderr.
166 --json Output machine-readable JSON. Only supported with list, ini‐
168 tialize and status.
169 --version
171 Display the version number.
172 --help Show the embedded help.
174
176 1 if there was an error, 0 otherwise.
177
179 If LANG is set to C, non-ASCII characters are escaped from the output
180 of --json.
181
183 $XDG_RUNTIME_DIR/liquidctl/*, /var/run/liquidctl/*, /tmp/liquidctl/*
184 Internal data used by some drivers.
185
187 liquidctl list --verbose
188 liquidctl initialize all
189 liquidctl --match kraken set pump speed 90
190 liquidctl --product 170e set led color fading 350017 ff2608
191 liquidctl status
192
194 Aquacomputer D5 Next
195 Aquacomputer Farbwerk 360
196 Aquacomputer Octo
197 Aquacomputer Quadro
198 Cooling channels: (D5 Next): fan, pump; (Octo): fan[1-8]; (Quadro:)
199 fan[1-4]; (Farbwerk 360:) not applicable.
200 Lighting channels: not yet supported.
202 Corsair iCUE Elite Capellix H100i, H115i, H150i
204 Corsair Commander Core
205 Corsair Commander Core XT
206 Corsair Commander ST
207 Cooling channels: fans, fan[1-6]; (only non-XT/Elite Capellix:) pump.
208 Lighting channels: not yet supported.
210 Corsair Commander Pro
212 Corsair Lighting Node Pro
213 Corsair Lighting Node Core
214 Corsair Obsidian 1000D
215 Cooling channels (only Commander Pro and Obsidian 1000D): sync,
216 fan[1-6].
217 Where the fan connection types can be set with --fan-mode=chan‐
219 nel:mode[,...], where the allowed modes are: off, dc, pwm.
220 Lighting channels: (only Lighting Node Core:) led; (only Commander Pro
222 and Lighting Node Pro:) sync, led[1-2].
223 Mode #colors
225 ──────────────────────────
226 clear 0
227 off 0
228 fixed 1
229 color_shift 2
230 color_pulse 2
231 color_wave 2
232 visor 2
233 blink 2
234 marquee 1
235 sequential 1
236 rainbow 0
237 rainbow2 0
238 When applicable the animation speed can be set with --speed=value,
240 where the allowed values are: fast, medium, slow.
241 The animation direction can be set with --direction=value, where the
243 allowed values are: forward or backward. --start-led=number, the first
244 LED that the lighting effect should be for. --start-led=number, the
245 first LED that the lighting effect should be for. --maximum-led=num‐
246 ber, the number of LEDs that the lighting effect should applied to.
247 --temperature-sensor=number, The temperature sensor that should be used
248 to control the fan curves, probe 1 by default.
249 Corsair Hydro H80i GT, H100i GTX, H110i GTX
251 Corsair Hydro H80i v2, H100i v2, H115i
252 EVGA CLC 120 (CL12), 240, 280, 360
253 Cooling channels: pump, fan.
254 Lighting channels: logo.
256 Mode #colors notes
258 ────────────────────────────────────────────────────
259 rainbow 0 only available on EVGA coolers
260 fading 2
261 blinking 1
262 fixed 1
263 blackout 0 no high-temperature alerts
264 The rainbow mode speed can be configured with --speed=[1–6]. The speed
266 of the other modes is instead customized with --time-per-color (fad‐
267 ing and blinking) and --time-off (blinking only).
268 All modes except blackout support a visual high-temperature alert con‐
270 figured with --alert-threshold and --alert-color.
271 All current settings can be saved on non-volatile on-board memory by
273 passing --non-volatile to any write command. However, since write-cy‐
274 cles are limited, this option should be used sparingly.
275 Corsair H100i Pro, H115i Pro, H150i Pro
277 Cooling channels: fan, fan[1–2]; (only H150i Pro:) fan3.
278 Pump mode (initialize --pump-mode mode): quiet, balanced (default),
280 performance.
281 Lighting channel: logo.
283 Mode #colors
285 ───────────────────
286 alert 3
287 shift 2–4
288 pulse 1–4
289 blinking 1–4
290 fixed 1
291 Corsair Hydro H100i Platinum, H100i Platinum SE, H115i Platinum
293 Corsair Hydro H60i Pro XT, H100i Pro XT, H115i Pro XT, H150i Pro XT
294 Cooling channels: fan, fan[1–2]; (only H150i Pro XT:) fan3.
295 Pump mode (initialize --pump-mode mode): quiet, balanced (default), ex‐
297 treme.
298 Lighting channels: sync, led.
300 Channel Mode #colors (Platinum) #colors (Pro XT) #colors (Platinum SE)
302 ──────────────────────────────────────────────────────────────────────────────────────
303 led off 0 0 0
304 led fixed 1 1 1
305 led super-fixed 24 16 48
306 NZXT Kraken X40, X60
308 NZXT Kraken X31, X41, X61
309 Supports the same modes and options as a Corsair Hydro H80i GT (or sim‐
310 ilar), but requires --legacy-690lc to be passed on all invocations.
311 NZXT Kraken M22
313 NZXT Kraken X42, X52, X62, X72
314 Cooling channels (only X42, X52, X62, X72): pump, fan.
315 Lighting channels: logo, ring, sync.
317 Mode logo ring #colors
319 ────────────────────────────────────────
320 off yes yes 0
321 fixed yes yes 1
322 super-fixed yes yes 1–9
323 fading yes yes 2–8
324 alternating no yes 2
325 breathing yes yes 1–8
326 super-breathing yes yes 1–9
327 pulse yes yes 1–8
328 tai-chi no yes 2
329 water-cooler no yes 0
330 loading no yes 1
331 wings no yes 1
332 When applicable the animation speed can be set with --speed=value,
334 where the allowed values are: slowest, slower, normal, faster, fastest.
335 The animation direction can be set with --direction=value, where the
336 allowed values are: forward or backward.
337 NZXT Kraken X53, X63, X73
339 NZXT Kraken Z53, Z63, Z73
340 Cooling channels: pump; (only Z53, Z63, Z73:) fan.
341 Lighting channels: external; (only X53, X63, X73:) ring, logo, sync.
343 LCD screens (only Z53, Z63, Z73): lcd.
345 Mode #colors
347 ────────────────────────────────────
348 off 0
349 fixed 1
350 fading 2–8
351 super-fixed 1–40
352 alternating-[3-6] 1–2
353 pulse 1–8
354 breathing 1–8
355 super-breathing 1–40
356 candle 1
357 starry-night 1
358 loading 1
359 tai-chi 1–2
360 water-cooler 2
361 wings 1
362 When applicable the animation speed can be set with --speed=value,
364 where the allowed values are: slowest, slower, normal, faster, fastest.
365 The animation direction can be set with --direction=value, where the
366 allowed values are: forward or backward.
367 Corsair HX750i, HX850i, HX1000i, HX1200i, HX1500i
369 Corsair RM650i, RM750i, RM850i, RM1000i
370 Cooling channels: fan.
371 Lighting channels: none.
373 Setting a fixed fan speed changes the fan mode to software control. To
375 revert back to hardware control, run initialize again.
376 (Experimental feature) The +12V rails normally function in multiple-
378 rail mode. Single-rail mode can be selected by passing --sin‐
379 gle-12v-ocp to initialize. To revert back to multiple-rail mode, run
380 initialize again without that flag.
381 NZXT E500, E650, E850
383 Cooling channels: none (feature not supported yet).
384 Lighting channels: none.
386 NZXT Grid+ V3
388 Cooling channels: fan[1–6], sync.
389 Lighting channels: none.
391 NZXT Smart Device (V1)
393 Cooling channels: fan[1–3], sync.
394 Lighting channels: led.
396 Mode #colors
398 ──────────────────────────────────
399 off 0
400 fixed 1
402 super-fixed 1–40
403 fading 2–8
404 alternating 2
405 breathing 1–8
406 super-breathing 1–40
407 pulse 1–8
408 candle 1
409 wings 1
410 When applicable the animation speed can be set with --speed=value,
412 where the allowed values are: slowest, slower, normal, faster, fastest.
413 The animation direction can be set with --direction=value, where the
414 allowed values are: forward or backward.
415 NZXT Smart Device V2
417 NZXT RGB & Fan Controller
418 NZXT RGB & Fan Controller (3+6 channels)
419 NZXT HUE 2
420 NZXT HUE 2 Ambient
421 NZXT H1 V2
422 Cooling channels (only Smart Device V2, RGB & Fan Controller and H1
423 V2): fan[1–3].
424 Lighting channels (all but H1 V2): led[1–2], sync.
426 Additional lighting channels (HUE 2): led[3–4].
428 Additional lighting channels (RGB & Fan Controller (3+6 channels)):
430 led[3–6].
431 Mode #colors
433 ────────────────────────────────────
434 off 0
435 fixed 1
436 super-fixed 1–40
437 fading 2–8
438 alternating-[3-6] 2
439 pulse 1–8
440 breathing 1–8
441 super-breathing 1–40
442 candle 1
443 starry-night 1
444 wings 1
445 When applicable the animation speed can be set with --speed=value,
447 where the allowed values are: slowest, slower, normal, faster, fastest.
448 The animation direction can be set with --direction=value, where the
449 allowed values are: forward or backward.
450 ASUS Strix GTX 1050 OC
452 ASUS Strix GTX 1050 Ti OC
453 ASUS Strix GTX 1060 6GB
454 ASUS Strix GTX 1060 OC 6GB
455 ASUS Strix GTX 1070
456 ASUS Strix GTX 1070 OC
457 ASUS Strix GTX 1070 Ti
458 ASUS Strix GTX 1070 Ti Advanced
459 ASUS Strix GTX 1080
460 ASUS Strix GTX 1080 Advanced
461 ASUS Strix GTX 1080 OC
462 ASUS Strix GTX 1080 Ti
463 ASUS Strix GTX 1080 Ti OC
464 ASUS Strix GTX 1650 Super OC
465 ASUS Strix GTX 1660 Super OC
466 ASUS Strix GTX 1660 Ti OC
467 ASUS Strix RTX 2060 Evo
468 ASUS Strix RTX 2060 Evo OC
469 ASUS Strix RTX 2060 OC
470 ASUS Strix RTX 2060 Super
471 ASUS Strix RTX 2060 Super Advanced
472 ASUS Strix RTX 2060 Super Evo Advanced
473 ASUS Strix RTX 2060 Super OC
474 ASUS Strix RTX 2070
475 ASUS Strix RTX 2070 Advanced
476 ASUS Strix RTX 2070 OC
477 ASUS Strix RTX 2070 Super Advanced
478 ASUS Strix RTX 2070 Super OC
479 ASUS Strix RTX 2080 OC
480 ASUS Strix RTX 2080 Super Advanced
481 ASUS Strix RTX 2080 Super OC
482 ASUS Strix RTX 2080 Ti
483 ASUS Strix RTX 2080 Ti OC
484 ASUS TUF RTX 3060 Ti OC
485 Cooling channels: none.
486 Lighting channels: led.
488 Mode #colors
490 ────────────────────────────
491 off 0
492 fixed 1
493 flash 1
494 breathing 1
495 rainbow 0
496 Corsair Vengeance RGB
498 Cooling channels: none.
499 Lighting channels: led.
501 Mode #colors
503 ────────────────────────────
504 off 0
505 fixed 1
506 breathing 1–7
507 fading 2–7
508 When applicable the animation speed can be set with --speed=value,
510 where the allowed values are: slowest, slower, normal, faster, fastest.
511 ASUS Aura LED Controller
513 Cooling channels: none.
514 Lighting channels: led[1–4], sync.
516 Mode #colors
518 ────────────────────────────────────────────
519 off 0
520 static 1
521 breathing 1
522 flashing 1
523 spectrum_cycle 0
524 rainbow 0
525 spectrum_cycle_breathing 0
526 chase_fade 1
527 spectrum_cycle_chase_fade 0
528 chase 1
529 spectrum_cycle_chase 0
530 spectrum_cycle_wave 0
531 chase_rainbow_pulse 0
532 rainbow_flicker 0
533 gentle_transition 0
534 wave_propagation 0
535 wave_propagation_pause 0
536 red_pulse 0
537 Gigabyte RGB Fusion 2.0 5702 Controller
539 Gigabyte RGB Fusion 2.0 8297 Controller
540 Cooling channels: none.
541 Lighting channels: led[1–8], sync.
543 Mode #colors
545 ──────────────────────────────────
546 off 0
547 fixed 1
548 pulse 1
549 (double-)?flash 1
550 color-cycle 0
551 When applicable the animation speed can be set with --speed=value,
553 where the allowed values are: slowest, slower, normal, faster, fastest,
554 ludicrous.
555 EVGA GTX 1070 FTW
557 EVGA GTX 1070 FTW DT Gaming
558 EVGA GTX 1070 FTW Hybrid
559 EVGA GTX 1070 Ti FTW2
560 EVGA GTX 1080 FTW
561 Cooling channels: none.
562 Lighting channels: led.
564 Mode #colors
566 ────────────────────────────
567 off 0
568 fixed 1
569 breathing 1
570 rainbow 0
571
573 The complete documentation is available in the project's sources and
574 homepage ⟨https://github.com/liquidctl/liquidctl⟩.
575liquidctl 2023-01-08 LIQUIDCTL(8)