S
ShizuPortal
ShizuStore

Unofficial ShizuStore Web Portal

This is an unofficial web portal for ShizuStore self-hosted by rdevz-ph. Visit the official portal at https://shizustore.com/.

FrameX-Android

FrameX-Android

v1.5.27
by MaheshSharan•Development utilities•MIT
Need ShizuStore app? Download APK

About Application

FrameX

FrameX Banner

Rootless Android performance overlay featuring live FPS metering, thermal diagnostics, and privileged gaming optimization via Shizuku.

Total Downloads Version Min API Kotlin License


[!NOTE] Gaming Performance Mode adapts dynamically based on your device hardware:

  • Generic / Non-Vivo Devices: Applies standard AOSP optimizations (RAM cache purge, CPU process priority locks, network/doze bypass, and display/touch boosts).
  • Vivo / iQOO (Hardware Optimizations ON): Activates the verified OriginOS/FuntouchOS hardware suite (1080p @ 120Hz Mode 4 lock, RMS display arbitration, touch boost, and OEM daemon whitelisting).
  • Vivo / iQOO (Hardware Optimizations OFF): Safely executes only non-invasive baseline tweaks (RAM cache purge, background app suspension, and DND). Generic AOSP display/thermal overrides are deliberately bypassed to protect against 60Hz lockouts and RMS arbitration conflicts.

[!IMPORTANT] Encountering "Parse Failed" or "Unsupported Hardware"?

If thermal monitoring displays "Parse Failed" or "Unsupported Hardware" on your device:

  1. Clone the repository and install the Debug APK (./gradlew installDebug) or download FrameX-v1.5.16-debug.apk. (Release builds strip diagnostic logs via ProGuard).
  2. Open the Thermal Diagnostics screen in FrameX.
  3. Run the following ADB commands to capture complete diagnostics:
    # 1. Capture FrameX internal thermal logs
    adb logcat -d | grep -E "ThermalMonitor|CmdRunner"
    
    # 2. Capture raw system thermal HAL dump
    adb shell dumpsys thermalservice
    
    # 3. Capture sysfs thermal zones (if dumpsys is empty/HAL Ready: false)
    adb shell "for z in /sys/class/thermal/thermal_zone*; do echo \"\$(cat \$z/type 2>/dev/null):\$(cat \$z/temp 2>/dev/null)\"; done"
    
    (On Windows PowerShell for Step 1: adb logcat -d | Select-String -Pattern "ThermalMonitor|CmdRunner")
  4. Open a GitHub Issue attaching the outputs above along with your device model, SoC, and Android/ROM version.

What it does

FrameX displays a fully customizable, low-overhead overlay on top of any application or full-screen title.

CategoryTelemetry & Features
Real-Time TelemetryFPS · CPU Frequencies · Thermals (CPU/GPU/Skin/NPU/Battery) · RAM Usage · Network Speed · Ping
System Optimization• Crash-Safe Snapshots: Automatic pre-game setting capture & auto-revert on exit
• Process Management: Background app suspension & Doze CPU whitelisting
• Emergency Safety: One-swipe reset slider to purge overrides back to stock OS defaults
OEM Hardware Locks• Vivo OriginOS Engine: Forces hardware Mode 4 ($1080 \times 2400$ @ 120Hz) lock
• Triple Whitelisting: Automatic injection across 4 native OriginOS game-booster daemons

Requirements

  • Android 8.0 (API 26) or higher
  • Shizuku installed and running
  • Activate via Wireless Debugging (no PC needed on Android 11+) or ADB
  • Works with the Sui module on rooted devices

Screenshots

App image
Onboarding 1
App image
Onboarding 2
App image
Dashboard (No Setup)
App image
Dashboard (Running)
App image
System Setup
App image
Overlay Config
App image
Appearance Settings
App image
Performance Mode
App image
Thermal Diagnostics
App image
About & Legal

How FPS is measured

FrameX measures frame rates directly at the Android OS compositor layer using privileged IPC calls to SurfaceFlinger --timestats. Because telemetry is gathered directly from the display pipeline, it adds zero overhead to game rendering threads or GPU pipelines.

FPS Architecture Diagram


Build

Standard Android Gradle project. Requires JDK 17 and Android SDK 34.

git clone https://github.com/MaheshSharan/FrameX-Android.git
cd FrameX-Android
./gradlew assembleDebug

Permissions

PermissionWhy
Draw over other appsDisplay the overlay on top of games
Foreground serviceKeep the overlay alive while the screen is on
Wake lockPrevent CPU sleep during an active session
PACKAGE_USAGE_STATSIdentify which game is in the foreground
REQUEST_IGNORE_BATTERY_OPTIMIZATIONSSurvive aggressive OEM background-kill policies
Receive boot completedAuto-restart overlay after reboot if it was active
InternetPing measurement to 8.8.8.8 (Google Public DNS) only
Kill background processesUsed to purge cached background apps during Gaming Mode activation
Access notification policyRequired to toggle Do Not Disturb mode automatically
Modify system settingsRequired to deploy per-game brightness, volume, and rotation overrides
Foreground service (Special Use)Ensures Gaming Mode stays active on Android 14+
Post Notifications (Android 13+)Display session status & quick-control notification controls
QUERY_ALL_PACKAGESLoad installed games and apps for Game Launcher optimization
Shizuku Privileged APIHigh-precision FPS metering (SurfaceFlinger), multi-sensor thermal diagnostics (IThermalService), ART RAM heap compaction, and OriginOS Esports hardware engine

Security & Privacy

  • No data collection — nothing is sent anywhere
  • No analytics — no Firebase, no Crashlytics, no tracking SDKs
  • No accounts — FrameX has no sign-in or user identity
  • No ads — ever
  • All data stays on-device

Full Privacy Policy


Known Limitations

A small number of metrics depend on data some device vendors don't expose. See KNOWN_LIMITATIONS.md for confirmed cases and affected devices.


Credits

  • Shizuku by RikkaW — the privileged API bridge that makes rootless system access possible. FrameX would not exist without it.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Release Notes & Changelog

What's new

  • Thermal False Alarm Fix: Resolved incorrect CRITICAL/HOT warnings on cold devices (#106).
  • Redesigned Thermal Diagnostics: Added synchronized multi-metric charts, touch scrubbing, and session summary matrix (#115).
  • Optimized Telemetry Engine: Atomic CPU/thermal IPC queries (#112); offline CPU clusters hidden from HUD (#113).
  • Non-Blocking Session Logger: Background ring buffer logging to eliminate frame hitches while recording (#76).
  • Dedicated iQOO Suite & Standalone Sliders: Separated iQOO/Vivo controls (#102), fixed late game PID handshake (#102), and restored standalone optimization sliders (#105).
  • Startup & Updater Fixes: Skipped splash delay when auto-check is disabled (#114) and streamlined direct APK downloads.

Declared Android Permissions

19 total

Shizuku API Permissions

moe.shizuku.manager.permission.API_V23

This application connects to the Shizuku service to execute system-level operations with ADB elevated privileges.

Standard Android Permissions

SYSTEM_ALERT_WINDOW
PACKAGE_USAGE_STATS
WRITE_SETTINGS
FOREGROUND_SERVICE
FOREGROUND_SERVICE_MEDIA_PLAYBACK
FOREGROUND_SERVICE_DATA_SYNC
POST_NOTIFICATIONS
REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
WAKE_LOCK
RECEIVE_BOOT_COMPLETED
FOREGROUND_SERVICE_SPECIAL_USE
KILL_BACKGROUND_PROCESSES
ACCESS_NOTIFICATION_POLICY
QUERY_ALL_PACKAGES
REQUEST_INSTALL_PACKAGES
REQUEST_DELETE_PACKAGES
INTERNET
com.framex.app.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION

Specifications

Packagecom.framex.app
LicenseMIT
GitHub Stars214
Installs818
Target SDKAndroid 14+ (API 34)
Last UpdatedOctober 16, 2026
Release DateNovember 17, 2026
Root RequirementRootless (Shizuku)
ShizuStore Installation

Install via ShizuStore to enable automatic updates and silent installations using Shizuku.