v0.1.0 Release • Pure Rust 2024 (MSRV 1.88) • Dual Native GUIs (Win32 + Iced 0.14) • 10-Tool MCP Server

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.

Download v0.1.0 Binaries ↓ Inspect Dual-GUI & Forensics Workbench Explore 10-Tool MCP Server → Read Project Wiki ↗
2 Native GUIs
WinSafe Win32 + Iced 0.14
27 Operations
ADB, Fastboot & Offline Forensics
10 MCP Tools
stdio JSON-RPC + Destructive Guard
12 Commands
8 Presets & Bidirectional .a2r
Two First-Class Pure-Rust Consoles

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.

WinSafe 0.0.29 ~2.86 MiB Binary Windows Default GUI

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 MessageBox destructive prompt blocks unguarded flashes, erases, unlocks, and uninstalls.
Iced 0.14 (Elm MVU) ~10.77 MiB Binary Linux / macOS / Windows

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 wgpu with automatic tiny-skia CPU rasterizer fallback (ICED_BACKEND=tiny-skia).
  • Light & Dark Themes: Instant Light/Dark switcher in the top toolbar plus rfd 0.18 native file pickers and arboard 3.6 clipboard 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, and shared_prefs XML artifacts cleanly even without Android Platform-Tools installed.
Deterministic Core & Forensics

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.

Workflow Comparison

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
Interactive Console Walkthrough

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.

android2rust-win32.exe — 7 Native TabPage Views ~2.86 MiB • Zero GPU / RDP Safe
[Menu: &File | &Job | &Execution | &Help] [Op: adb install] [Serial: R58M123] [Src: "C:\Builds\app.apk"] +---------------------------------------------------------------------------------------------------+ | [1. Designer & Diagnostics] [2. ADB & Packages] [3. Transfer & Logcat] [4. Fastboot & Flash] | | [5. Forensics & Artifacts] [6. Live Console & Records] [7. Batch & History] | +---------------------------------------------------------------------------------------------------+ | Command Preview: adb -s R58M123 install -r -g "C:\Builds\app.apk" | | Validation ListView: [OK] 0 Errors, 0 Warnings • Local APK exists • Safe transfer flags | | Worker Relay: mpsc::Receiver -> wnd.run_ui_thread(...) • Destructive Guard: Native OS MessageBox | +---------------------------------------------------------------------------------------------------+

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.

android2rust-iced — 1360x840 Elm MVU Workbench wgpu + tiny-skia fallback • Dark/Light
[Top Toolbar] [Op Picker] | [Transport] | [Serial] | [Source/File] | [Target/Out] | [Dry-Run] | [Run] | [Theme] +-------------------------+-------------------------------------------------------------------------+ | SIDEBAR (250 px) | ACTIVE WORKSPACE: Live Console & Records (Idle poll: 0% CPU) | | > Job Designer | ----------------------------------------------------------------------- | | > ADB & Packages | Modals (ActiveModal): | | > Transfer & Logcat | - ConfirmDestructive (blocks flash/erase/unlock/uninstall/restore) | | > Fastboot & Flash | - ImportCommand (paste raw adb/fastboot CLI directly into GUI state) | | > Forensic Inspector | - SaveProfile (writes %APPDATA%\android2rust\profiles.json) | | > Live Console | - TaskScheduler (schtasks /Create Daily/Weekly/Hourly/OnLogon) | | > Batch Queue | - StatusCodeReference (ADB / Package Manager / Fastboot decoder) | | > History & Reports | - About (License, Crate Versions & Supply-Chain Info) | +-------------------------+-------------------------------------------------------------------------+

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.

android2rust inspect — Pure-Rust Binary Parser ZERO ADB / JVM REQUIRED
PS> android2rust inspect "C:\Evidence\backup.ab" --report "C:\Evidence\audit.html" Artifact : C:\Evidence\backup.ab Format : Android Backup (.ab) Size : 42.18 MB SHA-256 : 9c41f77e208b63a1...d12f0891aa02 Format Version : 5 Compressed (zlib) : true Encryption : none TAR Payload Size : 98.40 MB TAR Entries Discovered: 314 (apps/com.example.vault/db/messages.db [SQLite 3, WAL], AndroidManifest.xml [7 permissions]) Audit report written: C:\Evidence\audit.html

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.

android2rust dry-run & build — Pre-Flight Safety Diagnostics ZERO DEVICE WRITES
PS> android2rust dry-run --preset fastboot-flash-image --source "C:\Images\bootloader.img" --target bootloader [WARN] DESTRUCTIVE_OP: Fastboot flash alters device partition contents (use --yes only after verification). [WARN] CRITICAL_PARTITION_FLASH: Boot-critical partition 'bootloader' targeted — hard-brick risk on mismatched image. [DRY-RUN] Verified local image exists: C:\Images\bootloader.img (12,582,912 B | SHA-256 verified) [COMMAND] fastboot flash bootloader "C:\Images\bootloader.img" PS> android2rust build --preset apk-install-grant --source "C:\Apps\app.apk" --serial R58M123 --export-recipe job.a2r --export-ps1 job.ps1 --export-sh job.sh [EXPORT] Wrote job.a2r, job.ps1, and job.sh cleanly.

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.

android2rust-mcp — JSON-RPC 2.0 (protocol 2024-11-05) SAFETY REFUSAL ACTIVE
Client -> {"jsonrpc":"2.0","method":"tools/call","params":{"name":"android2rust_run","arguments":{"preset":"fastboot-flash-image","source":"boot.img","target":"boot","confirm_destructive":false}},"id":3} Server <- { "jsonrpc": "2.0", "result": { "isError": true, "content": [{ "type": "text", "text": "SAFETY REFUSAL: Job includes destructive operation(s) (fastboot flash boot). Re-run with android2rust_dry_run first or set confirm_destructive=true." }] }, "id": 3 }
Modular Pure-Rust Workspace

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.

android2rust-coreCore & Forensics

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.

flate2 1.1sha2 0.11walkdir 2.5
android2rust-runnerStreaming

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.

regex 1.13mpscCancelToken
android2rust-reportAudit Bundles

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.

htmlserde_jsonmarkdown
android2rust-mcpAI Bridge

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.

stdiojson-rpc 2.010 tools
android2rust-cliUnified CLI

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.

clap 4.6ctrlc 3.4tracing
android2rust-win32Native Win32

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).

winsafe 0.0.29zero-gpu~2.86 MiB
android2rust-icedCross-Platform GUI

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).

iced 0.14tiny-skiarfd 0.18
Model Context Protocol (2024-11-05)

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):

mcp.json
{
  "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_commandjob, preset, source, target, serial, include_scriptsValidates job parameters and optionally emits .a2r, .bat, .ps1, .sh, and schtasks.
android2rust_parse_commandcommand | recipe_pathParses a raw CLI command or .a2r recipe file into normalized command text, warnings, and JSON.
android2rust_decode_statuscodeDecodes numeric exit codes and Android/ADB/Fastboot errors (e.g. INSTALL_FAILED_*).
android2rust_profilesaction, name, job, store_dirPerforms persistent CRUD (list, get, save, delete) on profiles.json.
android2rust_inspect_artifactpath, max_entriesPure-Rust offline inspection of .apk, .ab, SQLite .db, shared_prefs XML, or logs.
android2rust_dry_runjob | command | preset, source, targetRuns non-destructive pre-flight validation and local artifact verification without touching devices.
android2rust_run..., confirm_destructive: boolExecutes job; strictly refuses flash/erase/format/unlock/uninstall/restore/sideload unless confirm_destructive: true.
android2rust_reportoutput, format, log_path | jobGenerates standalone offline HTML, JSON, Markdown, or full audit bundles on disk.
Protocol & Diagnostics

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):

Interactive Status Code Decoder (Click Any Token)
Interactive CLI Builder

Command-Line Interface Generator

Build normalized android2rust commands across all 12 subcommands and 8 built-in presets.

Generated android2rust Command
android2rust inspect "C:\Evidence\backup.ab" --report audit.html
Release v0.1.0 & Source Build

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
x86_64-pc-windows-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).

Download .ZIP ↓

Linux (64-Bit)

GNU
x86_64-unknown-linux-gnu

Native ELF binaries: android2rust CLI, android2rust-iced (wgpu + tiny-skia), and android2rust-mcp.

Download .TAR.GZ ↓

macOS Apple Silicon

ARM64
aarch64-apple-darwin (M1–M4)

Native Mach-O ARM64 binaries for Apple Silicon Mac workstations (ADB/Fastboot control, offline forensics, and MCP).

Download .TAR.GZ ↓

macOS Intel (64-Bit)

x86_64
x86_64-apple-darwin

Universal 64-bit Intel Mach-O binaries for Intel Mac systems plus full source compilation via Rust 1.88+.

Download .TAR.GZ ↓
View GitHub Releases ↗ Download Checksums (SHA256SUMS.txt) ↗ Browse packaging/ Manifests ↗

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).

WinGet, Homebrew & Cargo Build
# 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
Community & Ecosystem

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.

Systems Architecture

Part of the GUAP Open-Source Suite

Created by Andrew Paolucci under GUAP (General Utilities & Application Protocols). Dedicated to replacing heavy runtime wrappers and proprietary black boxes with fast, memory-safe, auditable systems software.