ISO Droid

Android app for mounting ISO/IMG files as USB mass storage or CD-ROM devices on rooted Android devices.

Screenshots

Screenshots are available in the docs/screenshots/ directory.

Features

Mount ISO/IMG files as USB mass storage or CD-ROM
Create blank IMG files for writable USB drives
Read-only or read-write mount options
Persistent notification with quick unmount button
Browse and select ISO/IMG files from device storage
OS-specific icons for popular distributions (Linux, BSD, etc.)
Download links to popular operating systems (Linux, BSD, Windows, Recovery tools)
Rename and delete files
Material 3 dynamic theming with dark mode support

Requirements

Rooted Android device (Magisk, KernelSU, APatch, etc.)
USB gadget support (configfs or sysfs)
Android 8.0+ (API 26)

Installation

Option 1: Install APK (Recommended)

Download the latest ISO Droid APK from releases
Install the APK
Grant root access when prompted
The app includes a bundled isodrive binary
Place your ISO/IMG files in /sdcard/isodrive/ (or configure a different directory in settings)

Option 2: Install with Magisk Module

Install the isodrive Magisk module
Install the ISO Droid APK
Grant root access when prompted
Place your ISO/IMG files in /sdcard/isodrive/ (or configure a different directory in settings)

Building from Source

Prerequisites

Before building the app, you need to obtain the isodrive binary:

The isodrive binary is compiled from nitanmarcel/isodrive
Place the compiled binary at app/src/main/assets/bin/isodrive before building
The binary must be executable and compiled for the appropriate Android architecture

Build Steps

# Clone the repository
git clone https://github.com/yourusername/ISODroid.git
cd ISODroid

# Ensure isodrive binary is present
ls -la app/src/main/assets/bin/isodrive

# Build the APK
./gradlew assembleRelease

Usage

Open ISO Droid
Select an ISO/IMG file from the list
Choose mount options (Mass Storage or CD-ROM, Read-Only or Read-Write)
Tap Mount
Connect your phone to a PC via USB - it will appear as a USB drive/CD-ROM
Unmount via the app or notification when done

Creating Custom IMG Files

Tap the "+" button in the top bar
Enter a filename and size
The app will create a blank IMG file that can be mounted as a writable USB drive
Format it on your PC after mounting (FAT32, exFAT, NTFS, etc.)

Credits

isodrive by nitanmarcel - The CLI tool that powers ISO Droid
ISODriveUT by fredldotme - Original inspiration for isodrive
OS icons from Simple Icons

Technical Details

ISO Droid uses the isodrive binary to interface with the Linux USB gadget subsystem. The app:

Bundles the isodrive binary in app/src/main/assets/bin/
Extracts and executes it with root permissions at runtime
Supports both configfs (modern) and sysfs (legacy) USB gadget modes
Dynamically detects available OS icons for file display

License

MIT

3.2 KiB Raw Blame History