# liquidctl/liquidctl

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/liquidctl-liquidctl).**

2,544 stars · 258 forks · Python · gpl-3.0

## Links

- GitHub: https://github.com/liquidctl/liquidctl
- awesome-repositories: https://awesome-repositories.com/repository/liquidctl-liquidctl.md

## Topics

`aquacomputer` `asus` `corsair` `cross-platform` `dram` `driver` `evga` `fan-controller` `gigabyte` `graphics-card` `led-controller` `liquid-cooler` `nzxt` `power-supply` `python`

## Description

liquidctl is a command line interface and set of Python drivers used to monitor and control liquid cooling hardware. It functions as a liquid cooler controller, hardware telemetry tool, and RGB lighting controller, providing a unified way to manage temperatures, fan speeds, and pump rates for all-in-one and custom loop cooling systems.

The project provides a Python hardware driver that enables programmatic control and telemetry collection without relying solely on the command line. It allows for the configuration of device lighting using standard RGB, HSV, and HSL formats.

The system includes capabilities for connected hardware identification, real-time hardware status monitoring, and the automation of hardware settings during system boot or login. It can export device lists and status information in JSON format for integration with external scripts and monitoring tools.

## Tags

### Hardware & IoT

- [AIO Cooler Management](https://awesome-repositories.com/f/hardware-iot/aio-cooler-management.md) — Provides a unified interface to configure and monitor all-in-one liquid coolers and related controllers.
- [Liquid Cooling Controllers](https://awesome-repositories.com/f/hardware-iot/liquid-cooling-controllers.md) — Provides a unified interface to monitor temperatures and configure settings for liquid cooling hardware.
- [Cooling Profile Controllers](https://awesome-repositories.com/f/hardware-iot/fan-speed-control/cooling-profile-controllers.md) — Allows precise thermal management by adjusting pump rates and fan speeds via the command line.
- [Hardware Component Control](https://awesome-repositories.com/f/hardware-iot/hardware-component-control.md) — Manages pump speeds, fan rotation, and lighting effects across coolers and controllers. ([source](https://github.com/liquidctl/liquidctl/tree/main/docs/))
- [Hardware Control CLIs](https://awesome-repositories.com/f/hardware-iot/hardware-control-clis.md) — Provides a command line interface for adjusting fan speeds, pump rates, and lighting on cooling hardware.
- [Python Hardware Drivers](https://awesome-repositories.com/f/hardware-iot/python-hardware-drivers.md) — Ships a set of Python drivers enabling programmatic control and telemetry collection from cooling hardware. ([source](https://cdn.jsdelivr.net/gh/liquidctl/liquidctl@main/README.md))
- [Hardware Configuration Automations](https://awesome-repositories.com/f/hardware-iot/hardware-configuration-automations.md) — Automatically applies hardware settings during system boot or user login via background services. ([source](https://cdn.jsdelivr.net/gh/liquidctl/liquidctl@main/README.md))
- [Hardware Device Discovery](https://awesome-repositories.com/f/hardware-iot/hardware-device-discovery.md) — Lists recognized hardware devices and filters them by bus, address, or serial number. ([source](https://cdn.jsdelivr.net/gh/liquidctl/liquidctl@main/README.md))
- [HID Device Communication](https://awesome-repositories.com/f/hardware-iot/hid-device-communication.md) — Exchanges data with cooling hardware using the Human Interface Device standard via USB reports.
- [I2C Bus Interfaces](https://awesome-repositories.com/f/hardware-iot/i2c-bus-interfaces.md) — Controls hardware components via the system management bus using I2C communication protocols.
- [Control Interfaces](https://awesome-repositories.com/f/hardware-iot/integration-performance/automotive-software-systems/vehicle-control-interfaces/python/control-interfaces.md) — Implements device drivers and command logic in Python to manage cross-platform system calls.
- [Peripheral Lighting Controllers](https://awesome-repositories.com/f/hardware-iot/peripheral-lighting-controllers.md) — Sets colors and lighting modes for hardware peripherals using hexadecimal RGB, HSV, or HSL formats. ([source](https://cdn.jsdelivr.net/gh/liquidctl/liquidctl@main/README.md))

### Operating Systems & Systems Programming

- [Hardware Drivers](https://awesome-repositories.com/f/operating-systems-systems-programming/hardware-interfacing-drivers/hardware-drivers.md) — Ships a set of Python drivers that enable programmatic control and telemetry collection from cooling devices.
- [Hardware Abstraction Layers](https://awesome-repositories.com/f/operating-systems-systems-programming/hardware-interfacing-drivers/hardware-abstraction-layers.md) — Implements a hardware abstraction layer to provide a consistent API across different cooling hardware vendors.

### Software Engineering & Architecture

- [Hardware Telemetry Tools](https://awesome-repositories.com/f/software-engineering-architecture/event-driven-architectures/hardware-telemetry-tools.md) — Functions as a hardware telemetry tool for querying real-time status and sensor data from pumps and fans.

### System Administration & Monitoring

- [Hardware Control Interfaces](https://awesome-repositories.com/f/system-administration-monitoring/hardware-control-interfaces.md) — Provides a command-line interface for modifying fan speeds, pump rates, and lighting effects. ([source](https://cdn.jsdelivr.net/gh/liquidctl/liquidctl@main/README.md))
- [Hardware Health Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/hardware-health-monitoring.md) — Tracks real-time liquid temperatures and fan speeds to ensure system stability and cooling efficiency.
- [Hardware Health Monitors](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring/hardware-health-monitors.md) — Implements a real-time telemetry system for tracking liquid temperatures and fan rotation speeds. ([source](https://cdn.jsdelivr.net/gh/liquidctl/liquidctl@main/README.md))

### Development Tools & Productivity

- [Hardware Automation Scripts](https://awesome-repositories.com/f/development-tools-productivity/python-development-tools/script-execution-engines/python-scripting-environments/automation-integrations/hardware-automation-scripts.md) — Enables the use of Python scripts and JSON exports to automate hardware settings and monitoring.

### Graphics & Multimedia

- [Cross-Platform RGB Controllers](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/lighting-systems/lighting-control-systems/cross-platform-rgb-controllers.md) — Provides a utility to manage lighting profiles and synchronize RGB effects across compatible hardware.
- [RGB Color Controllers](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/lighting-systems/lighting-control-systems/rgb-color-controllers.md) — Manages colors and lighting effects for hardware components using RGB, HSV, and HSL formats.
