payload-dumper/README.md

43 lines
802 B
Markdown

# payload dumper
Dumps the `payload.bin` image found in Android update images. Has significant performance gains over other tools due to using multiprocessing.
## Installation
### Requirements
- Python3
- pip
### Install using pip
```sh
pip install --user payload_dumper
```
## Example ASCIIcast
[![asciicast](https://asciinema.org/a/UbDZGZwCXux50sSzy1fc1bhaO.svg)](https://asciinema.org/a/UbDZGZwCXux50sSzy1fc1bhaO)
## Usage
### Dumping the entirety of `payload.bin`
```
payload_dumper payload.bin
```
### Dumping specific partitions
Use a comma-separated list of partitions to dump:
```
payload_dumper --partitions boot,dtbo,vendor payload.bin
```
### Patching older image with OTA
Assuming the old partitions are in a directory named `old/`:
```
payload_dumper --diff payload.bin
```