Skip to content

aikinci/XiaoMiToolV2-fork

 
 

Repository files navigation

Xiaomi Minimalistic Unlock Tool

A lightweight Python CLI tool to unlock Xiaomi devices, replacing the legacy Java-based XiaomiToolV2.

Features

  • Minimalistic: Single-file Python script.
  • Cross-Platform: Works on Linux, macOS, and Windows (requires python3).
  • Transparency: Clear, readable code implementing the official unlocking protocol.

Requirements

  • Python 3.7+
  • fastboot installed and in your system PATH.
  • Python libraries: pycryptodome, requests.

Installation

  1. Clone this repository.
  2. Run the installer:
    chmod +x install.sh
    ./install.sh

Usage

  1. Get Credentials:

    • Log in to account.xiaomi.com.
    • Extract userId and passToken cookies from your browser developer tools.
  2. Run the Tool:

    ./mi_unlock --userid <YOUR_USER_ID> --token <YOUR_PASS_TOKEN>
  3. Follow Instructions:

    • Put your device in Fastboot mode (Volume Down + Power).
    • The tool will detect the device and attempt to unlock it.

Technical Details

For a detailed explanation of the unlock mechanism, see UNLOCK_MECHANISM.md.

Disclaimer

Unlocking your bootloader may void your warranty. Use this tool at your own risk.

About

XiaomiTool V2 - fork Modding tool for xiaomi devices

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 88.0%
  • Shell 12.0%