83 lines
4.1 KiB
Markdown
83 lines
4.1 KiB
Markdown
# ISO Droid
|
|
|
|
> **Note:** This app requires root access and was developed with AI assistance (Claude).
|
|
> I use it on my own devices, but as with any root tool, understand what you're running and keep backups.
|
|
>
|
|
> See [full disclaimer](docs/DISCLAIMER.md) | [Report issues](https://git.sargit.com/sargit/ISODroid/issues)
|
|
|
|
Android app for mounting ISO/IMG files as USB mass storage or CD-ROM devices on rooted Android devices.
|
|
|
|
## Screenshots
|
|
|
|
| OS images listing | Mount Options Dialog | Mounted Status | Create IMG Dialog | Download OS ISOs |
|
|
|:--:|:--:|:--:|:--:|:--:|
|
|
|  |  |  |  |  |
|
|
|
|
## 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
|
|
- 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)
|
|
|
|
## Download
|
|
|
|
| F-Droid | Gitea Releases |
|
|
|:--:|:--:|
|
|
| [](https://f-droid.org/en/packages/sh.sar.isodroid) | [Download latest APK](https://git.shihaam.dev/shihaam/ISODroid/releases) |
|
|
|
|
## Installation
|
|
|
|
1. Download the APK from the links above
|
|
2. Install the APK on your rooted Android device
|
|
3. Grant root access when prompted
|
|
4. Place your ISO/IMG files in `/sdcard/isodroid/` (or configure a different directory in settings)
|
|
|
|
## Usage
|
|
|
|
1. Open ISO Droid
|
|
2. Select an ISO/IMG file from the list
|
|
3. Choose mount options (Mass Storage or CD-ROM, Read-Only or Read-Write)
|
|
4. Tap Mount
|
|
5. Connect your phone to a PC via USB - it will appear as a USB drive/CD-ROM
|
|
6. Unmount via the app or notification when done
|
|
|
|
### Creating Custom IMG Files
|
|
|
|
1. Tap the "+" button in the top bar
|
|
2. Enter a filename and size
|
|
3. The app will create a blank IMG file that can be mounted as a writable USB drive
|
|
4. Format it on your PC after mounting (FAT32, exFAT, NTFS, etc.)
|
|
|
|
## Documentation
|
|
|
|
- **[Building & Technical Details](docs/BUILDING.md)** - How to build from source, architecture overview, and technical documentation
|
|
|
|
## Credits & Inspiration
|
|
|
|
Around 2014/2015 I rooted my first phone and went down the rabbit hole of what you could do with a rooted Android.
|
|
That's when I found [DriveDroid](https://softwarebakery.com/projects/drivedroid) ([archive](https://web.archive.org/web/20160901000000*/https://softwarebakery.com/projects/drivedroid)) by Software Bakery. Teenage me thought it was the coolest thing ever.
|
|
fastforwrd few years: DriveDroid stopped being maintained, 404 on playstore, and even if you find apk floating around ([Kali NetHunter](https://store.nethunter.com/packages/com.softwarebakery.drivedroid/) keeps one) it does not work on modern Android. I've wanted something like it for years.
|
|
Then I found [isodrive](https://github.com/nitanmarcel/isodrive) by nitanmarcel ([mirror](https://git.shihaam.dev/shihaam/isodrive)). Tried it. It worked. So here we are. ISO Droid is basically me chasing that teenage nostalgia and trying to make something simple that just works.
|
|
The name comes from **Drive**Droid + **iso**drive = **ISO Droid**. Not very creative, but it fits.
|
|
|
|
Special thanks to:
|
|
- [isodrive](https://github.com/nitanmarcel/isodrive) by nitanmarcel - The CLI tool that powers ISO Droid
|
|
- [ISODriveUT](https://github.com/fredldotme/ISODriveUT) by fredldotme - Original inspiration for isodrive
|
|
- [DriveDroid](https://softwarebakery.com/projects/drivedroid) by Software Bakery - where it all started
|
|
- [Simple Icons](https://simpleicons.org/) and [SVG Repo](https://www.svgrepo.com/) for OS icons
|
|
|
|
## License
|
|
|
|
GNU General Public License v3.0 - See [LICENSE](LICENSE) file for details
|