2 releases

0.1.1	Apr 9, 2023
0.1.0	Apr 9, 2023

#57 in #input-file

35 downloads per month

MIT license

1MB
313 lines

otadump

otadump helps you extract partitions from Android OTA files.
Partitions can be individually flashed to your device using fastboot.

Compared to other tools, otadump is significantly faster and handles file verification - no fear of a bad OTA file bricking your device.

Demo

Features

	crazystylus/otadump	ssut/payload-dumper-go	vm03/payload_dumper
Input file verification	✔	✔
Output file verification	✔
Extract selective partitions	✔	✔	✔
Parallelized extraction	✔	✔
Incremental OTA support			Partial

Benchmarks

Comparing the time taken to extract all partitions from a few sample files (lower is better):

Benchmarks

Note: otadump was run with args --no-verify -c 12 and payload-dumper-go was run with args -c 12

System specifications:

Processor: AMD Ryzen 5 5600X (12) @ 3.700GHz
RAM: 16 GiB
OS: Pop!_OS 22.04 / Linux 6.0.6
SSD: Samsung 970 EVO 250GB

Installation

macOS / Linux

Install a pre-built binary:

curl -sS https://raw.githubusercontent.com/crazystylus/otadump/mainline/install.sh | bash

Otherwise, using Cargo:

# Needs LZMA and Protobuf libraries installed.
# - On macOS: brew install protobuf xz
# - On Debian / Ubuntu: apt install liblzma-dev protobuf-compiler
cargo install --locked otadump

Windows

Download the pre-built binary from the Releases page. Extract it and run the otadump.exe file.

Usage

Run the following command in your terminal:

otadump payload.bin

Dependencies

~9–19MB
~253K SLoC