# ISO Droid

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

## Screenshots

<table>
  <tr>
    <td align="center">
      <img src="docs/screenshots/list_images_home.jpg" width="250px" alt="File Browser"/>
      <br />
      <b>File Browser with OS Icons</b>
    </td>
    <td align="center">
      <img src="docs/screenshots/mounted_status_home.jpg" width="250px" alt="Mounted Status"/>
      <br />
      <b>Mounted Status</b>
    </td>
  </tr>
  <tr>
    <td align="center">
      <img src="docs/screenshots/mount_options_dialogbox.jpg" width="250px" alt="Mount Options"/>
      <br />
      <b>Mount Options Dialog</b>
    </td>
    <td align="center">
      <img src="docs/screenshots/create_img_digalogbox.jpg" width="250px" alt="Create IMG"/>
      <br />
      <b>Create IMG Dialog</b>
    </td>
  </tr>
  <tr>
    <td align="center">
      <img src="docs/screenshots/list_listing_download.jpg" width="250px" alt="Download ISOs"/>
      <br />
      <b>Download OS ISOs</b>
    </td>
    <td align="center">
    </td>
  </tr>
</table>

## 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**: *Coming soon*
- **Gitea Releases**: [Download latest APK](https://git.sargit.com/sargit/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/isodrive/` (or configure a different directory in settings)

> **Note**: The app includes a bundled `isodrive` binary. No additional setup required!

## 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

- [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
- OS icons from [Simple Icons](https://simpleicons.org/)

## License

GNU General Public License v3.0 - See [LICENSE](LICENSE) file for details