Skip to content
This repository was archived by the owner on Nov 12, 2025. It is now read-only.
/ SimpleBoot Public archive

Turn your rooted Android phone into a bootable USB drive. Mount and boot ISOs via ConfigFS, legacy, or loopback – no PC needed.

License

Notifications You must be signed in to change notification settings

matthewdaluz/SimpleBoot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SimpleBoot is now a product of RedHead Industries, a non-profit organization that I have founded -- By the people, for the people. This does not mean SimpleBoot is now proprietary, this is simply a change of ownership (and where SimpleBoot's repository will be at).

πŸ“± SimpleBoot

SimpleBoot is a powerful, root-required Android app that transforms your phone into a fully bootable USB device. Mount ISO/IMG files via ConfigFS, Legacy mass_storage, or raw Loopback mode and boot directly into live systems on any PC.

Successor to DriveDroid and PhoneStick, built for Android 11+ with full modern kernel and ConfigFS support.


πŸš€ Features

  • πŸ” Automatic ISO/IMG discovery from /storage/emulated/0/SimpleBootISOs
  • πŸ“¦ Three mount methods:
    • ConfigFS: For most modern kernels
    • Legacy: For older Android USB stacks
    • Loopback: For direct mount w/o USB gadget (testing or chaining)
  • πŸ’Ώ CD-ROM boot mode with forced descriptors for BIOS/UEFI compatibility (Deprecated. To be removed in later builds.)
  • πŸ” Root shell integration using libsu
  • 🧠 Complete logging of all mount/unmount operations (SimpleBootLogs)
  • πŸŒ“ Light/Dark mode Jetpack Compose UI
  • πŸ› οΈ Per-ISO selection of mount method
  • 🧲 Toggle USB Charging + ADB from within the UI
  • βš™οΈ Persistent preferences for read-only mounting
  • πŸ“€ Export logs and diagnostics for debugging

πŸ“Έ Screenshots

Screenshot 1 Screenshot 2

βš™οΈ Requirements

  • πŸ“± Android 11+ (API 30 or later)
  • πŸ“² Root access (Magisk recommended)
  • πŸ”Œ OTG-capable USB port
  • πŸ“¦ Kernel support for ConfigFS (most modern AOSP-based ROMs)
  • πŸ§ͺ Optional: Legacy USB gadget stack for older devices

πŸ—‚ File System Layout

  • /storage/emulated/0/SimpleBootISOs/
    Drop your .iso or .img files here
  • /storage/emulated/0/SimpleBootLogs/
    Verbose mount/unmount logs
  • /storage/emulated/0/SimpleBootLogs/mount_log_YYYYMMDD.txt
    Daily logs for boot diagnostics
  • /dev/block/loopX
    Loop device usage via losetup (automatic)

πŸ’» How It Works

  1. You select an ISO from the UI
  2. You choose the desired mount method
  3. SimpleBoot sets up the USB gadget using ConfigFS or legacy nodes
  4. It attaches the loop device and configures the gadget as a bootable CD-ROM
  5. Your PC sees it as a USB boot drive β€” boot away!

πŸ“¦ Mount Methods Explained

Method Description
ConfigFS Modern gadget system. Uses /config/usb_gadget/.... Required for Android 11+
Legacy Uses /sys/class/android_usb/android0/ and f_mass_storage. Older devices
Loopback Mounts ISO to /dev/block/loop7 only (no USB exposure). For dev/testing

⚠️ Disclaimers

  • πŸ“› This app requires root and full filesystem access
  • 🧱 Misconfiguration or unsupported kernels may cause boot failures or USB stack issues
  • ⚑ SimpleBoot tries to restore ADB/charging state on every unmount and mount failure

πŸ› οΈ Built With


πŸ“œ License

GNU GPLv3 – see LICENSE


πŸ’¬ Contribute

Pull requests welcome for:

  • Additional mount backends (e.g. FFS + userspace)
  • USB mode presets (keyboard, HID)
  • Multi-ISO boot chains (Ventoy-style)
  • USB detection callback API (notify when PC sees device)

πŸ™ Credits

  • Lead Dev: @matthewdaluz
  • AI Assistants: ChatGPT + DeepSeek
  • Special Thanks: The open-source Android root community

πŸ”š Final Words

SimpleBoot gives Android users full control over USB boot from their pocket. Whether you're an IT tech, a Linux user, or just want to carry live systems on your phone β€” this tool is the bootloader companion you've been missing.

✨ Mount. Boot. Reboot. Simple. ✨

About

Turn your rooted Android phone into a bootable USB drive. Mount and boot ISOs via ConfigFS, legacy, or loopback – no PC needed.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages