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

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