meccatronis/radeonminimonitor

Radeon Mini Monitor

A lightweight, modern GPU monitoring overlay for AMD Radeon GPUs on Linux.

Features

• Real-time monitoring: GPU utilization, temperature, VRAM usage, power consumption, fan speed, and clock speeds
• Multiple layouts: Classic vertical, compact horizontal, and minimal chip styles
• Always-on-top overlay: Non-intrusive monitoring with drag-and-drop repositioning
• Wayland support: Proper layer-shell integration for KDE Plasma
• Configurable: Opacity, scale, refresh rate, and thresholds
• Daemon architecture: Centralized metrics collection with IPC

Architecture

• radmon-daemon: Background service collecting metrics from AMD SMI, sysfs, and amdgpu_top
• overlay-ui: Qt6/QML overlay application
• dashboard-ui: Full dashboard with historical data and charts

Requirements

• Linux with AMD GPU
• Qt6 development libraries
• Rust toolchain
• AMD ROCm SMI (recommended) or basic sysfs access

Building

Daemon

cd services/radmon-daemon
cargo build --release

Overlay UI

cd apps/overlay-ui
mkdir build && cd build
cmake ..
make

Installation

1. Install the daemon: sudo cp target/release/radmon-daemon /usr/local/bin/
2. Install the overlay: sudo cp build/overlay-ui /usr/local/bin/
3. Enable systemd service: systemctl --user enable radmon-daemon.service
4. Add desktop file to autostart: cp radeon-overlay.desktop ~/.config/autostart/

Usage

Start the daemon: systemctl --user start radmon-daemon

Launch overlay: overlay-ui

Configuration

Default config in shared/config-default.yaml:

overlay:
  position: { x: 100, y: 100 }
  scale: 1.0
  opacity: 0.9
  refresh_ms: 1000
  layout: classic

thresholds:
  temp_warning: 80
  temp_critical: 90
  power_warning: 300

Metrics Sources

1. AMD SMI (primary): Comprehensive metrics via libamdsmi
2. sysfs/hwmon (fallback): Basic metrics from /sys/class/drm/
3. amdgpu_top (advanced): Engine utilization and detailed counters

License

MIT