New app: Leaf Flasher

Abstract for new app inclusion

Please introduce the functions and usage of your app in summary, and also attach some screenshots.

Leaf Flasher (com.sid_imp.leaf) turns an Android phone into a portable flashing station over USB OTG, allowing users to flash ROM packages and images to a second Android device without needing a PC.

Key capabilities:

  • Live USB OTG Protocol Detection: Automatically detects Bootloader (Fastboot), FastbootD, Android ADB, Recovery ADB, and Recovery ADB Sideload, while filtering out MediaTek BROM/Preloader and MTP interfaces.
  • Unified ROM & Storage Browser: Picks .zip packages or extracted ROM folders across Downloads, Phone Storage, mounted external SD cards, and Android SAF.
  • Parallel payload.bin Extractor: Zero-copy reading of uncompressed OTA ZIP entries with multi-worker parallel decompression (REPLACE, REPLACE_XZ, REPLACE_BZ, ZSTD, ZERO/DISCARD).
  • Guided 4-Step Flash Setup + Final Check: Clear choices for boot slot (A, B, A + B), clean vs dirty wipe, extra replacement .img files (e.g. Magisk/KernelSU patched boot.img), and dm-verity / vbmeta verification options.
  • Single Partition Flasher, Selective ZIP .img Extractor, Native ADB Sideload & Tools: Flash individual .img files with sparse chunking, extract one or more .img files (boot.img, init_boot.img, etc.) from payload.bin or Fastboot ROM .zips directly into Downloads/LeafFlasher/ for root patching, stream recovery ZIPs (GApps, Magisk, OTAs) via native Kotlin sideload-host, run manual commands, reboot modes, or switch slots.
  • 100% Offline & Tracker-Free: Declares zero INTERNET permission in AndroidManifest.xml, with no ads or analytics.

Screenshots (also in fastlane/metadata/android/en-US/images/phoneScreenshots/):

Home ROM Browser Parallel Unpacker Sideload & Tools
Home ROM Browser Parallel Unpacker Tools

Please elaborate why you wrote this app. Please highlight the unique functions it provides over other similar apps in F-Droid.

Most mobile flashing tools either depend on root on the host phone, external native fastboot/adb binaries, or terminal emulators. Leaf Flasher implements Fastboot, FastbootD, Android Sparse chunking, AVB 2.0 vbmeta header patching, parallel payload.bin extraction, and native USB ADB / sideload-host directly in pure Kotlin over Android's UsbManager host API with a guided UI and built-in per-step help guides.

Checklist

Policy

  • The app complies with the inclusion policy. Pay special attention to Quality point 6. (Note: Public GitHub repository devvsid/LeafFlasher was newly published in Nov 2026 at v2.0.0 after prior offline builds; also com.github.luben:zstd-jni:1.5.6-3@aar (BSD-licensed) is used for ZSTD OTA payload extraction — happy to wire a source build if fdroid scanner requires it.)
  • The original app author has been notified (and does not oppose the inclusion). Submitting directly as upstream author (sid_imp / @devvsid).
  • The upstream app source code repo contains the app metadata in a Fastlane or Triple-T folder structure. (en-US title, short/full description, icon, and 9 phoneScreenshots are present in fastlane/metadata/android/en-US/.)

Docs

Merge Request Setup

Metadata

  • Metadata must be put in metadata/<applicationId>.yml. (metadata/com.sid_imp.leaf.yml)
  • Metadata must be a valid YAML file.
  • Metadata must use LF as line ending.
  • Don't add summary/description/changelog/images or anything that should be provided in upstream repo. Please check the Changes tab to make sure there is no other unrelated files added in the MR.
  • Releases are tagged and auto update is enabled unless there is a special reason.
  • There is an issue tracker and contact info of the author so that we can report bugs and contact the author.
  • An AuthorName must be added. It doesn't need to be the real name.
  • External repos are added as git submodules instead of srclibs.
  • Enable Reproducible Builds. (Binaries + AllowedAPKSigningKeys configured against signed GitHub Release APK.)
  • Setup abi split if the APK is large and the splitted ones can be much smaller. (Single ~13.7 MiB universal APK.)
  • Only the latest versions should be kept in the metadata before it's merged.
  • Don't add any disabled versions in the metadata.
  • The commit field should be the full hash. (ffbc3e20b4d9d460a461853b7e418e668e7e91c3)

Pipeline

  • All pipelines should pass. (Note: GitLab fork pipeline #3057432980 failed immediately because this newly registered GitLab account has not added phone/credit-card verification for GitLab shared runners; kindly trigger F-Droid's FOSS CI runner on this MR.)
  • All warnings and errors in the Reports tab should be fixed or explained.
  • F-Droid CI runners are under GitLab's FOSS program, so there's no need for you to pay for any CI time. If Gitlab starts asking for phone numbers or credit cards don't submit anything, just leave a note in the MR so we know we need to trigger the CI.

Closes rfp#4779

Edited by sid_imp

Merge request reports

Loading
Loading