Android ADB, Fastboot & Offline Forensics. Rebuilt in Pure Rust.
A 100% pure-Rust desktop GUI wrapper, bidirectional ADB/Fastboot command & .a2r recipe orchestrator, offline .apk / .ab / SQLite .db / XML forensic inspector with SHA-256 chain-of-custody, air-gapped HTML/JSON/Markdown audit reporter, 12-subcommand CLI, and 10-tool Model Context Protocol (MCP) server — developed by Andrew Paolucci.
Zero-GPU Native Win32 & Cross-Platform Iced 0.14
Both GUIs share the exact same android2rust-core parser, offline forensics engine, runner, and audit report libraries — zero Electron, zero WebView2, zero Node.js, and zero JVM/Python dependencies.
android2rust-win32.exe
Authentic native Win32 Common Controls built directly on real HWND handles — designed specifically for Windows desktops, elevated Administrator sessions, Hyper-V/VMware consoles, and Windows Server over RDP where GPU acceleration is unavailable.
- ComCtl v6 & Per-Monitor DPI v2: Crisp native scaling, embedded manifests, and Vista+ COM dialogs (
IFileOpenDialog/IFileSaveDialog). - Zero-GPU GDI Rendering: Zero OpenGL or DirectX shader crashes in headless VMs or RDP sessions.
- 7 Native TabPages & Relay: Designer & Diagnostics, ADB & Packages, Transfer & Logcat, Fastboot & Flash, Forensics & Artifacts, Live Console & Records, and Batch & History, driven by
run_ui_thread. - Native OS Confirmation Gate: Native Win32
MessageBoxdestructive prompt blocks unguarded flashes, erases, unlocks, and uninstalls.
android2rust-iced
Consistent cross-platform retained-mode workstation built on Elm Model-View-Update architecture, shipping identically on Linux (X11/Wayland), macOS, and Windows (android2rust gui --iced) with zero-CPU idle polling.
- Hardware GPU + Software Fallback: Renders natively via
wgpuwith automatictiny-skiaCPU rasterizer fallback (ICED_BACKEND=tiny-skia). - Light & Dark Themes: Instant Light/Dark switcher in the top toolbar plus
rfd 0.18native file pickers andarboard 3.6clipboard integration. - 8 Workspace Tabs + 6 Modals: Sidebar presets, live validation counts, batch execution queue, 200-run history, Task Scheduler modal, and Status Decoder modal.
- Cross-OS Offline Forensics: Inspect local
.apk,.ab, SQLite.db, andshared_prefsXML artifacts cleanly even without Android Platform-Tools installed.
Unified ADB, Fastboot & Offline Artifact Inspection
27 typed operations and 8 built-in presets eliminating brittle batch files, unguarded flashes, and multi-tool forensic glue.
Complete ADB & Package Operations
Typed support for -s/-d/-e/-t targeting, devices -l, getprop, pm list packages (-3/-s/-f/-i/-U), install (-r/-d/-g/--user), uninstall (-k), disable-user/enable, pull/push (-a/-z), backup/restore, bugreport, logcat, shell, dumpsys, sideload, and reboot.
Fastboot & Partition Management
Covers devices, getvar all, flash (with --slot, --skip-reboot, --disable-verity, and --disable-verification), boot, erase, format, flashing unlock/lock, and targeted reboots (bootloader, fastbootd, recovery).
Pure-Rust Offline Forensics Engine
android2rust inspect parses .apk ZIP Central Directories, AndroidManifest.xml permissions, DEX headers, native .so ABIs, v1 signatures, .ab backups via zlib + POSIX TAR, SQLite 3 schemas/WAL flags, shared_prefs XML, and logs with SHA-256 chain-of-custody — zero adb, aapt2, or abe.jar required.
Bidirectional .a2r Recipes & Exporters
Paste any raw adb ... or fastboot ... command or load portable .a2r recipe files directly into the structured job model, and export repeatable .a2r, .bat, .ps1, .sh, and Windows schtasks /Create scripts.
Destructive Guards & 15 Validation Rules
Real-time pre-flight rules flag DESTRUCTIVE_OP, CRITICAL_PARTITION_FLASH (bootloader, aboot, xbl, radio, efs), TRANSPORT_OVERRIDE, and ADB_BACKUP_DEPRECATION while gating destructive actions behind GUI dialogs, CLI --yes, or MCP confirm_destructive: true.
Air-Gapped HTML, JSON & MD Reports
android2rust-report produces zero-CDN offline dark/light HTML reports (with interactive record search), structured JSON envelopes, and Markdown summaries embedding SHA-256 evidence hashes and decoded status badges.
android2rust vs. Legacy Android Tooling
Comparing desktop footprint, RDP reliability, offline forensic independence, and safety architecture across common Android workflows.
| Capability / Metric | android2rust (WinSafe + Iced) | Android Studio Explorer | Electron / WebView Wrappers | abe.jar / androguard + CLI |
|---|---|---|---|---|
| Windows Native & RDP Stability | WIN Zero-GPU Win32 (~2.86 MiB) — zero OpenGL crash risk | Heavy JVM IDE (~2 GB+ RAM) | Chromium process overhead | Console CLI only |
| Offline Artifact Forensics | WIN Single binary parses .apk, .ab zlib TAR, SQLite .db, XML |
APK Analyzer only (JVM) | None or subprocess shells | Requires Java / Python envs |
| Cross-Platform Reach | WIN Native Iced 0.14 on Linux, macOS, Windows (tiny-skia) |
Full IDE required | Chromium bundle per OS | Fragmented .bat / .sh scripts |
| Destructive Safety Guards | WIN 15 pre-flight rules, Dry-Run & explicit confirm gate | Basic IDE prompts | Unvalidated shell strings | Immediate execution on typo |
| Chain-of-Custody Auditability | WIN SHA-256 digests + offline HTML/JSON/MD reports | None | Plain log pane | Manual sha256sum piping |
| AI Agent Integration | WIN Built-in 10-tool stdio MCP Server + safety gate |
None | None | None |
Dual-GUI, Offline Forensics & MCP Workbench
Inspect how android2rust-win32, android2rust-iced, the pure-Rust forensic scanner, script exporters, and android2rust-mcp operate together.
Zero-GPU Native Win32 7-Tab Console (android2rust-win32.exe)
Native Win32 Common Controls via WinSafe 0.0.29 with ComCtl v6, Per-Monitor DPI v2, Vista+ COM dialogs, and run_ui_thread telemetry relay.
Cross-Platform Iced 0.14 Workstation (android2rust gui --iced)
Elm MVU UI running across Linux, macOS, and Windows with hardware wgpu and automatic tiny-skia CPU rendering fallback.
Pure-Rust Offline Forensic Inspection (android2rust inspect)
Inspects local .apk packages, .ab zlib backups, and SQLite .db WAL databases offline with SHA-256 chain-of-custody — zero external tools required.
Safe Fastboot Dry-Run & Script Exports (android2rust dry-run / build)
Pre-flight diagnostics warn on critical bootloader partitions and generate repeatable .a2r, .ps1, .sh, and schtasks scripts.
Model Context Protocol Safety Refusal Gate (android2rust-mcp)
Destructive agent calls lacking confirm_destructive: true are rejected at the JSON-RPC boundary while steering callers toward android2rust_dry_run.
The 7 Workspace Crates
Clean crate boundaries built on Rust 2024 Edition (MSRV 1.88) with 24 automated unit tests across all crates and cargo-deny supply-chain and license auditing.
AndroidJob schema covering 27 ADB/Fastboot/Forensic operations, Windows/POSIX quoting, bidirectional CLI & .a2r parser, 15 validation rules, status decoder, pure-Rust .apk/.ab/SQLite/XML forensic inspector, 8 presets, and profiles.json store.
Probes adb & fastboot on PATH and ANDROID_HOME, streams live \r/\n output under CREATE_NO_WINDOW, executes dry-run & offline forensics, enforces CancelToken kills, and hashes logs with SHA-256.
Emits zero-CDN standalone offline HTML (with interactive record filters and light/dark toggle), structured JSON (android2rust.audit.v1), and Markdown reports from live runs, logs, or raw artifacts.
Model Context Protocol JSON-RPC 2.0 stdio server (2024-11-05) and standalone android2rust-mcp binary (~2.73 MiB) exposing 10 structured tools with strict destructive refusal enforcement.
Unified CLI binary (android2rust, ~3.38 MiB) delivering 12 subcommands (presets, build, parse, decode, inspect, dry-run, run, profile, report, env, mcp, gui), two-stage Ctrl+C cancellation, and automatic GUI dispatch.
Zero-GPU native Win32 Common Controls console via WinSafe 0.0.29 (ComCtl v6, Per-Monitor DPI v2, Vista+ COM dialogs, 7 tabs, native MessageBox) built for Windows desktops & Server RDP (~2.86 MiB).
Cross-platform Elm MVU GUI on Iced 0.14 with wgpu + tiny-skia CPU fallback, Light/Dark themes, 8 workspace tabs, and 6 modal overlays across Linux, macOS, and Windows (~10.77 MiB).
10-Tool stdio MCP Server for AI Agents
Safe agentic Android administration and offline artifact forensics: probe SDK tools, inspect .apk/.ab/.db files locally, run non-destructive pre-flight checks, and require confirm_destructive: true for state-mutating operations.
Standard Client Configuration (mcp.json / Smithery Ready)
Register via android2rust mcp or invoke the standalone android2rust-mcp binary directly (diagnostic logs route strictly to stderr so JSON-RPC stdout remains uncorrupted):
{
"mcpServers": {
"android2rust": {
"command": "android2rust",
"args": ["mcp"],
"env": {
"RUST_LOG": "warn"
}
}
}
}
| MCP Tool Name | Key Arguments | Behavior & Safety Model |
|---|---|---|
android2rust_environment | {} | Probes host OS, adb & fastboot binaries, versions, and ProfileStore directory. |
android2rust_presets | {} | Lists all 8 built-in ADB, Fastboot, and Forensic presets with schemas and safety metadata. |
android2rust_build_command | job, preset, source, target, serial, include_scripts | Validates job parameters and optionally emits .a2r, .bat, .ps1, .sh, and schtasks. |
android2rust_parse_command | command | recipe_path | Parses a raw CLI command or .a2r recipe file into normalized command text, warnings, and JSON. |
android2rust_decode_status | code | Decodes numeric exit codes and Android/ADB/Fastboot errors (e.g. INSTALL_FAILED_*). |
android2rust_profiles | action, name, job, store_dir | Performs persistent CRUD (list, get, save, delete) on profiles.json. |
android2rust_inspect_artifact | path, max_entries | Pure-Rust offline inspection of .apk, .ab, SQLite .db, shared_prefs XML, or logs. |
android2rust_dry_run | job | command | preset, source, target | Runs non-destructive pre-flight validation and local artifact verification without touching devices. |
android2rust_run | ..., confirm_destructive: bool | Executes job; strictly refuses flash/erase/format/unlock/uninstall/restore/sideload unless confirm_destructive: true. |
android2rust_report | output, format, log_path | job | Generates standalone offline HTML, JSON, Markdown, or full audit bundles on disk. |
Android / ADB / Fastboot Status & Error Code Decoder
Test exit codes and common Android Package Manager, USB Transport, and Fastboot error tokens live below (powered by the exact lookup table in android2rust decode):
Command-Line Interface Generator
Build normalized android2rust commands across all 12 subcommands and 8 built-in presets.
android2rust inspect "C:\Evidence\backup.ab" --report audit.html
Pre-Compiled Standalone Binaries & Packaging
Self-contained native executables with zero external runtime dependencies. Packaged via GitHub Actions Release workflows (release.yml) alongside SHA256SUMS.txt.
Windows (64-Bit)
MSVC
Includes android2rust.exe (~3.38 MiB), android2rust-win32.exe (~2.86 MiB), android2rust-iced.exe (~10.77 MiB), and android2rust-mcp.exe (~2.73 MiB).
Linux (64-Bit)
GNU
Native ELF binaries: android2rust CLI, android2rust-iced (wgpu + tiny-skia), and android2rust-mcp.
macOS Apple Silicon
ARM64Native Mach-O ARM64 binaries for Apple Silicon Mac workstations (ADB/Fastboot control, offline forensics, and MCP).
macOS Intel (64-Bit)
x86_64
Universal 64-bit Intel Mach-O binaries for Intel Mac systems plus full source compilation via Rust 1.88+.
WinGet, Homebrew & Supply-Chain Verification
Ready-to-submit WinGet and Homebrew manifests live inside packaging/, while every workspace build is audited against advisories and Apache-2.0 compatible dependency licenses via cargo-deny (deny.toml).
# Windows Package Manager (WinGet) local manifest validation winget validate --manifest .\packaging\winget\manifests\a\adpaolucci\android2rust\0.1.0 # Homebrew (macOS & Linux) local formula test brew install --formula ./packaging/homebrew/android2rust.rb brew test android2rust # Build all 7 crates from source (Rust 1.88+ / 2024 edition) cargo test --workspace cargo build --workspace --release
Contributors & Acknowledgments
The developers, maintainers, and open-source foundations behind android2rust.
Andrew Paolucci (@adpaolucci)
Creator, systems architect, and lead software developer. Designed the 7-crate workspace, WinSafe/Iced dual-GUI architecture, offline APK/.ab/SQLite forensics scanner, and safety gates.
WinSafe & Iced Rust Ecosystems
Powered by Rodrigo Cesar de Freitas Dias's winsafe for authentic zero-GPU Win32 bindings and Héctor Ramón's iced framework for clean cross-platform Elm MVU rendering.
Open-Source Tooling & QA
24 unit tests, cargo-deny dependency & license policy auditing (Apache-2.0), comprehensive wiki documentation, and multi-target GitHub Actions CI matrices.