HyperChanger README

The project's README from github.com/ColdP/HyperChanger. As one markdown file: README.md.

HyperChanger icon

HyperChanger

Shape HyperOS 4 your way.

中文 | Releases | Telegram Group | QQ Group

Join the community on Telegram: https://t.me/HyperChanger

Join the QQ group: 429188055

Release Platform minSdk License

Overview

HyperChanger is an LSPosed module for selected Xiaomi HyperOS 4 Beta builds. It exposes System UI, notification shade, lock-screen, and camera-related customization in one companion app. The module is intended for rooted devices and does not replace System UI or Xiaomi Camera applications.

The project is in beta. HyperOS framework classes and resources can differ by device, region, and system build. A setting that works on one build may be unavailable or behave differently on another.

Disclaimer

HyperChanger is an experimental, community-developed LSPosed module and is not affiliated with or endorsed by Xiaomi. It requires root access and a compatible LSPosed environment, and it hooks vendor implementation details that may change between HyperOS builds. Hooks can be ineffective, cause System UI instability, or require recovery-based disabling. Use the module at your own risk, keep a recovery path available, and back up important data before testing. The project provides no guarantee of compatibility, availability, or fitness for a particular device.

Features

Notification shade and Control Center

System UI and Lock Screen

Super XiaoAi input method

System updates and compatibility

Languages and presets

Compatibility and Requirements

Requirement Details
Android Android 13 (API 33) or later
System Compatible Xiaomi HyperOS 4 Beta build
Root framework Root access and LSPosed API 101 or later
Architecture The release APK is universal; device compatibility is determined by the target HyperOS build

HyperChanger relies on implementation details of Xiaomi system packages. Update the module only after keeping a way to disable it through LSPosed or recovery if you are testing a new system build.

Module Scopes

Enable HyperChanger in LSPosed and select only the scopes required for the features you use. The module declares the following supported packages:

Scope Package
System UI com.android.systemui
System UI plugin miui.systemui.plugin
Always-on display com.miui.aod
Xiaomi Camera com.android.camera
Xiaomi Gallery com.miui.gallery
Hyper Gallery plugin com.hyper.gallery.plugin
Media editor com.miui.mediaeditor
Super XiaoAi input method com.xiaomi.type
XiaoAi phrases com.miui.phrase
System updater com.android.updater

Some packages are optional and may not be installed on every device. LSPosed will only activate hooks for installed, selected scopes.

Installation

  1. Download the latest signed APK from Releases.
  2. Install the APK normally. If Android blocks the install, allow the installer source when prompted.
  3. In LSPosed, enable HyperChanger and select the scopes required for your configuration.
  4. Open HyperChanger and set the desired options.
  5. Use the in-app restart action, or restart the affected System UI process, after changing System UI settings.

Do not enable every scope solely for convenience. Enabling only the packages used by your configuration reduces the number of processes that load the module.

Using Presets

The notification-shade preset page supports built-in and user-defined presets. Long-press a preset to access export options, then choose JSON or QR code sharing. Importing validates the HyperChanger preset format and version before settings are applied.

Imported settings can affect several visual options at once. Review the result and restart System UI to apply hook-based changes.

Troubleshooting

Symptom Recommended action
A change does not take effect Confirm the required LSPosed scope is enabled, then restart the affected process.
System UI repeatedly restarts Disable HyperChanger in LSPosed, reboot, and re-enable settings one at a time.
A page has no effect on a device The corresponding HyperOS build may not expose a compatible implementation. Leave the option disabled and include device and system details in an issue.
Import fails Confirm the file or QR code was exported by a compatible HyperChanger release.

When reporting an issue, include the device model, Android and HyperOS versions, HyperChanger version, enabled scopes, reproduction steps, and relevant Logcat output with personal data removed.

Build From Source

Prerequisites

git clone https://github.com/ColdP/HyperChanger.git
cd HyperChanger
./gradlew assembleDebug

The debug APK is written to app/build/outputs/apk/debug/.

Release Build and Signing

Build the optimized release variant with a keystore stored outside the repository:

./gradlew assembleRelease \
  -PreleaseStoreFile=/absolute/path/to/keystore \
  -PreleaseStorePassword=your-store-password \
  -PreleaseKeyAlias=your-key-alias \
  -PreleaseKeyPassword=your-key-password

The signed APK is written to app/build/outputs/apk/release/. Never commit a keystore, its password, or a generated APK to the repository.

Project Structure

HyperChanger/
|-- app/
|   |-- src/main/java/       Kotlin and Java module sources
|   |-- src/main/res/        Android resources
|   `-- src/main/resources/  LSPosed metadata and scopes
|-- gradle/                  Gradle wrapper files
|-- CONTRIBUTING.md
|-- NOTICE
`-- LICENSE

Contributing

Contributions are welcome. Read CONTRIBUTING.md before opening an issue or pull request.

License

HyperChanger is released under the Apache License 2.0. See NOTICE for historical attribution to the original MIT-licensed release.

HyperChanger (ColdP/HyperChanger)

Searching Database…

269 ·GitHub
HyperChanger
What is this?HyperChanger is an LSPosed module for Xiaomi HyperOS 4 Beta that customizes the notification shade, Control Center, lock screen, System UI, and camera on rooted Xiaomi devices, all from one companion app.
Is this a regular Android app, or does it actually modify the system?It is two pieces: a companion app for settings and an LSPosed module that hooks Xiaomi system packages at runtime. It does not replace the System UI or Camera apps — it tweaks them from inside.
How do I get it on my phone?Install the signed APK from Releases, enable HyperChanger in LSPosed and select only the scopes your setup needs, change options in the app, then restart the affected process via the in-app restart action.
What does my phone need before this will work?A rooted Xiaomi device on a compatible HyperOS 4 Beta build with Android 13 (API 33) or later, plus LSPosed API 101 or later. The release APK itself is universal.
Can I trust it not to break my phone?It is beta software that hooks HyperOS internals, which differ by device, region, and build: a tweak that works today may break after an update, destabilize System UI, or need recovery to disable.
Is the code free to use and modify?Yes — Apache License 2.0, with the NOTICE file crediting the original MIT-licensed release for historical attribution.
What can I actually customize with it?Control Center and notification-shade materials, backgrounds, corners, and presets; Dynamic Island and status-bar layout, including dual-row signal indicators; lock-screen widgets like weather, battery, steps, and custom signature images; XiaoAi keyboard glass styling; plus disabling system updates.
Can I share my settings with other people?Yes — presets can be exported and imported as JSON or QR codes. Long-press a preset for export options, and imports are checked against the HyperChanger preset format and version before anything is applied.
Is this module made by Xiaomi?No. It is an experimental, community-developed project with no affiliation to or endorsement from Xiaomi, and it offers no compatibility guarantee for a particular device — keep a recovery path handy.
What if System UI keeps crashing or a tweak has no effect?If System UI restarts in a loop, disable HyperChanger in LSPosed, reboot, and re-enable settings one at a time. If a change does nothing, check that its LSPosed scope is enabled and restart the affected process.
What are similar projects?awesome-android-root, Shizuku-Next, Vector, BiliRoaming, LSPosed, Magisk, KernelSU, Seal
Which topics is it in?xiaomi, xposed, android-application, kotlin-android, root, modding, theme, android-app, kotlin, customization, mobile, android
Creator
ColdP
Size
22.5 MB
Stars
269
Updated
CommitOct 16Releasev1.2.0Oct 13
Age
2mo
Commits · 90 Days