CPU-Grid

Running/Monitoring...

Help (-h or --help)

What is it?

CPU-Grid is a real-time, terminal-based system monitoring tool written in Rust. It provides a clean, color-coded overview of your system's performance, including CPU frequencies, hardware temperatures, memory utilization, and Zswap metrics

Features

• Real-time Monitoring: Tracks per-core CPU frequency, RAM/Swap usage, and hardware thermals.
• Smart Color-Coding: Uses dynamic multi-stop color scaling to visually represent load and temperature intensity.
• Zswap Insight: Monitors Zswap compression algorithms, pool statistics, and compression ratios to flag performance degradation (if enabled).
• Room Temperature: Integrates with temper-poll to display ambient room temperature, including dynamic text warnings if the room reaches critical heat levels.
• Ultra-Lightweight & Safe: Built with a multi-threaded architecture featuring zero-allocation data polling loops and strict thread cleanup for minimal CPU footprint and zero memory leaks. For reference: a Ryzen 5950x running CPU-Grid with 1 milisecond interval update for cpu frequencies ('-n 0.1' which is the minimum allowed) and cpu temperature readings, which is the hardest load you can apply to this program; registers 0% to 0.67% of one logical core usage using ~400KB-500KB of memory executing 24/7!
• Squashable Grid: It's primary design goal was to be able to show logical core frequencies, temperatures, memory & swap pressure all in a grid in the smallest shrunk terminal window possible with the least amount of resources used. The grid will reorient based on terminal window dimensions.

Color Legend

Color shade gradually changes between the ranges defined underneath.

Metric	Color Scale
CPU Freq	Green (0-50%) → Yellow (50-70%) → Orange (70-85%) → Red (85-100%) → Violet (≥100% overclock)
CPU Temp	Green (Cool) → Red (Thermal Limit) → Violet (Exceeds Limit) (Note: Limit is dynamic, set by your specific hardware specs)
Room Temp	Green (≤24°C) → Yellow (27°C) → Orange (31°C) → LtRed (35°C) → Violet (≥40°C, triggers Warning)
RAM Load	Green (0-50%) → Yellow (50-70%) → Orange (70-85%) → Red (85-95%) → Violet (≥95%)
Swap Load	Green (0-50%) → Yellow (50-70%) → Orange (70-80%) → Red (80-90%) → Violet (≥90%)
Zswap Status	Green (Enabled) → Bright Red (Disabled) → Yellow (Unknown) → Violet (Not Present)
Zswap Algo	Green (zstd) → Yellow (lz4) → Orange (lzo) → Red (deflate) → Violet (Other)
Zswap Ratio	Violet (<1:1) → Red (1:1) → Orange (1.5:1) → Yellow (2.5:1) → Green (4:1+)

Requirements

• OS: Linux (Target strictly enforced at compile time. Requires access to /proc and /sys/class/hwmon).
• Rust/Cargo: Required to build from source.
• Dependencies: crossterm, which.
• External (OPTIONAL): temper-poll must be installed and in your system PATH for ambient room temperature.

Installation

1. Clone the repository:

   git clone https://github.com/StatusCode404/CPU-Grid.git
   cd cpu-grid

2. Build the project:

   cargo build --release

3. Run the application:

   ./target/release/cpu_grid

Usage

Values are in seconds. Parameters given less than or greater than the boundary ranges will fall back to the nearest boundary range.

Flag	Description	Boundary Ranges
-n <secs>	Interval for CPU stats	0.1 - 60s, default 2.0
-r <secs>	Interval for Room Temp	1 - 3600s, default 2.0
-m <secs>	Interval for Memory stats	1 - 60s, default 2.0

Controls:

• Press Q or Ctrl+C to cleanly terminate background threads and quit the application.

License

Distributed under the GNU General Public License v3.0. See the LICENSE file for more information.