systempi

Real-time Raspberry Pi system monitoring dashboard for Linux terminals with live telemetry, hardware health analysis, and low-flicker rendering.

---

FEATURES

• Real-time CPU, RAM, swap, disk, and network monitoring
• Raspberry Pi hardware telemetry through vcgencmd
• Power, throttling, undervoltage, and frequency-capping detection
• Dynamic system health, storage health, and stability scoring
• Dynamic "Health Why" explainability diagnostics
• Model-aware thermal thresholds and health scoring for multiple Raspberry Pi generations
• Historical mini-graphs for health and temperature, with expanded CPU, RAM, and network trends in Doctor mode
• Persistent alert event logging with watch/history support
• Lightweight active alert detection for CPU, RAM, disk, temperature, and Pi power/throttle events
• Raspberry Pi hardware intelligence with model/arch/RAM/top-process insight rows
• Doctor mode package update monitoring with responsive local APT state checks and optional repository freshness checks
• Optional Raspberry Pi AI Hat+ / AI Hat+2 Hailo telemetry monitoring with NPU load, temperature, memory, and utilization metrics
• 15 built-in themes including matrix, wasteland, ocean, raspberrypi, mono, amber, crt, vaulttec, synthwave, ice, biohazard, and more
• 4 dashboard variations: Balanced, Compact, Minimal, and Doctor
• Responsive low-flicker partial terminal redraw renderer with dynamic terminal resizing
• Keyboard shortcuts including q for instant dashboard exit
• Adaptive dashboard scaling based on terminal width
• Live per-core CPU visualization, disk I/O rates, network throughput, load average, and uptime

---

DASHBOARD MODES

Mode	Purpose
Balanced	Full monitoring dashboard
Compact	Smaller terminal optimized
Minimal	Essential-only clean mode
Doctor	Diagnostic, alert, and update-monitoring mode

Each variation is designed for a different monitoring workflow — from lightweight minimal monitoring to deep diagnostic analysis.

---

SCREENSHOTS / THEMES

Balanced Mode — Main Dashboard

systempi --variation balanced --theme raspberrypi

Note: --variant and --var may also be used as aliases for --variation.

---

Doctor Mode — Diagnostic, Alert & System Insight

systempi --variation doctor --repo-check --theme vaulttec

---

Compact Mode — Smaller Terminal Optimized

systempi --variation compact --theme crt

---

Minimal Mode — Essential Clean Monitoring

systempi --variation minimal --theme ice

---

Wasteland Theme

systempi --variation balanced --theme wasteland

---

Biohazard Theme

systempi --variation doctor --theme biohazard

---

Ocean Theme

systempi --variation balanced --theme ocean

---

Synthwave Theme

systempi --variation doctor --theme synthwave

---

INSTALLATION

git clone https://github.com/WastelandSYS/systempi.git
cd systempi
chmod +x install.sh uninstall.sh
sudo ./install.sh

Launch with:

systempi

---

UNINSTALLATION

cd systempi
sudo ./uninstall.sh

Optional dependency cleanup:

sudo ./uninstall.sh --remove-deps

The uninstaller removes the global systempi shortcut from /usr/local/bin. It does not delete your cloned repository folder.

---

USAGE / Variations

Default launch:

systempi

Press q at any time to exit the live dashboard.

One-shot snapshot mode (render once and exit):

systempi --once

Compact mode:

systempi --variation compact

Minimal mode:

systempi --variation minimal

Balanced mode:

systempi --variation balanced

Doctor mode (diagnostic-focused):

systempi --variation doctor

Doctor mode with optional repository freshness checking:

systempi --variation doctor --repo-check

Doctor mode refreshes its normal Updates count when local package state changes. The count still comes from apt list --upgradable; SystemPi only uses package-state changes as a trigger to ask APT again. This requires no sudo/root access and does not install, remove, or upgrade packages.

--repo-check is opt-in and only valid with Doctor mode. It contacts the APT repositories already configured on the machine, stores isolated user-owned metadata under ~/.cache/systempi/apt/, and refreshes asynchronously every three hours without modifying the system APT cache.

Updates means updates currently known to the machine's normal APT metadata. Repo means the result from SystemPi's optional private repository freshness check. For example, Updates 8 available and Repo 9 available means the system currently knows about 8 available updates, while the isolated repository check sees 9 total available packages.

Once + export snapshot:

systempi --once --export text --output report.txt
systempi --once --export json --output report.json

Live alert event logging with watch/history support:

systempi --watch
systempi --history

--watch records newly active alert events, and --history prints recent events from:

~/.local/state/systempi/events.log

Theme selection examples:

systempi --theme ocean
systempi --theme matrix
systempi --theme wasteland

Refresh interval examples:

systempi --refresh 0.5
systempi --refresh 2

Pin network metrics to a specific interface:

systempi --interface eth0
systempi --interface wlan0

Disable ANSI colors:

systempi --no-color

Combine options:

systempi --variation compact --theme mono --refresh 2 --interface wlan0 --no-color

Help menu:

systempi -h

Version information:

systempi --version

Terminal glyph selection:

systempi --glyphs auto
systempi --glyphs unicode
systempi --glyphs ascii

auto automatically selects the most compatible glyph set for the active terminal. unicode forces full Unicode rendering, while ascii uses a plain ASCII fallback for maximum compatibility.

AVAILABLE THEMES

• default
• matrix
• ocean
• wasteland
• lava
• mono
• girly
• amber
• crt
• vaulttec
• bubblegum
• synthwave
• ice
• biohazard
• raspberrypi

---

COMPATIBILITY

Designed primarily for Linux systems.

Tested on:

• Raspberry Pi OS
• Raspberry Pi 5
• Raspberry Pi 4B
• Raspberry Pi Zero 2w
• Kali Linux ARM

Notes:

• Raspberry Pi hardware metrics require vcgencmd.
• General system metrics require psutil, which is installed by install.sh.
• Raspberry Pi AI Hat+ / AI Hat+2 telemetry is automatically detected when the Hailo software stack and hailortcli are available.
• Optional --repo-check support is intended for Debian/APT-based systems and uses the user's configured APT repositories.
• Non-Raspberry Pi systems can still provide standard CPU, memory, disk, and network metrics, but Pi-specific temperature, frequency, and throttling telemetry may show as unavailable.

---

WHY SYSTEMPI?

systempi was built to make Raspberry Pi monitoring feel modern, responsive, and visually enjoyable instead of cluttered or outdated.

The dashboard focuses on:

• fast live telemetry
• clean terminal aesthetics
• low-flicker rendering
• meaningful hardware insight
• responsive layouts across terminal sizes

---

LICENSE

Systempi is released under the GNU General Public License v3.0. See LICENSE for the full license text.

---

AUTHOR

WastelandSYS