|
1 | 1 | # 🚀 HyperOS Porting Tool (Python) |
2 | 2 |
|
3 | | -[](https://www.python.org/) |
4 | | -[](LICENSE) |
5 | | -[](https://www.ubuntu.com/) |
| 3 | +[](https://github.com/toraidl/HyperOS-Port-Python/stargazers) |
| 4 | +[](https://github.com/toraidl/HyperOS-Port-Python/network/members) |
6 | 5 |
|
7 | 6 | [中文 (Chinese)](README.md) | **English** |
8 | 7 |
|
9 | | -A powerful, automated Python-based tool for porting HyperOS ROMs across Xiaomi/Redmi devices. This tool handles the entire lifecycle: unpacking, smart patching, feature restoration, repacking, and signing. |
| 8 | +A HyperOS ROM porting tool for Xiaomi/Redmi devices. It covers the common workflow: unpacking, patch processing, feature adaptation, repacking, and OTA package output. |
10 | 9 |
|
11 | 10 | --- |
12 | 11 |
|
13 | 12 | ## 🌟 Key Features |
14 | 13 |
|
15 | | -- 🛠️ **Fully Automated**: End-to-end porting process from stock/port ZIPs to flashable output. |
16 | | -- 💉 **Smart Patching**: Automated modification of firmware, system, framework, and ROM properties. |
17 | | -- 🧬 **GKI Support**: Intelligent KernelSU injection for GKI 2.0 (5.10+) and standard GKI devices. |
| 14 | +- 🛠️ **Workflow Automation**: From stock/port ZIPs to flashable output in one pipeline. |
| 15 | +- 💉 **System Patching**: Rule-based modifications for firmware, system, framework, and ROM properties. |
| 16 | +- 🧬 **GKI Support**: KernelSU injection support for GKI 2.0 (5.10+) and standard GKI devices. |
18 | 17 | - 🔓 **Android 16 Ready**: Specialized `vendor_boot` fstab patching for KMI 6.12 to prevent fastboot bootloops. |
19 | | -- 🚀 **Wild Boost**: Auto-installation of performance modules with kernel version detection. |
| 18 | +- 🚀 **Wild Boost (Rage Engine)**: Ports the Redmi-specific rage engine to Xiaomi targets; requires matching kernel versions. Currently validated on Xiaomi 12S and Xiaomi 13. |
20 | 19 | - 🧩 **Modular Configuration**: Toggle features (AOD, AI Engine, etc.) via simple JSON files. |
21 | 20 | - 🌏 **EU Localization**: Restore China-exclusive features (NFC, XiaoAi) to Global/EU bases. |
22 | 21 | - 📦 **Multi-Format Support**: Generate `payload.bin` (Recovery/OTA) or `super.img` (Hybrid/Fastboot) formats. |
23 | | -- 🔒 **Auto-Signing**: Automatically signs the final flashable ZIP for seamless installation. |
| 22 | +- 🔒 **Official OTA Upgrade Path**: Produces packages compatible with the official OTA format, enabling AB upgrades via the official Updater app; rollback is available if issues occur. |
24 | 23 |
|
25 | 24 | --- |
26 | 25 |
|
@@ -191,10 +190,10 @@ sudo python3 main.py --stock stock.zip --port port.zip --pack-type super --fs-ty |
191 | 190 | Automatically installs performance boost modules based on kernel version. |
192 | 191 |
|
193 | 192 | **Features:** |
194 | | -- 📌 **Auto-detection**: Detects kernel version (5.10 / 5.15+) |
| 193 | +- 📌 **Auto-detection**: Detects kernel version (5.10 / 5.15) |
195 | 194 | - 📌 **Smart Installation**: |
196 | 195 | - Kernel 5.10: Installs to `vendor_boot` ramdisk |
197 | | - - Kernel 5.15+: Installs to `vendor_dlkm` |
| 196 | + - Kernel 5.15: Installs to `vendor_dlkm` |
198 | 197 | - 📌 **AVB Auto-disable**: Prevents bootloop after modification |
199 | 198 | - 📌 **Device Spoofing**: HexPatch for `libmigui.so` |
200 | 199 | - 📌 **Fallback**: `persist.sys.feas.enable=true` for newer systems |
|
0 commit comments