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…

这是干什么的?HyperChanger 是一个面向 Xiaomi HyperOS 4 Beta 的 LSPosed 模块,可以在已 root 的小米设备上自定义通知栏、控制中心、锁屏、系统界面(System UI)和相机,全部操作都能在一个配套应用里完成。
它是一个普通的安卓应用,还是会真正修改系统?它由两部分组成:一个用于设置的配套应用,以及一个在运行时挂钩(hook)小米系统包的 LSPosed 模块。它不会替换 System UI 或相机应用,而是从内部对它们进行调整。
我怎么把它装到手机上?从 Releases 安装已签名的 APK,在 LSPosed 中启用 HyperChanger 并只勾选你的环境需要的作用域,然后在配套应用里修改选项,再通过应用内的重启操作重启受影响的进程。
我的手机需要满足什么条件才能用?需要一台已 root 的小米设备,运行兼容的 HyperOS 4 Beta 版本(Android 13 / API 33 或更高),并且 LSPosed API 为 101 或以上。Release 里的 APK 本身是通用的。
能放心用吗,会不会把手机搞坏?这是 beta 软件,会挂钩 HyperOS 的内部实现,而这些实现因设备、地区和版本而异:今天还能用的调整,可能在系统更新后失效、导致 System UI 不稳定,甚至需要进恢复模式才能关闭。
代码可以自由使用和修改吗?可以——采用 Apache License 2.0,其中的 NOTICE 文件保留了对原始 MIT 许可版本的署名,用于历史归属说明。
具体能自定义哪些东西?控制中心和通知栏的材质、背景、圆角和预设;灵动岛和状态栏布局,包括双行信号图标;锁屏小组件,例如天气、电池、步数和自定义签名图;小爱键盘的毛玻璃样式;还可以禁用系统更新。
我可以把我的设置分享给别人吗?可以——预设可以导出为 JSON 或二维码,也能重新导入。长按预设即可看到导出选项;导入时会先按 HyperChanger 的预设格式和版本进行校验,通过后才会应用。
这个模块是小米官方做的吗?不是。这是一个实验性的社区开发项目,与小米没有任何隶属或认可关系,也不保证对特定设备的兼容性——请随时备好恢复手段。
如果 System UI 一直崩溃,或者某个调整没效果怎么办?如果 System UI 陷入反复重启,先在 LSPosed 中停用 HyperChanger、重启手机,然后逐个重新启用设置。如果某项修改毫无反应,请检查它在 LSPosed 中对应的作用域是否已勾选,并重启受影响的进程。
Creator
ColdP
Size
22.5 MB
Stars
269
Age
2mo
Commits · 90 Days