Skip to content

libre-tools/usb-flasher-android

USB Flasher for Android

License Android

✨ Features

  • Rootless Operation: Works on non-rooted devices using the Android USB Host API.
  • Raw Block Writing: Flashes images directly to the raw block device, bypassing partition table limits.
  • Verification: Automatically verifies the written data against the source file (SHA-256) to ensure data integrity.
  • Auto-Detection: Automatically detects and selects connected USB mass storage devices.
  • Wake Lock: Keeps your screen on during long flash operations.
  • Safety First: Does not support Windows ISOs or macOS DMG files to prevent frustration (these require complex bootloader workarounds). Explicitly designed for Linux Hybrid ISOs (Ubuntu, Fedora, Debian, Arch, etc.).

🚀 Getting Started

Prerequisites

  • An Android Device with OTG (On-The-Go) support.
  • Android 8.0 (Oreo) or higher (API Level 26+).
  • A USB OTG adapter (USB-C to USB-A).

Installation

Download the latest APK from the Releases page.

🛠️ Building from Source

  1. Clone the repository:

    git clone https://github.com/libre-tools/usb-flasher-android.git
    cd usb-flasher-android
  2. Open in Android Studio:

    • Select "Open an existing Android Studio project".
    • Navigate to the cloned directory.
  3. Build the APK:

    ./gradlew assembleDebug

    The APK will be located at app/build/outputs/apk/debug/app-debug.apk.

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to get started.

🛡️ Security

If you discover a security vulnerability, please check SECURITY.md for our disclosure policy.

📜 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Acknowledgments

  • Built using libaums (modified for raw block access).
  • Material Design 3 (Jetpack Compose).

About

Flash Linux ISO images to USB drives directly from your Android device. Rootless & Open Source.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published