systempi

Echtzeit-Dashboard zur Systemüberwachung für Raspberry Pi in Linux-Terminals mit Live-Telemetrie, Hardware-Zustandsanalyse und flimmerarmer Darstellung.

---

FUNKTIONEN

• Echtzeitüberwachung von CPU, RAM, Swap, Festplatte und Netzwerk
• Raspberry-Pi-Hardware-Telemetrie über vcgencmd
• Erkennung von Stromversorgung, Drosselung, Unterspannung und Frequenzbegrenzung
• Dynamische Bewertung von Systemzustand, Speicherzustand und Stabilität
• Dynamische „Health Why“-Diagnose zur Nachvollziehbarkeit
• Modellabhängige Temperaturschwellen und Zustandsbewertung für mehrere Raspberry-Pi-Generationen
• Historische Mini-Diagramme für Zustand und Temperatur, mit erweiterten CPU-, RAM- und Netzwerkverläufen im Doctor-Modus
• Dauerhafte Protokollierung von Alarmereignissen mit Watch-/History-Unterstützung
• Leichtgewichtige Erkennung aktiver Alarme für CPU, RAM, Festplatte, Temperatur sowie Pi-Strom-/Drosselungsereignisse
• Raspberry-Pi-Hardware-Intelligenz mit Einblickszeilen zu Modell/Architektur/RAM/Top-Prozessen
• Paketaktualisierungsüberwachung im Doctor-Modus mit reaktionsschnellen lokalen APT-Zustandsprüfungen und optionalen Prüfungen der Aktualität von Repositories
• Optionale Telemetrieüberwachung für Raspberry Pi AI Hat+ / AI Hat+2 Hailo mit NPU-Last, Temperatur, Speicher und Auslastungswerten
• 15 integrierte Themes, darunter matrix, wasteland, ocean, raspberrypi, mono, amber, crt, vaulttec, synthwave, ice, biohazard und weitere
• 4 Dashboard-Varianten: Balanced, Compact, Minimal und Doctor
• Reaktionsschneller, flimmerarmer Renderer mit partiellem Terminal-Redraw und dynamischer Terminalgrößenanpassung
• Tastaturkürzel, darunter q zum sofortigen Beenden des Dashboards
• Adaptive Dashboard-Skalierung basierend auf der Terminalbreite
• Live-Visualisierung der CPU pro Kern, Festplatten-I/O-Raten, Netzwerkdurchsatz, Load Average und Uptime

---

DASHBOARD-MODI

Modus	Zweck
Balanced	Vollständiges Überwachungs-Dashboard
Compact	Für kleinere Terminals optimiert
Minimal	Sauberer Modus nur mit dem Wesentlichen
Doctor	Modus für Diagnose, Alarme und Aktualisierungsüberwachung

Jede Variante ist für einen anderen Überwachungs-Workflow konzipiert – von der leichtgewichtigen minimalen Überwachung bis zur tiefgehenden Diagnoseanalyse.

---

SCREENSHOTS / THEMES

Balanced-Modus — Haupt-Dashboard

systempi --variation balanced --theme raspberrypi

Hinweis: --variant und --var können auch als Aliase für --variation verwendet werden.

---

Doctor-Modus — Diagnose, Warnungen & Systemeinblicke

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

---

Kompaktmodus — für kleinere Terminals optimiert

systempi --variation compact --theme crt

---

Minimalmodus — Wesentliche, saubere Überwachung

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

Starten mit:

systempi

DEINSTALLATION

cd systempi
sudo ./uninstall.sh

Optionale Bereinigung von Abhängigkeiten:

sudo ./uninstall.sh --remove-deps

Der Deinstaller entfernt die globale systempi-Verknüpfung aus /usr/local/bin. Er löscht nicht deinen geklonten Repository-Ordner.

---

VERWENDUNG / Varianten

Standardstart:

systempi

Drücken Sie jederzeit q, um das Live-Dashboard zu verlassen.

Einmal-Snapshot-Modus (einmal rendern und beenden):

systempi --once

Kompaktmodus:

systempi --variation compact

Minimaler Modus:

systempi --variation minimal

Ausgewogener Modus:

systempi --variation balanced

Doctor-Modus (diagnoseorientiert):

systempi --variation doctor

Doktor-Modus mit optionaler Prüfung der Aktualität des Repositorys:

systempi --variation doctor --repo-check

Der Doctor-Modus aktualisiert seine normale Updates-Anzahl, wenn sich der lokale Paketzustand ändert. Die Anzahl stammt weiterhin aus apt list --upgradable; SystemPi nutzt Änderungen am Paketzustand lediglich als Auslöser, um APT erneut abzufragen. Dies erfordert keinen sudo/root-Zugriff und installiert, entfernt oder aktualisiert keine Pakete.

--repo-check ist optional und nur im Doctor-Modus gültig. Es kontaktiert die bereits auf dem Rechner konfigurierten APT-Repositories, speichert isolierte, benutzereigene Metadaten unter ~/.cache/systempi/apt/ und aktualisiert asynchron alle drei Stunden, ohne den System-APT-Cache zu verändern.

Updates bezeichnet Updates, die der normalen APT-Metadaten des Rechners derzeit bekannt sind. Repo bezeichnet das Ergebnis von SystemPis optionaler Prüfung der Aktualität privater Repositories. Beispielsweise bedeutet Updates 8 available und Repo 9 available, dass das System derzeit 8 verfügbare Updates kennt, während die isolierte Repository-Prüfung insgesamt 9 verfügbare Pakete sieht.

Once + export snapshot:

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

Live-Alarmereignisprotokollierung mit Watch-/History-Unterstützung:

systempi --watch
systempi --history

--watch zeichnet neu aktive Alarmereignisse auf, und --history gibt aktuelle Ereignisse aus:

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

Beispiele für die Theme-Auswahl:

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

Beispiele für Aktualisierungsintervalle:

systempi --refresh 0.5
systempi --refresh 2

Netzwerkmetriken an eine bestimmte Schnittstelle binden:

systempi --interface eth0
systempi --interface wlan0

ANSI-Farben deaktivieren:

systempi --no-color

Optionen kombinieren: