Real-time Raspberry Pi system monitoring dashboard for Linux terminals with live telemetry, hardware health analysis, and low-flicker rendering.
- 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
qfor 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
| 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.
systempi --variation balanced --theme raspberrypi
systempi --variation doctor --repo-check --theme vaulttec
systempi --variation compact --theme crt
systempi --variation minimal --theme ice
systempi --variation balanced --theme wasteland
systempi --variation doctor --theme biohazard
systempi --variation balanced --theme ocean
systempi --variation doctor --theme synthwave
git clone https://github.com/WastelandSYS/systempi.git
cd systempi
chmod +x install.sh uninstall.sh
sudo ./install.shLaunch with:
systempicd systempi
sudo ./uninstall.shOptional dependency cleanup:
sudo ./uninstall.sh --remove-depsThe uninstaller removes the global systempi shortcut from /usr/local/bin. It does not delete your cloned repository folder.
Default launch:
systempiPress q at any time to exit the live dashboard.
One-shot snapshot mode (render once and exit):
systempi --onceCompact mode:
systempi --variation compactMinimal mode:
systempi --variation minimalBalanced mode:
systempi --variation balancedDoctor mode (diagnostic-focused):
systempi --variation doctorDoctor mode with optional repository freshness checking:
systempi --variation doctor --repo-checkDoctor 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.jsonLive 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 wastelandRefresh interval examples:
systempi --refresh 0.5
systempi --refresh 2Pin network metrics to a specific interface:
systempi --interface eth0
systempi --interface wlan0Disable ANSI colors:
systempi --no-colorCombine options:
systempi --variation compact --theme mono --refresh 2 --interface wlan0 --no-colorHelp menu:
systempi -hVersion information:
systempi --versionTerminal glyph selection:
systempi --glyphs auto
systempi --glyphs unicode
systempi --glyphs asciiauto 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.
- default
- matrix
- ocean
- wasteland
- lava
- mono
- girly
- amber
- crt
- vaulttec
- bubblegum
- synthwave
- ice
- biohazard
- raspberrypi
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 byinstall.sh. - Raspberry Pi AI Hat+ / AI Hat+2 telemetry is automatically detected when the Hailo software stack and
hailortcliare available. - Optional
--repo-checksupport 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.
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
Systempi is released under the GNU General Public License v3.0. See LICENSE for the full license text.