Universal Dual-Kernel performance & thermal optimizer for MediaTek MT6789 Family
A lightweight native daemon + Material Design 3 WebUI for Helio G99 / G100 / G200 devices.
Inspired by encore @Rem01Gaming

Installation • Profiles • Thermal • HUD • WebUI • Security • Troubleshooting

• Overview
• Key Features
• Operational Profiles
• Thermal & Charging
• HyperMoon HUD
• WebUI
• Security Model
• IPC Protocol
• Daemon Lifecycle
• Codebase Architecture
• Installation
• Game List Configuration
• Building from Source
• Requirements
• Troubleshooting
• License & Attribution

Android devices often suffer frame drops and scrolling stutters from conservative CPU/GPU scaling and governor delays. HyperCore runs a native C daemon (libhypercore.so) in the background that dynamically tunes — based on real-time workload state:

CPU governors • uclamp targets • Mali GPU devfreq scaling • MediaTek GED / FPSGO drivers • DVFSRC bandwidth • storage read-ahead • thermal limits • charging current

The daemon re-evaluates state every tick and applies exactly one profile:

¹ Interactive = factory stock + touch. Every CPU/GPU/GED/FPSGO/VM/cgroup node is restored to the captured stock_state.conf — the only enhancement is touchscreen smoothing + noise filtering for silky 90/120 Hz scrolling. ² MOBA keeps Big at 2.0 GHz under Tier 1 for latency headroom.

flowchart TD
    A[Screen off?] -->|yes| S[Sleep]
    A -->|no| B[Game in foreground?]
    B -->|MOBA title| M[Gaming MOBA]
    B -->|3D / AAA| G[Gaming]
    B -->|no| C{Hold / manual lock?}
    C -->|yes| H[Keep held profile]
    C -->|no| I[Interactive]

HyperCore caps frequency ceilings as heat rises — and from Tier 1 up it stops fighting the vendor stack (mi_thermald, FPSGO thermal, GPU devfreq cooler) and defers to it.

Your selected mode is a ceiling, never a guarantee:

flowchart LR
    V[Violent] -->|batt ≥ 45°C| F[Fast]
    F -->|hotter| B[Balanced]
    B -->|hotter| S[Safe]
    S -->|batt ≥ 50°C| S
    S -->|≤ 41°C for 180s| UP[climb back up]

HyperOS hands the device a 6 GB compressed swap pool. Capacity past what you actually swap is not free — it raises the ceiling for compression work and keeps kswapd busy. WebUI → Home → Memory resizes it:

• One rung down at ≥ 45 °C (Violent → Fast → Balanced → Safe)
• Hard floor to Safe at ≥ 50 °C, climbs back only after ≤ 41 °C for 180 s continuous
• Dead-band 41–45 °C freezes position (no flapping)
• OEM Stock and Bypass are exempt
• Extras: 80% cutoff with 77% release hysteresis • Bypass low-battery 10/12% hysteresis • TCPC pulse for USB-PD renegotiation

Native dual-engine overlay — near-zero overhead, no extra module needed:

hypermoon_d (C daemon, 11 chars for pkill -x)  →  collects FPS / CPU / GPU / batt / net
HyperMoonOverlay (Java DEX via app_process)    →  draws floating pill / card

• Metrics: FPS, frametime, CPU load + freq + governor, GPU load + freq + governor, RAM, ZRAM, battery W/temp, network throughput
• Layouts: horizontal pill ↔ vertical card • Minimal / Compact / Detailed one-tap presets • Cyber Neon, AMOLED Dark, Matrix Green, Crimson Red + custom hex
• Auto-gaming: appears in games, hides in daily use • sub-ms config sync via kernel inotify
• Positioning: drag with a finger on Android ≤14, or WebUI D-pad + X/Y sliders on any version — required on Android 14 QPR3+/15 where the overlay runs on a hardware surface with no input channel
• Geometry: width, height, scale, font, radius, opacity, refresh interval — all live sliders

Single-file Vue 3 + Pinia app (webroot/index.html) served by your root manager — AMOLED MD3 interface, no backend server:

1. Two-layer integrity — customize.sh runs sha256sum -c checksums.txt over the entire payload before sourcing or executing anything, then the daemon re-verifies from an embedded checksum table (--verify-integrity). libhypercore.so can't embed its own hash, so it's covered by the shipped manifest.
2. IPC authorization — /dev/hypercore.sock checks every peer with SO_PEERCRED: only uid 0 (root bridges, bugreport) and uid 2000 (adb shell). Strangers are dropped before the daemon reads a byte.
3. Single instance — advisory flock on <data_dir>/.hypercore_lock; the kernel releases it even on SIGKILL.
4. Hygiene — logs/telemetry live in /data/adb/hypercore/ (never world-readable /sdcard), shell calls are quoted against injection, socket reads loop to newline under a 25 ms timeout.

Talk to the live daemon straight from adb shell:

echo GET_STATUS | nc -U /dev/hypercore.sock
echo SET_PROFILE:GAMING | nc -U /dev/hypercore.sock

Live mirror files: /dev/hypercore.sock • /dev/hypercore_status.json • /data/adb/hypercore/status.json

flowchart TD
    P[post-fs-data.sh<br/>mkdir /data/adb/hypercore] --> C[customize.sh<br/>verify then snapshot baseline then perms]
    C --> S[service.sh<br/>wait boot_completed then graceful restart]
    S --> D[libhypercore.so<br/>flock then integrity then INIT to Interactive]
    D --> T5[tick 5/15/30<br/>boot settle re-apply + verify]
    T5 --> L{profile change?<br/>thermal tier change?}
    L -->|yes| A[apply_profile + status sync]
    L -->|no| K[keep + charger enforce + telemetry]
    A --> L
    K --> L

• Install (customize.sh): strict MT6789 check (GED + Mali + FPSGO) → kill old daemon → preserve *.conf + merge gamelist → unzip → verify first → capture stock_state.conf + stock_zram.conf → permissions + PATH symlinks → game auto-detect.
• Boot (service.sh): waits sys.boot_completed → apply saved ZRAM pool → SIGTERM + 10 s grace (lets ~60 nodes restore) → SIGKILL fallback → start daemon (+ nohup retry) → optional HUD autostart.
• Uninstall (uninstall.sh): SIGTERM + 5 s grace → restore factory nodes and the stock ZRAM pool from baseline → remove symlinks, socket, data.

src/
├── include/
│   ├── charger.hpp              # 7 charge modes, ladder + hysteresis API
│   ├── common.hpp               # hw_nodes / core_state / stock_baseline structs
│   ├── cpu.hpp                  # Profile matrix + governor/freq API
│   ├── embedded_checksums.hpp   # GENERATED — SHA-256 table (do not hand-edit)
│   ├── gamelist.hpp             # Foreground game detector + PID cache
│   ├── gpu.hpp                  # GED / FPSGO / Mali devfreq API
│   ├── integrity.hpp            # Embedded integrity-check API
│   ├── io.hpp                   # Read-ahead, nr_requests, IRQ affinity
│   ├── ipc.hpp                  # UNIX socket protocol
│   ├── log.hpp                  # Leveled logging + rotation
│   ├── memory.hpp               # Swappiness, VM, swap-pool awareness, purge
│   ├── sha256.hpp               # SHA-256 implementation
│   ├── sysfs.hpp                # Dual-kernel sysfs I/O + touch rediscovery
│   └── thermal.hpp              # Zone scoring, 3-tier guard
├── hud/
│   ├── hypermoon_daemon.c       # C telemetry collector (hypermoon_d)
│   └── HyperMoonOverlay.java    # DEX overlay renderer
├── main.c                       # init, boot settle, adaptive main loop
├── cpu.c                        # build_profile_matrix() + apply_profile()
├── charger.c                    # Ladder, 16-level slider, BMS healing
├── thermal.c                    # Tier engine + gaming bypass (Tier 0 only)
├── gamelist.c                   # cgroup top-app scan, hourly pm fallback
├── ipc.c                        # SO_PEERCRED socket + atomic status.json
├── sysfs.c                      # Read-before-write, stock baseline save/load
├── integrity.c / sha256.c       # Manifest verification primitives
├── io.c / memory.c / gpu.c      # Storage, VM and GPU tuning
└── log.c                        # Persistent FD, 512 KB / 250-line rotation
webui/  →  Vue 3 + Pinia SPA  →  webroot/index.html (single file)

1. Download HyperCore-v6.11.0-b6110-Unified.zip from the Releases page
2. Flash it in KernelSU / APatch / Magisk
3. Reboot — the daemon starts automatically and settles into Interactive
4. Open the manager's WebUI to monitor, add games, tune charging and design your HUD

Verify a running install any time (uid 0 / adb shell):

cd /data/adb/modules/hypercore && sha256sum -c checksums.txt
/data/adb/modules/hypercore/system/bin/libhypercore.so --verify-integrity /data/adb/modules/hypercore

Manage via WebUI → Games, or edit /data/adb/hypercore/gamelist.txt (survives updates — entries are merged, never overwritten):

# Configured Games
com.mobile.legends:Gaming MOBA
com.tencent.ig:Gaming
com.miHoYo.GenshinImpact:Gaming
com.dts.freefireth:Gaming

• Flash-time auto-detect scans pm list packages -3 for known titles
• Runtime detection prefers cgroup top-app scan (up to 64 PIDs), dumpsys window as 10 s rate-limited fallback
• New launches trigger a temporary boost + toast

Compiles the C daemon, rebuilds the WebUI, regenerates checksums (two-pass: stub → hash → embed → relink → manifest gate) and packages the release ZIP:

./build.sh

Output:

~/HyperCore_Releases/HyperCore-v6.11.0-b6110-Unified.zip

Deploy straight to the live device (root) after building:

./build.sh --deploy

• Platform — MediaTek MT6789 Family (Helio G99 / G100 / G200, Mali-G57 + GED + FPSGO)
• Kernel — GKI Linux 5.10 → 6.12+ (Android 12 → 16), ARM64
• Root — KernelSU, APatch, or Magisk
• Everything else — Samsung / Snapdragon / Unisoc / Tensor are not supported (installer aborts)

grep -i "boot settle" /data/adb/hypercore/hypercore.log
# Boot settle re-apply Interactive (1/3) … (2/3) … verified: Interactive fully applied

This project is licensed under the GNU General Public License v3.0 — see LICENSE and NOTICE.md for details.

Developed by @itswill00 · Inspired by encore @Rem01Gaming

Back to top