crazystylus / otadump

Extract partitions from Android OTA files.
MIT License
131 stars 17 forks source link
android hacktoberfest rust
# otadump [![crates.io][crates.io-badge]][crates.io] **`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][demo]

Features

crazystylus/otadump ssut/payload-dumper-go vm03/payload_dumper
Input file verification
Output file verification
Extract selective partitions
Parallelized extraction
Runs directly on .zip files
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:

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, Protobuf and pkg-config libraries installed.
# - On macOS: brew install protobuf xz pkg-config
# - On Debian / Ubuntu: apt install liblzma-dev protobuf-compiler pkg-config
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:

# Run directly on .zip file.
otadump ota.zip

# Run on payload.bin file.
otadump payload.bin

Contributors