MCPcopy Index your code
hub / github.com/codifryed/coolercontrol

github.com/codifryed/coolercontrol @4.3.1

Chat with this repo
repository ↗ · DeepWiki ↗ · release 4.3.1 ↗ · + Follow
5,470 symbols 16,735 edges 446 files 875 documented · 16%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

CoolerControl CoolerControl

Powerful cooling control and monitoring for Linux 🐧

[Install](https://docs.coolercontrol.org/getting-started.html) · [Hardware Support](https://docs.coolercontrol.org/hardware-support.html) · [Documentation](https://coolercontrol.org) · [Discord](https://discord.gg/MbcgUFAfhV)

CoolerControl is an open-source application for monitoring and controlling supported cooling devices on Linux. It features a system daemon with a built-in Web UI, an optional desktop app, and a comprehensive REST API.

Features

  • System daemon with built-in Web UI and optional desktop application
  • Auto-detection of hwmon/sysfs, liquidctl, NVIDIA, and AMD GPU devices
  • GPU fan control for most NVIDIA and AMD GPUs
  • Customizable Profiles (Fixed, Graph, Mix, Overlay) applied to any fan or pump
  • Functions for hysteresis, thresholds, directionality, and response-time control
  • System-wide Modes to switch all device settings at once
  • Custom Sensors from files or combinations of existing sensors
  • Dashboards and Alerts for monitoring and anomaly detection
  • Headless and remote access support
  • Reapplies settings after sleep

For the full feature set and configuration guides, see the documentation.

Installation

See the Getting Started page for install instructions for all supported distributions (Arch, Debian/Ubuntu, Fedora, openSUSE, Nix, Gentoo, Unraid, Docker, AppImage, and source builds).

Hardware Support

See the Hardware Support page for details on motherboard fans, USB AIOs, GPU fan control, laptops, and HDDs.

Problems and Questions

  • Open an issue on GitLab using one of the provided templates. Daemon logs are invaluable for bug reports.
  • Join the Discord for general questions and community support.

Contributing

Contributions are welcome. Please open an issue or discuss on Discord before submitting changes. See the contributing guidelines for details.

Support

Related Projects

  • liquidctl
    Cross-platform tool and drivers for liquid coolers and other devices.

  • fan2go
    A daemon to control the fans of your computer.

  • thinkfan
    A simple, lightweight fan control program. (ThinkPads)

  • OpenRGB
    Graphical interface to control many different types of RGB devices.

  • FanControl
    A focused and highly customizable fan controlling software for Windows.

License

This program is licensed under GPLv3+

Extension points exported contracts — how you extend this code

Sealed (Interface)
Parse the item using a format description and an input. [8 implementers]
coolercontrold/patches/time/src/parsing/parsable.rs
DeviceSupport (Interface)
It is a general purpose trait and each supported device struct must implement this trait. Many of the default methods wi [26 …
coolercontrold/daemon/src/repositories/liquidctl/supported_devices/device_support.rs
PortIo (Interface)
Trait for I/O port access - enables mocking in tests. [2 implementers]
coolercontrold/cc-detect/src/port_io.rs
DeviceLineProperties (Interface)
(no doc)
coolercontrol-ui/src/components/u-plot-plugins.ts
Sealed (Interface)
Format the item using a format description, the intended output, and the various components. [8 implementers]
coolercontrold/patches/time/src/formatting/formattable.rs
Processor (Interface)
(no doc) [7 implementers]
coolercontrold/daemon/src/engine/mod.rs
DeviceLabelNodeData (Interface)
(no doc)
coolercontrol-ui/src/components/control-flow/useOverviewGraph.ts
Parsable (Interface)
(no doc) [8 implementers]
coolercontrold/patches/time/src/parsing/parsable.rs

Core symbols most depended-on inside this repo

get
called by 831
coolercontrold/daemon/src/api/actor/mode.rs
map
called by 359
coolercontrold/patches/time/src/parsing/mod.rs
iter
called by 319
coolercontrold/daemon/src/repositories/repository.rs
borrow
called by 317
coolercontrold/patches/time/src/instant.rs
write
called by 297
coolercontrold/daemon/src/cc_fs/write.rs
send
called by 218
coolercontrol/notifier.cpp
len
called by 174
coolercontrold/daemon/src/calibration/state.rs
is_empty
called by 157
coolercontrold/daemon/src/calibration/state.rs

Shape

Function 2,367
Method 2,367
Class 550
Enum 125
Interface 61

Languages

Rust83%
TypeScript11%
Python5%
C++2%

Modules by API surface

coolercontrold/daemon/src/repositories/hwmon/hwmon_repo.rs160 symbols
coolercontrold/daemon/src/repositories/custom_sensors_repo.rs134 symbols
coolercontrold/daemon/resources/liqctld/main.py109 symbols
coolercontrol-ui/src/stores/DaemonClient.ts103 symbols
coolercontrold/daemon/src/calibration/curve.rs100 symbols
coolercontrold/daemon/src/engine/processors/functions.rs94 symbols
coolercontrold/daemon/src/repositories/liquidctl/supported_devices/device_support.rs82 symbols
coolercontrold/daemon/src/config.rs81 symbols
coolercontrold/daemon/src/repositories/hwmon/apple_mac_smc.rs76 symbols
coolercontrold/patches/time/src/offset_date_time.rs75 symbols
coolercontrold/daemon/src/calibration/diagnoser.rs70 symbols
coolercontrold/patches/time/src/parsing/parsed.rs67 symbols

For agents

$ claude mcp add coolercontrol \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact