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 availability monitoring with non-blocking background 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 wasteland

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

---

Doctor Mode — Diagnostic, Alert & System Insight

systempi --variation doctor --theme vaulttec

---

Compact Mode — Smaller Terminal Optimized

systempi --variation compact --theme crt

---

Minimal Mode — Essential Clean Monitoring

systempi --variation minimal --theme ice

---

Raspberrypi Theme

systempi --theme raspberrypi

---

Biohazard Theme

systempi --variation doctor --theme biohazard

---

Ocean Theme

systempi --theme ocean

---

Synthwave Theme

systempi --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

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.
• 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