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
Что это такое?HyperChanger — это модуль LSPosed для Xiaomi HyperOS 4 Beta, который настраивает шторку уведомлений, Центр управления, экран блокировки, System UI и камеру на рутированных устройствах Xiaomi, причём всё — из одного приложения-компаньона.
Это обычное Android-приложение или оно меняет саму систему?Здесь две части: приложение-компаньон для настроек и модуль LSPosed, который на ходу встраивается в системные пакеты Xiaomi. Он не подменяет System UI или приложение камеры — он подстраивает их изнутри.
Как установить его на телефон?Установите подписанный APK из Releases, включите HyperChanger в LSPosed и отметьте только те scope'ы, которые нужны именно вашей конфигурации, измените настройки в приложении, а затем перезапустите затронутый процесс прямо из приложения.
Что нужно на телефоне, чтобы всё это заработало?Рутированное устройство Xiaomi на совместимой сборке HyperOS 4 Beta с Android 13 (API 33) или новее, а также LSPosed API 101 или новее. Сам release-APK универсальный.
Можно быть уверенным, что телефон не сломается?Это бета-версия, которая встраивается во внутренности HyperOS, а они различаются в зависимости от устройства, региона и сборки: настройка, которая работает сегодня, может перестать работать после обновления, расшатать System UI или потребовать режима восстановления, чтобы её отключить.
Код можно свободно использовать и менять?Да — лицензия Apache License 2.0, а файл NOTICE указывает авторство оригинального релиза под MIT для исторической справки.
Что конкретно можно настроить с его помощью?Материалы, фоны, углы и пресеты Центра управления и шторки уведомлений; Dynamic Island и раскладку строки состояния, включая двухрядные индикаторы сигнала; виджеты экрана блокировки — погоду, батарею, шаги и собственные изображения-подписи; стеклянное оформление клавиатуры XiaoAi; плюс отключение системных обновлений.
Можно поделиться своими настройками с другими людьми?Да — пресеты можно экспортировать и импортировать в виде JSON или QR-кодов. Долгое нажатие на пресет открывает варианты экспорта, а перед применением импортированные файлы проверяются на соответствие формату и версии пресетов HyperChanger.
Этот модуль сделан самой Xiaomi?Нет. Это экспериментальный проект, развиваемый сообществом, никак не связанный с Xiaomi и не одобренный ею; гарантий совместимости с конкретным устройством он не даёт — держите под рукой способ восстановления.
Что делать, если System UI постоянно падает или настройка не срабатывает?Если System UI перезапускается по кругу, отключите HyperChanger в LSPosed, перезагрузите телефон и включайте настройки по одной. Если изменение не даёт эффекта, проверьте, что соответствующий scope включён в LSPosed, и перезапустите затронутый процесс.
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