gitwtfhub

wtf is isodrive?

jingmatrix/isodrive — explained in plain English

Analysis updated 2026-08-08 · repo last pushed 2023-09-02

5Audience · ops devopsComplexity · 3/5DormantSetup · hard

TL;DR

IsoDrive turns your phone into a bootable USB drive. Plug it into a computer with a cable and the PC can boot from an OS image stored on your phone as if it were a flash drive or CD-ROM.

Mindmap

mindmap
  root((repo))
    What it does
      Phone becomes bootable USB
      Supports CD-ROM mode
      Supports read-write drive mode
    Tech stack
      C
      Halium Linux phones
      Termux on Android
      Magisk module option
    Use cases
      Boot rescue disks
      Install Linux without USB stick
      Carry multiple OS images
    Audience
      Linux enthusiasts
      IT support staff
      Mobile Linux users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Boot a Linux rescue disk on a PC using only your phone and a USB cable

REASON 2

Test or install a new Linux distribution on a computer without a spare USB stick

REASON 3

Carry multiple bootable OS images on your phone for on-the-go IT support tasks

What's in the stack?

CLinuxTermuxHaliumMagisk

How it stacks up

jingmatrix/isodrive00kaku/wp-rest-playground1ncendium/aibuster
Stars555
LanguageJavaScriptPython
Last pushed2023-09-02
MaintenanceDormant
Setup difficultyhardhardmoderate
Complexity3/53/53/5
Audienceops devopsdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires compiling in Termux with manual config on Android, or a Magisk module setup, plus a Halium or Linux-based phone for best compatibility.

Wtf does this do

IsoDrive lets you plug your phone into a computer and use it as a bootable USB drive. Instead of burning a Linux installation file onto a USB stick, you can store that file on your phone, connect the phone to your PC with a cable, and the PC will boot from it as if the phone were a regular flash drive or CD-ROM. This is handy if you need to install or test an operating system on a computer but do not have a spare USB stick handy. The tool works by making your phone pretend to be an external storage device from the computer's perspective. You run a simple command pointing to the file you want to use, and the software handles the connection so the PC sees a bootable drive rather than just a phone. You can choose to mount the file as a read-only CD-ROM or as a read-write drive, depending on what the target computer needs. When you are done, running the tool again disconnects everything. This would appeal to Linux enthusiasts, tinkerers, and IT support people who frequently test or install operating systems. For example, if you carry your phone around anyway and occasionally need to boot a rescue disk or try a new Linux distribution on a laptop, this saves you from carrying a dedicated USB stick. It is especially aimed at people running Linux on their phones, though it also works on Android with some extra setup. The project is designed for mobile Linux environments, particularly those built on Halium, though it should work on mainstream Linux phones too. On Android, it requires compiling within Termux and may need some manual configuration steps, or you can install a Magisk module for a simpler experience. The README notes it should support almost any bootable OS image, with a wiki documenting any that require special handling.

Yoink these prompts

Prompt 1
Help me compile and run IsoDrive in Termux on my Android phone so I can boot a Linux ISO from my phone on my PC
Prompt 2
Walk me through setting up the IsoDrive Magisk module on my rooted Android phone to boot an OS image on my computer
Prompt 3
My PC won't boot from my phone connected via IsoDrive, help me troubleshoot the USB connection and BIOS boot settings
Prompt 4
Help me choose between mounting an ISO as read-only CD-ROM vs read-write drive in IsoDrive for installing a specific Linux distribution

Frequently asked questions

wtf is isodrive?

IsoDrive turns your phone into a bootable USB drive. Plug it into a computer with a cable and the PC can boot from an OS image stored on your phone as if it were a flash drive or CD-ROM.

Is isodrive actively maintained?

Dormant — no commits in 2+ years (last push 2023-09-02).

How hard is isodrive to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is isodrive for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.