⚡ SYSTEM HUD

> a tactical black/green dashboard for your device's vitals_

_{web app · native Android app · home-screen widget · zero fake numbers on-device}

_{↑ the actual widget, on an actual home screen, showing actual numbers}

---

🧭 what is this

A 12-tile glanceable HUD for your machine's (or phone's) vital signs — CPU, RAM, disk, network, battery — rendered like a mission-control panel, not a spreadsheet.

Ships two ways:

🌐 web	📱 android
TanStack Start SPA, deploy anywhere	Capacitor-wrapped native app
animated, always-on dashboard	real home-screen widget, resizable
great for a second monitor / kiosk	reads actual hardware via native Kotlin

🖼️ click for the full in-app view

The web/in-app HUD — 12 cards, sparklines, a scanline overlay because we have taste. Same real numbers as the widget, same process, no drift between the two.

---

🔩 the honesty table

We don't fake numbers we can't actually read. Android has locked down or never exposed some of these to apps — here's exactly what's real vs. what's structurally impossible without root:

show me 👀

metric	on native Android	why
🔋 battery %, voltage, temp, charge	✅ real, live	BatteryManager — fully public API
🧠 RAM used / total	✅ real, live	ActivityManager.MemoryInfo
💾 storage used / total	✅ real, live	StatFs
📶 network throughput	✅ real, live	TrafficStats, sampled per tick
⏱️ uptime	✅ real, live	SystemClock.elapsedRealtime()
🧮 CPU cores / clock	✅ real, best-effort	/sys/.../cpufreq, blocked on some OEMs
🧮 CPU usage %	❌ flat 0	blocked for apps since Android 8, no root
🎮 GPU usage %	❌ flat 0	no public API at all, ever
🩺 battery health %	❌ flat 100	Android only exposes a coarse GOOD/OVERHEAT/DEAD enum

_{On web/dev mode, all of the above are simulated with a random walk purely for the demo animation — clearly a fallback, never shipped as "real" on a real device.}

---

🚀 quickstart

bun install          # 📦 deps
bun run dev           # 🌐 web dev server

📱 building the Android app + widget

bun run build:capacitor     # static client-only bundle → capacitor-www/
bunx cap sync android       # copy web assets into the native shell
cd android
./gradlew assembleDebug     # 🤖 APK at app/build/outputs/apk/debug/

Then long-press your home screen → Widgets → System HUD. Drag to resize — it swaps between a compact 2×2 and the full 12-card grid depending on how much room you give it.

---

🏗️ how it's built

flowchart LR
    A[🎨 React + TanStack Start] -->|bun run build:capacitor| B[📦 static bundle]
    B -->|Capacitor| C[📱 Android shell]
    C --> D[🧩 SystemStatsPlugin]
    E[🔩 Kotlin: BatteryManager · StatFs · TrafficStats] --> D
    E --> F[🏠 Home-screen widget]
    D -->|same real data| A

Loading

• Web: React 19 + TanStack Start/Router + Tailwind v4, JetBrains Mono doing all the heavy lifting on vibes.
• Native bridge: a tiny Capacitor plugin exposes the exact same reading the widget uses, so the in-app screen and the widget never disagree.
• Widget: classic RemoteViews (not Glance) — WorkManager for a 15-min battery-friendly floor, plus a ~30s AlarmManager tick since every read here is a cheap local syscall, not a network call.

---

🗺️ roadmap

• real battery / RAM / disk / network / uptime on-device
• resizable native widget matching the web UI pixel-for-pixel
• adaptive app icon
• rooted-device path for real system-wide CPU%
• iOS widget (WidgetKit) — same honesty rules apply
• a "why is my GPU tile always 0" FAQ nobody will read

---

_{built with 🖤 and an unreasonable amount of respect for real data by @pi0trdotsys}

// sigma.forecast() > the dashboard waits for no one_