Developed to retrieve encryptData(token)
for Xiaomi devices to unlock the bootloader.
Compatible with all platforms.

---

📖 Overview

MiUnlockTool is a Python-based utility designed to unlock Xiaomi devices using browser session authentication. This tool simplifies the bootloader unlocking process by automating token retrieval and device communication.

✨ Features

• 🔓 Automated bootloader unlocking process
• 🌐 Browser-based authentication
• 🖥️ Cross-platform compatibility (Windows, Linux, macOS)
• ⚡ Automatic platform-tools (fastboot) download
• 📱 Support for all Xiaomi devices

📋 Requirements

• Python 3.6 or higher
• Platform-tools (fastboot) - automatically downloaded if not found
• Active Xiaomi account
• Device in bootloader/fastboot mode

🚀 Installation

Standard Installation

1. Clone the repository:

   git clone https://github.com/rafliiar17/MiUnlockTool-Arch
   cd MiUnlockTool

2. Set up virtual environment and install dependencies:

   python -m venv venv && source venv/bin/activate
   python -m pip install -r requirements.txt

3. Make the script executable and run:

   chmod +x MiUnlockTool.py
   python MiUnlockTool.py

📱 Usage

1. Boot your Xiaomi device into fastboot/bootloader mode
2. Connect your device to the computer via USB
3. Run the MiUnlockTool script
4. Follow the on-screen instructions
5. Authenticate using your browser when prompted
6. Wait for the unlocking process to complete

⚠️ Important Notes

• ⚡ Unlocking the bootloader will erase all data on your device
• 🔒 Ensure you have backed up important data before proceeding
• ⏰ Some devices may have a waiting period before unlocking is allowed
• 🛡️ Unlocking may void your device warranty

🆘 Troubleshooting

Encountering errors? Check our comprehensive error codes documentation:

🧪 Tested Environment

This tool has been successfully tested on:

Component	Specification
🖥️ Operating System	Linux 6.17.3-3-cachyos
🐍 Python Version	Python 3.13.7
📱 Test Device	Redmi Note 8 4/64 (GINKGO)
👤 Tester	@rafliiar17

✅ Status: Confirmed working on the above configuration

🤝 Contributing

Contributions are welcome! Feel free to:

• 🐛 Report bugs
• 💡 Suggest new features
• 🔧 Submit pull requests
• 📖 Improve documentation

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

📞 Contact & Support

---

Made with ❤️ for the Xiaomi community

_{⚠️ Use at your own risk. The developers are not responsible for any damage to your device.}