Metadata-Version: 2.1
Name: dumpyara
Version: 1.0.4
Summary: Android firmware extractor
Home-page: https://github.com/sebaubuntu-python/dumpyara
License: GPL-3.0
Author: Sebastiano Barezzi
Author-email: seba@sebaubuntu.dev
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: Brotli (>=1.0.9,<2.0.0)
Requires-Dist: liblp (>=1.0.2,<2.0.0)
Requires-Dist: protobuf (>=4.22.1,<5.0.0)
Requires-Dist: sebaubuntu-libs (>=1.4.2,<2.0.0)
Project-URL: Repository, https://github.com/sebaubuntu-python/dumpyara
Description-Content-Type: text/markdown

# dumpyara

[![PyPI version](https://img.shields.io/pypi/v/dumpyara)](https://pypi.org/project/dumpyara/)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/85d2c39edbed4dc38f680db01f7b83af)](https://www.codacy.com/gh/sebaubuntu-python/dumpyara/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=sebaubuntu-python/dumpyara&amp;utm_campaign=Badge_Grade)

Requires Python 3.8 or greater

## Installation

```sh
pip3 install dumpyara
```

## Instructions

```sh
python3 -m dumpyara <path to OTA file>
```

## Supported formats

### Step 1 - Archives
-   All the ones supported by shutil's extract_archive

### Step 2 - What's inside the archive
-   A-only OTAs (Brotli and/or sdat compressed)
-   A/B OTAs
-   Dynamic partitions (super.img)
-   payload.bin
-   Raw images (e.g. Xiaomi fastboot packages)
-   Sparse images

### Step 3 - Partition images
-   Android boot images
-   7z supported archives/images
-   EROFS images using erofs-utils

## Credits
-   AIK: osm0sis
-   [extract_android_ota_payload](https://github.com/erfanoabdi/extract_android_ota_payload): cyxx and erfanoabdi
-   sdat2img: xpirt

## License

```
#
# Copyright (C) 2022 Dumpyara Project
#
# SPDX-License-Identifier: GPL-3.0
#
```

