systempi

Dashboard di monitoraggio del sistema Raspberry Pi in tempo reale per terminali Linux con telemetria live, analisi dello stato di salute dell'hardware e rendering a basso sfarfallio.

---

FUNZIONALITÀ

• Monitoraggio in tempo reale di CPU, RAM, swap, disco e rete
• Telemetria hardware Raspberry Pi tramite vcgencmd
• Rilevamento di alimentazione, throttling, sottotensione e limitazione della frequenza
• Punteggio dinamico di salute del sistema, salute dello storage e stabilità
• Diagnostica di spiegabilità dinamica "Health Why"
• Soglie termiche e punteggio di salute specifici per modello per più generazioni di Raspberry Pi
• Mini-grafici storici per salute e temperatura, con tendenze ampliate di CPU, RAM e rete in modalità Doctor
• Registrazione persistente degli eventi di allerta con supporto watch/history
• Rilevamento leggero delle allerte attive per CPU, RAM, disco, temperatura ed eventi di alimentazione/throttle del Pi
• Intelligence hardware Raspberry Pi con righe informative su modello/arch/RAM/processo principale
• Monitoraggio degli aggiornamenti dei pacchetti in modalità Doctor con controlli reattivi dello stato APT locale e verifiche opzionali di aggiornamento dei repository
• Monitoraggio opzionale della telemetria Raspberry Pi AI Hat+ / AI Hat+2 Hailo con metriche di carico NPU, temperatura, memoria e utilizzo
• 15 temi integrati tra cui matrix, wasteland, ocean, raspberrypi, mono, amber, crt, vaulttec, synthwave, ice, biohazard e altri
• 4 varianti di dashboard: Balanced, Compact, Minimal e Doctor
• Renderer reattivo a basso sfarfallio con ridisegno parziale del terminale e ridimensionamento dinamico del terminale
• Scorciatoie da tastiera tra cui q per uscire istantaneamente dalla dashboard
• Ridimensionamento adattivo della dashboard in base alla larghezza del terminale
• Visualizzazione live della CPU per core, velocità di I/O del disco, throughput di rete, load average e uptime

---

MODALITÀ DASHBOARD

Modalità	Scopo
Balanced	Dashboard di monitoraggio completa
Compact	Ottimizzata per terminali più piccoli
Minimal	Modalità pulita con solo l'essenziale
Doctor	Modalità diagnostica, allerte e monitoraggio aggiornamenti

Ogni variante è progettata per un diverso flusso di lavoro di monitoraggio — dal monitoraggio minimale leggero all'analisi diagnostica approfondita.

---

SCREENSHOT / TEMI

Modalità Balanced — Dashboard principale

systempi --variation balanced --theme raspberrypi

Nota: --variant e --var possono essere usati anche come alias per --variation.

---

Modalità Doctor — Diagnostica, Avvisi e Analisi del Sistema

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

---

Modalità compatta — Ottimizzata per terminali più piccoli

systempi --variation compact --theme crt

---

Minimal Mode — Essential Clean Monitoring

systempi --variation minimal --theme ice

---

Tema Wasteland

systempi --variation balanced --theme wasteland

---

Tema Biohazard

systempi --variation doctor --theme biohazard

---

Tema Ocean

systempi --variation balanced --theme ocean

---

Tema Synthwave

systempi --variation doctor --theme synthwave

---

INSTALLAZIONE

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

Avvia con:

systempi

DISINSTALLAZIONE

cd systempi
sudo ./uninstall.sh

Pulizia delle dipendenze opzionali:

sudo ./uninstall.sh --remove-deps

L'disinstallatore rimuove il collegamento globale systempi da /usr/local/bin. Non elimina la cartella del repository clonato.

---

UTILIZZO / Varianti

Avvio predefinito:

systempi

Premi q in qualsiasi momento per uscire dalla dashboard live.

Modalità snapshot one-shot (rendering una volta ed esci):

systempi --once

Modalità compatta:

systempi --variation compact

Modalità minima:

systempi --variation minimal

Modalità bilanciata:

systempi --variation balanced

Modalità Doctor (orientata alla diagnostica):

systempi --variation doctor

Modalità Doctor con controllo opzionale della freschezza del repository:

systempi --variation doctor --repo-check

La modalità Doctor aggiorna il suo normale conteggio Updates quando lo stato dei pacchetti locali cambia. Il conteggio proviene comunque da apt list --upgradable; SystemPi utilizza solo le modifiche allo stato dei pacchetti come trigger per interrogare nuovamente APT. Ciò non richiede accesso sudo/root e non installa, rimuove o aggiorna pacchetti.

--repo-check è opt-in ed è valido solo con la modalità Doctor. Contatta i repository APT già configurati sulla macchina, memorizza metadati isolati di proprietà dell'utente in ~/.cache/systempi/apt/ e si aggiorna in modo asincrono ogni tre ore senza modificare la cache APT di sistema.

Updates indica gli aggiornamenti attualmente noti ai normali metadati APT della macchina. Repo indica il risultato del controllo opzionale di freschezza del repository privato di SystemPi. Ad esempio, Updates 8 available e Repo 9 available significa che il sistema attualmente conosce 8 aggiornamenti disponibili, mentre il controllo isolato del repository vede 9 pacchetti disponibili in totale.

Una volta + esporta snapshot:

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

Registrazione degli eventi di allerta in tempo reale con supporto watch/history:

systempi --watch
systempi --history

--watch registra i nuovi eventi di allerta attivi, e --history stampa gli eventi recenti da:

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

Esempi di selezione del tema:

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

Esempi di intervallo di aggiornamento:

systempi --refresh 0.5
systempi --refresh 2

Fissa le metriche di rete a un'interfaccia specifica:

systempi --interface eth0
systempi --interface wlan0