Metadata-Version: 2.4
Name: miflash
Version: 1.0.0
Summary: Flash Xiaomi fastboot ROMs on Termux, Linux, macOS, or Windows
Author: offici5l
License-Expression: MIT
Project-URL: Repository, https://github.com/MiForge/miflash
Keywords: xiaomi,miflash,fastboot,flash,bootloader,MIUI,HyperOS,Tools
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich
Dynamic: license-file

<div align="center">

<a href="https://github.com/miforge/miflash/releases/latest">
  <img src="https://img.shields.io/badge/miflash-%23FF6900?style=flat&logo=xiaomi&logoColor=white" alt="miflash" width="100"/>
</a>

**Flash Xiaomi fastboot ROMs (`.tgz`) from Termux, Linux, macOS, or Windows.**

---

[![Version](https://img.shields.io/pypi/v/miflash?label=Version&labelColor=black&color=brightgreen)](https://pypi.org/project/miflash/)
[![Changelog](https://img.shields.io/badge/Changelog-blue?style=flat&logoColor=white)](CHANGELOG.md)

---

</div>

---

## Install

```bash
pip install miflash
```

## Usage

```bash
miflash
```

Scans for `.tgz` ROMs (current directory, or shared storage on Termux), lets you pick one, extracts it if needed, lets you pick a flash script, waits for your device in fastboot mode, then flashes it. fastboot itself is handled automatically, nothing to install by hand.

To scan a specific folder:

```bash
miflash /path/to/roms
```

## Notes

On Termux you'll need the [Termux:API](https://github.com/termux/termux-api/releases/latest) app, and a storage permission prompt the first time — accept it.

On Windows, only ROMs that ship `.bat` flash scripts are supported.

<div align="center">

[![License](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)

</div>
