Skip to content

FusionHUD v1.0

Latest

Choose a tag to compare

@The412Banner The412Banner released this 26 Jul 21:16

FusionHUD v1.0

FusionHUD is a lightweight, forkable in-game performance overlay for Android (Winlator / Wine / PC-emulation projects) — the MangoHud-inspired HUD extracted from Bannerlator so any project can adopt it.

What you get

  • The Fusion HUD — one overlay, 5 tap-cyclable sizes (Full / Tiles / Pill / Minimal / Mega) with toggleable per-metric chips.
  • A hardened, cross-vendor metric backend — FPS + frametime graph, CPU (aggregate + per-core), GPU %/clock/temp, thermals, RAM/VRAM, battery (with the mA/µA current-unit auto-detect that fixes 0.0W on OEMs like HONOR), and network — with graceful fallbacks across Adreno · Mali · PowerVR · Xclipse.
  • Diagnostics export for triaging metric gaps on unusual devices.
  • Composited ~1 Hz off the present path — designed not to cost frames.

How to adopt it

  • Gradle (JitPack): add JitPack and depend on com.github.The412Banner:FusionHUD:v1.0 — or grab the fusionhud-release.aar attached below.
  • Fork the source: the HUD keeps stable com.winlator.star.* package names so a Winlator-family fork can drop the files in directly; shims are provided for the few app couplings.
  • Try it first: install the attached demo APK — it overlays the HUD on a fake animated game with buttons to cycle sizes / lock / accent / diagnostics.

License

GPL-3.0 with a §7(b) attribution term (see ATTRIBUTION.md): downstream use must credit The412Banner (+ this repo link) in docs and in-app credits/about. The code is GPL-derived (GameNative lineage), so it can't be relicensed permissively — but you're free to fork, modify and ship it under those terms.

Built from d171774 (CI-green). Repo: https://github.com/The412Banner/FusionHUD