# vm03/payload_dumper

Android OTA payload dumper

Repository: https://github.com/vm03/payload_dumper
Canonical: https://ross.abutalabs.com/products/payload_dumper
Language: Python
License Family: other
Last push: 2025-04-18T14:21:13+00:00

## Health v2 (maintenance only)
Score: 40/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 17, release rhythm 35, longevity 100
- inputs: {"age_days": 2570, "days_push": 502, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1779, forks 326 (observed 2026-08-28T04:05:35.304794+00:00)

## What it is
A Python CLI script that extracts system partition images (boot.img, system.img, etc.) from Android OTA update payload.bin files, supporting both full and incremental (diff) OTA payloads. It can also be run via Docker.

## Use cases
- extract system images from android ota payload.bin
- dump boot.img from a full ota zip
- apply incremental ota diff to existing images
- extract firmware images for flashing a custom rom
- unpack android update payload without a device

## When to choose
- you have an Android OTA zip and need the raw partition images inside payload.bin
- you want to reconstruct new images from an incremental OTA using original images
- you prefer a lightweight Python script or Docker container over full ROM extraction tools

## When to avoid
- you need to extract images directly from a device without an OTA file
- you need a GUI or one-click ROM extraction workflow
- you work with OTA formats other than Android's payload.bin

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, parser, file-system, compression
- domain: android-tools, developer-tools, files
- platform: windows, python, cli, cross-platform
- tags: android-ota, payload-extraction, firmware, system-images, protobuf, command-line, linux, macos, docker

## Member repositories
- vm03/payload_dumper (main) score 40

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:35.304794+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:25:08.332922+00:00, confidence not recorded.
  - readme: https://github.com/vm03/payload_dumper (fetched 2026-08-28T04:05:35.304794+00:00, sha 8c3fced84b02)
- Data as of 2026-08-30T08:39:29.467469+00:00.