# payload dumper

> Python script that extracts the partition images, such as boot.img and system.img, from the payload.bin inside an Android OTA update package. It handles full OTAs directly and incremental OTAs with --diff by applying the update to original images that the user copies from a full OTA or dumps from the device, and it can also run from a Docker image.

- Type: Tool
- Targets: Firmware
- Category: Firmware tools
- Relationship: Foundation tool
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-06
- Original resource: <https://github.com/vm03/payload_dumper>
- Primary source: <https://github.com/vm03/payload_dumper/blob/2f0a964b8b77c6244e3e12735f85539c938f9c97/README.md>
- Catalog page: <https://awesomerea.org/resources/payload-dumper/>
- Record JSON: <https://awesomerea.org/resources/payload-dumper/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/payload-dumper/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.6 or later with the protobuf package from requirements.txt; the user supplies the OTA package's payload.bin. The README says the script was tested on Yandex Amber OTAs, both full and incremental, under Linux and may also work on Windows.
- **Scope:** The repository has no releases, and the reviewed master commit dates from 2025-04-18.
- **License:** The repository has no license file and GitHub detects no license.

## Primary sources

1. <https://github.com/vm03/payload_dumper/blob/2f0a964b8b77c6244e3e12735f85539c938f9c97/README.md>
2. <https://github.com/vm03/payload_dumper/blob/2f0a964b8b77c6244e3e12735f85539c938f9c97/payload_dumper.py>
3. <https://github.com/vm03/payload_dumper/blob/2f0a964b8b77c6244e3e12735f85539c938f9c97/requirements.txt>

## More in Firmware and hardware

- [PMCA-RE RELOADED](https://awesomerea.org/resources/pmca-re-reloaded/index.md) · Tool
- [ThisFirmwareDoesNotExist](https://awesomerea.org/resources/thisfirmwaredoesnotexist/index.md) · Tool
- [intel_ma](https://awesomerea.org/resources/intel-ma/index.md) · Tool
- [qemu-rtd2841](https://awesomerea.org/resources/qemu-rtd2841/index.md) · Tool
- [MS4X](https://awesomerea.org/resources/ms4x/index.md) · Tool
- [AC46 Firmware Tool](https://awesomerea.org/resources/ac46-firmware-tool/index.md) · Tool

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.