cm-rgb-monitor - Man Page

drive the CM RGB / Wraith Prism LEDs from live CPU load, temperature and fan speed

Synopsis

cm-rgb-monitor [Options]

Description

cm-rgb-monitor runs continuously, sampling CPU load (and optionally temperature and fan speed via lm-sensors/psutil), and updates the cooler's LEDs to reflect those readings in real time: the ring shows CPU load as a rotating arc, and the logo/fan LEDs can optionally show temperature or CPU frequency as a color gradient, or strobe in sync with fan speed (mirage effect).

Options

--bg-color HEX

Background LED color (default: #00FFFF).

--cpu-color HEX

Color of the CPU-load LEDs (default: #FFA500).

--brightness 1-5

LED brightness, clamped to 1–5 (default: 4).

--interval SECONDS

Update interval, 0.01–60 (default: 0.2).

--verbose

Print CPU load and sensor readout to stdout.

--show-temp

Show the selected temperature sensor's reading on the cooler's fan LED.

--temp-source CHIP/FEATURE

Temperature source, given as <chip>/<feature> (e.g. k10temp/Tdie, the default). Use --list-temp-sources to see what's available on the current system.

--temp-low DEGREES

Temperature considered "low" for the color gradient (default: 50).

--temp-high DEGREES

Temperature considered "high" for the color gradient (default: 80).

--temp-low-color HEX

Color representing low temperature (default: #00FFFF).

--temp-high-color HEX

Color representing high temperature (default: #FFA500).

--show-cpu-frequency

Show current CPU frequency on the logo LED as a color gradient.

--freq-low-color HEX

Color representing low CPU frequency (default: #00FFFF).

--freq-high-color HEX

Color representing high CPU frequency (default: #FFA500).

--smoothing 0-1

Smoothing applied to measured values so LED color changes are less jumpy; 0 disables smoothing, values near 1 average heavily over time (default: 0.8).

--mirage

Enable the mirage effect: strobe the fan LED at a frequency derived from current fan speed.

--mirage-fan CHIP/INDEX

Fan speed source for the mirage effect, given as <chip>/<index> (default: nct6797/1).

--mirage-factors R,G,B

Fan speed-to-mirage-frequency factor(s), as one shared value or a comma-separated red,green,blue triplet. Experiment with different values to change the strobe pattern (default: 7.0,7.0,7.0).

--list-temp-sources

Print available <chip>/<feature> temperature sources detected via lm-sensors and exit.

--help

Show a summary of options and exit.

Examples

Show CPU load on the ring and temperature on the fan LED:

cm-rgb-monitor --show-temp

List available temperature sensors to pick a --temp-source:

cm-rgb-monitor --list-temp-sources

Enable the mirage fan-speed strobe effect with custom factors:

cm-rgb-monitor --mirage --mirage-factors 5.0,7.0,9.0

See Also

cm-rgb-cli(1), cm-rgb-gui(1)

Author

gfduszynski

Referenced By

cm-rgb-cli(1), cm-rgb-gui(1).

2026 cm_rgb 0.4.0