97 lines
5.2 KiB
Markdown
97 lines
5.2 KiB
Markdown
# ISO Droid
|
|
|
|
[](https://sladge.net)
|
|
[](LICENSE)
|
|
|
|
|
|
|
|
[](docs/DISCLAIMER.md)
|
|
|
|
[](https://git.shihaam.dev/shihaam/ISODroid/releases/latest)
|
|
|
|
> **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) --> [Coming Soon](https://gitlab.com/fdroid/fdroiddata/-/merge_requests/34539) | [Download latest APK](https://git.shihaam.dev/shihaam/ISODroid/releases/latest) |
|
|
|
|
## 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.
|
|
|
|
Fast forward a 10 years: DriveDroid is no longer maintained, 404 on Play Store, and even if you find an APK ([Kali NetHunter App Store](https://store.nethunter.com/packages/com.softwarebakery.drivedroid/) keeps one) it does not work on modern Android.
|
|
|
|
As someone who gives tech support often to relatives and friends, I've wanted something like it for years. Having Linux to chroot or HBCD for Windows password reset at anytime without having to carry around USB drives is very useful for me.
|
|
Then I found [isodrive](https://github.com/nitanmarcel/isodrive) by nitanmarcel ([mirror](https://git.shihaam.dev/shihaam/isodrive)). I tried the Magisk module and Termux, 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 **iso**drive + Drive**Droid** = **ISO Droid**.
|
|
|
|
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 for me
|
|
- [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
|