HoroTW/gpu-compact
Watch
1
0
Fork
You've already forked gpu-compact
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Compact KDE Plasma 6 widget for NVIDIA P-state, power, utilization and GPU/memory clocks.
1 commit 1 branch 0 tags 26 KiB
  • QML 85.6%
  • Python 14.4%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
HoroTW 5a8dde8e2f Add GPU Compact Plasma widget with compact panel sizing
2026-09-20 08:07:27 +02:00
org.horo.gpucompact Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
.gitignore Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
GPU-Compact.plasmoid Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
LICENSE Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
preview.png Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
Preview.qml Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
README.md Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
render-preview.py Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
test-live.py Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00
TestSource.qml Add GPU Compact Plasma widget with compact panel sizing 2026-09-20 08:07:27 +02:00

README.md

GPU Compact

A compact KDE Plasma 6 widget for NVIDIA GPU monitoring, designed for desktops and horizontal panels.

GPU Compact preview

Preview with illustrative readings.

Displays the actual P-state, board power, a utilization dial, and core/memory clocks. Panel width follows its height so it fits without large side margins.

Requirements

  • KDE Plasma 6 with Kirigami and the Plasma5Support executable data engine
  • NVIDIA driver with /usr/bin/nvidia-smi
  • GNU timeout at /usr/bin/timeout

Install

Download this repository, then run:

kpackagetool6 --type Plasma/Applet --install ./org.horo.gpucompact

Alternatively, install the included GPU-Compact.plasmoid through KDE's Add Widgets → Install Widget From Local File menu.

Add GPU Compact from KDE's widget picker to your desktop or panel. To update an existing installation:

kpackagetool6 --type Plasma/Applet --upgrade ./org.horo.gpucompact

Settings

Right-click the widget and choose Configure GPU Compact. The default refresh interval is two seconds. Green thresholds are configurable and default to:

Metric Green through
Board power 35 W
Core clock 800 MHz
Memory clock 1200 MHz

Higher readings are red to indicate activity, not a fault. Hover for detailed readings, including power to two decimal places. The P-state ladder marks P0, P2, P3, P5 and P8.

How it works

The widget queries GPU 0 using a fixed read-only nvidia-smi command. Queries are asynchronous, cannot overlap, and have a four-second timeout. No root access, clock changes, background service or continuous animation is required. Unavailable values show a dash; failed queries clear stale readings. GPU selection is currently fixed to GPU 0.

Development

The QML source is in org.horo.gpucompact/. With PySide6 and the required KDE QML modules installed, run python render-preview.py to regenerate the preview, or python test-live.py to check live polling and unavailable/malformed readings. The live test requires a working NVIDIA GPU.

Build the installable archive with:

(cd org.horo.gpucompact && zip -r ../GPU-Compact.plasmoid metadata.json contents)

Version 1.0.1 includes compact horizontal-panel sizing. Validated with QML lint, rendered preview inspection, live polling and Plasma's widget loader.

Remove

Remove widget instances through KDE, then run:

kpackagetool6 --type Plasma/Applet --remove org.horo.gpucompact

License

MIT — see LICENSE.