cpufreq-watch

# Description

cpufreq-watch (cpp-cpufreq-watch) is a Linux CPU frequency scaling monitor written in C++23 with zero external dependencies. It reads /sys/devices/system/cpu/cpu*/cpufreq/ from the kernel to obtain per core: current frequency (scaling_cur_freq), base frequency (cpuinfo_max_freq), minimum frequency (scaling_min_freq), active governor (performance/powersave/schedutil) and turbo state. Turbo boost detection compares current frequency against the core's base frequency (turbo active when cur > base). Shows an aggregate summary: online cores, total current/max frequency, utilization percentage and turbo cores. Watch mode (--watch N) with periodic refresh, total frequency delta and governor change detection. JSON output (--json) with a full snapshot: ts, cpus with id, online, cur_khz, base_khz, max_khz, governor, turbo, utilization_pct. --demo with realistic synthetic data (8 cores, mixed performance/powersave, variable turbo). --no-color with a mutable ANSI palette. ASCII load bars per core with proportional fills and turbo indicator (*). Zero dependencies: direct build with g++ -std=c++23, ideal for containers and VMs.

$ ./deploy.sh $ git clone

# Key features

$ Reads /sys/devices/system/cpu/cpu*/cpufreq/: current, base, min, max frequency and governor per core

$ Turbo boost detection: compares current frequency vs core base — turbo active when cur > base_khz

$ Aggregate summary: online cores, total frequency, utilization percentage and turbo cores

$ Watch mode (--watch N) with total frequency delta and governor change detection

$ ASCII load bars per core with proportional fills and turbo indicator (*)

$ JSON output (--json) with a full snapshot validated with python3 -m json.tool

$ --demo with realistic synthetic data (8 mixed cores) and --no-color with a mutable ANSI palette

$ Zero dependencies: direct build with g++ -std=c++23, ideal for containers and VMs

# Gallery

Project terminal

Mobile view

# Technologies used

C++23