Xiaomi Flashable Firmware Creator
Create flashable firmware zip from MIUI and HyperOS Recovery ROMs!
Xiaomi Flashable Firmware Creator is a tool that generates flashable firmware-update packages from official MIUI and HyperOS ROMS.
It supports creating untouched firmware, non-arb firmware, firmware + vendor flashable zip, and firmware-less ROMs from any local zip file or direct link of the zip file.
Requirements
This tool requires the following dependencies to be installed on your system:
- payload-dumper-go: Used for extracting Android OTA payload files. Install using your system package manager or from releases.
- xz: Required for payload decompression.
Installing xz
Linux and macOS (From package manager, recommended):
- Ubuntu/Debian:
sudo apt install xz-utils - CentOS/RHEL/Fedora:
sudo yum install xzorsudo dnf install xz - Arch Linux:
sudo pacman -S xz - openSUSE:
sudo zypper install xz - macOS (Homebrew):
brew install xz - macOS (MacPorts):
sudo port install xz
- Download the latest XZ Utils for Windows from tukaani.org/xz/
- Extract the downloaded archive to a directory on your system
- Add the directory containing
xz.exeto your system's PATH environment variable
xz --version in your terminal to confirm xz is properly installed.
Note: Working on a SSD is highly recommended for performance reasons when processing large payload files, as HDDs can be a bottleneck.
Installation
You can simply install this tool using uv.
``shell script
uv install xiaomi_flashable_firmware_creator
shell script
xiaomi_flashable_firmware_creator [-h] (-F FIRMWARE | -N NONARB | -L FIRMWARELESS | -V VENDOR) [-o OUTPUT]
### CLI UsageExamples:
- Creating normal (untouched) firmware:shell script
* Creating non-arb firmware (without anti-rollback):* Creating firmware-less ROM (stock untouched ROM with just firmware removed):* Creating firmware + vendor flashable zip:### Using from other Python scriptsinitialize firmware creator object with the following parameters:
input_file: zip file to extract from. It can be a local path or a remote direct url.
process: Which mode should the tool use. This must be one of "firmware", "nonarb", "firmwareless" or "vendor". (See CLI Usage for more details)
out_dir: The output directory to store the extracted file in.
firmware_creator = FlashableFirmwareCreator(input_zip, process, output_dir)
Now, you can either use auto() method to create the new zip file or do stuff at your own using firmware_creator public methods.
new_zip = firmware_creator.auto() `
Development
This project uses several tools to streamline the development process:
mise
mise is used for managing project-level dependencies and environment variables. mise helps ensure consistent development environments across different machines.
To get started with mise:
- Install mise by following the instructions on the official website.
- Run
mise install in the project root to set up the development environment.
This file is automatically loaded by mise and allows you to customize your local development environment without modifying the shared configuration files.
UV
UV is used for dependency management and packaging. It provides a clean, version-controlled way to manage project dependencies.
To set up the project with UV:
- Install UV using mise, or by following the instructions on the official website.
- Run
uv sync to install project dependencies.
Development Tools
For development, this project uses additional tools managed by mise:
- payload-dumper-go: Automatically managed by mise when you run
mise install`.