Adaptive Cinnamon applet for CPU, memory, swap, temperature and AMD GPU/VRAM monitoring on horizontal or vertical panels.
  • Python 44.6%
  • JavaScript 34.3%
  • Shell 20%
  • Makefile 1.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Claudiu Schuster 6d904aa82a
Some checks are pending
Checks / Functional checks (push) Waiting to run
Checks / Super-Linter (push) Waiting to run
Fix Spices review findings for 2.0.1 (#6)
* Fix Spices review findings and crop public screenshot

- Replace synchronous system-file reads and temperature discovery with
  cancellable asynchronous Gio operations.
- Use Cinnamon's public restart API and packaged icon assets directly.
- Refresh the Spices candidate metadata and use a focused 8 px screenshot crop.

* Install XApp GI dependency for GTK regression checks

Install the XApp introspection package used by the native GPU bus settings
test on the GitHub Actions runner.

* Declare native GTK test dependencies in CI

Install the GTK, XApp, Python GI and isolated X11 packages required by the
GPU bus settings regression test on GitHub Actions.
2026-09-08 18:45:11 +02:00
.github Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
docs Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
icons Add metric symbols and vertical panel screenshot 2026-08-22 19:58:15 +02:00
packaging Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
scripts Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
tests Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
.gitignore Prepare Adaptive System Monitor 1.0.0 for Cinnamon Spices (#3) 2026-09-08 17:26:52 +02:00
applet.js Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
ATTRIBUTION.md Add metric symbols and vertical panel screenshot 2026-08-22 19:58:15 +02:00
CHANGELOG.md Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
gpu_bus_settings.py Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
icon.png Prepare Adaptive System Monitor 1.0.0 for Cinnamon Spices (#3) 2026-09-08 17:26:52 +02:00
icon.svg Initial adaptive system monitor applet 2026-08-22 19:44:43 +02:00
install.sh Prepare Adaptive System Monitor 1.0.0 for Cinnamon Spices (#3) 2026-09-08 17:26:52 +02:00
LICENSE Initial adaptive system monitor applet 2026-08-22 19:44:43 +02:00
Makefile Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
metadata.json Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
metrics.js Initial adaptive system monitor applet 2026-08-22 19:44:43 +02:00
README.md Fix Spices review findings for 2.0.1 (#6) 2026-09-08 18:45:11 +02:00
settings-schema.json Prepare Adaptive System Monitor 1.0.0 for Cinnamon Spices (#3) 2026-09-08 17:26:52 +02:00
uninstall.sh Prepare Adaptive System Monitor 1.0.0 for Cinnamon Spices (#3) 2026-09-08 17:26:52 +02:00

Adaptive System Monitor icon

Adaptive System Monitor

CPU, memory, swap, temperature and AMD GPU monitoring in one compact Cinnamon panel applet — adaptive on horizontal and vertical panels.

Checks License GPL-3.0-or-later Cinnamon 5.8 or newer AMD GPU support

Adaptive System Monitor — live system health for Cinnamon

Horizontal panel (icons) Vertical panel (icons)
Horizontal Cinnamon panel with metric icons Vertical Cinnamon panel with metric icons

These native Cinnamon panel crops use an 8 px breathing edge and keep the panel boundary intact. Text-label mode remains available from the display settings.

Why it stands out

  • Horizontal panels show a compact single row.
  • Vertical panels stack metrics and keep every value narrow enough for a 40 px panel.
  • Choose metric icons or short text labels with a native settings switch.
  • CPU, memory, swap and temperature data come directly from Linux /proc and /sys interfaces.
  • AMD GPU and VRAM data use radeontop.
  • GPU and VRAM disappear automatically when radeontop or supported GPU data is unavailable, and each can also be disabled explicitly in the settings.
  • Warning and critical thresholds, colors and visible metrics are configurable through Cinnamon's native applet settings.
  • Metric refreshes and CPU-temperature discovery use cancellable asynchronous Gio operations so the Cinnamon UI loop stays responsive.
  • Hidden system metrics are not polled; hiding both GPU metrics also prevents radeontop from running.
  • The click menu includes system-monitor launchers and a Restart Cinnamon action inherited from the Combined Monitor workflow.

CPU, memory, swap and temperature are read directly from Linux interfaces. There is no background daemon, web service or telemetry.

Settings

All options are available through Cinnamon's native three-tab settings dialog.

General

General display and AMD GPU settings

Metrics

Individual metric visibility settings

Colors and thresholds

Metric colors and warning or critical thresholds

Requirements

Cinnamon 5.8 or newer is supported. AMD GPU metrics require radeontop:

sudo apt install radeontop

The CPU, memory, swap and CPU-temperature metrics work without radeontop.

Installation

git clone https://github.com/oss-singularity/cinnamon-system-monitor.git
cd cinnamon-system-monitor
./install.sh

Then open System Settings → Applets, add Adaptive System Monitor to a panel and remove the separate Combined Monitor / AMD GPU Monitor instances if you no longer need them. Existing settings of those applets are not changed.

Run ./install.sh again after an update. Run ./uninstall.sh to remove the applet files; user settings are deliberately retained.

Cinnamon Spices

The repository includes a reproducible Spices candidate builder and a native local-install verification path. Run make check-package and make package, then see docs/spices-readiness.md for the submission layout and release gates.

Development

make check

The checks validate JavaScript syntax, metric parsers, JSON schemas, SVG assets and shell scripts.

Every push and pull request runs the same validation in GitHub Actions.

Origin and license

The project combines and reworks ideas from Combined Monitor by d-atoshi and AMD GPU Monitor by axel358, both distributed in Linux Mint's cinnamon-spices-applets repository. See ATTRIBUTION.md for details.

Licensed under GPL-3.0-or-later. See LICENSE.