Skip to content

Latest commit

 

History

History
102 lines (87 loc) · 2.98 KB

README_en-US.md

File metadata and controls

102 lines (87 loc) · 2.98 KB

HyperOS Porting Project

Rewrote in Python

Based on https://github.com/ljc-fight/miui_port

简体中文  |  English

Intro

  • HyperOS Porting Project for Android 13 devices "Onekey" script

Tested devices and portroms

  • Tested Devices: Xiaomi 10/Pro/Ultra(umi/cmi/cas) (with latest stock/xiaomi.eu MIUI14 ROM)
  • Tested Ports: Xiaomi Mi 13/13Pro/14/14Pro K70Pro Stable and Dev stock flashable zip、xiaomi.eu latest HyperOS ROM

Working

  • Face unlock
  • Fringerprint
  • Camera(from leaked mi10s A13 based hyperos)
  • Automatic Brightness
  • NFC
  • etc

BUG

  • When unlocking device, the screen may flicker , Enabling "Disable HW overlays" in Developer options may help.

Description

  • All the above testing is based on Xiaomi 10/10Pro/10 Ultra official/xiaomi.eu MIUI 14 version. for V-AB devices, tester needed.

How to use

  • On Windows

Note

You need install python3 and java first

   # Clone project
   git clone https://github.com/toraidl/hyperos_port.git
   cd hyperos_port
   # Install dependencies
   pip3 install -r requirements.txt
   # Start porting
   python ./port.py <baserom> <portrom>
  • On WSL、ubuntu、deepin and other Linux
    sudo apt update
    sudo apt upgrade
    sudo apt install git -y
    # Clone project
    git clone https://github.com/toraidl/hyperos_port.git
    cd hyperos_port
    # Install dependencies
    pip3 install -r requirements.txt
    sudo ./setup.sh
    # Start porting
    sudo python3 ./port.py <baserom> <portrom>
  • on macOS (AMD64)
    # Install brew
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

    # Clone project
    git clone https://github.com/toraidl/hyperos_port.git
    cd hyperos_port
    # Install dependencies
    pip3 install -r requirements.txt
    sudo ./setup.sh
     # Start porting
    sudo python3 ./port.py <baserom> <portrom>
  • On Termux Android (not tested)
    pkg update
    pkg upgrade
    pkg install git tsu -y
    # Clone project
    git clone https://github.com/toraidl/hyperos_port.git
    cd hyperos_port/
    # Install depenencies
    pip3 install -r requirements.txt
    ./setup.sh
    # Enter root mode 
    tsu
    python3 ./port.py <baserom> <portrom>
  • baserom and portrom can be a direct download link. you can get the ota download link from third-party websites.

Credits

In this project, some or all of the content is derived from the following open-source projects. Special thanks to the developers of these projects.