Payload Dumper Rust

Payload dumper is a tool for extracting the payload.bin archive typically found in some stock OTA ROMs. This module provides executables that support various architectures and can be run in a terminal emulator. Payload dumper is written in the very fast and efficient rust programming language.

What is Payload Dumper?

• Android payload is a file that contains ROM partitions like boot , system, vendor . and others. Payload Dumper extracts these partitions from the payload.bin file

features

• Extracts all or individual images directly from payload.bin or ROM ZIP file.

• Supports extracting individual partitions from URLs without downloading the full ROM ZIP.

• All decompression processes run in parallel for improved performance. ( can be customised by using--no-parallel or --threads <n> as argument )

• Output partitions Verification ✅
• Parallel Extraction ✅
• Selective Partition Extraction ✅
• Direct Extraction from URL ✅

How To Use

• Download Binaries for your respective Platform from releases section

• If you are using a rooted android device you might want to install it as a magisk module

• or Run this in termux / Linux Terminal to install

  bash <(curl -sSL "https://raw.githubusercontent.com/rhythmcache/payload-dumper-rust/main/scripts/install.sh")
  

• To install on windows, run this in Powershell

powershell -NoExit -ExecutionPolicy Bypass -Command "Invoke-RestMethod -Uri 'https://raw.githubusercontent.com/rhythmcache/payload-dumper-rust/main/scripts/install.ps1' | Invoke-Expression"

Usage

Basic Usage

To extract partitions from a payload file, run the following command:

payload_dumper <path/to/payload.bin> --out output_directory

Direct ZIP Processing

it can directly process payloads from ZIP files without requiring manual extraction. Simply provide the path to the ZIP file:

./payload_dumper <path/to/ota.zip> --out <output_directory>

Remote Payloads

it can also handle payloads/zips directly using url. Simply provide the URL as path. this is very slow compared to local extraction though.

./payload_dumper https://example.com/payload.bin

Individual partitions extraction.

• to extract individual partitions from payloads/URL/zips , use --images and enter the name of partitions you want to extract comma-separated.

for example to just extract boot and vendor_boot from url/zip/payload , simply run

payload_dumper --images boot,vendor_boot <https://example.com/zip>

Usage: payload_dumper [OPTIONS] <PAYLOAD_PATH>

Arguments:
  <PAYLOAD_PATH>  
      Path to the payload file.
  --out <OUT>  
      Output directory for extracted partitions. [default: output]
  --diff  
      Enable differential OTA mode (requires --old).
  --old <OLD>  
      Path to the directory containing old partition images (required for --diff). [default: old]
  --images <IMAGES>  
      Comma-separated list of partition names to extract (default: all partitions)
  --threads <THREADS>  
      Number of threads to use for parallel processing.
  --list  
      List available partitions
  --metadata
      Save complete metadata as json ( use -o - to write to stdout )
  --no-verify
      Skip Hash Verification    
  --no-parallel
      Disable parallel Extraction