A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.
docs(site): document USB device passthrough
ExTv3e37218a01c4
diff --git a/docs/guide/backends.html b/docs/guide/backends.htmlindex 206f10f..59adc34 100644--- a/docs/guide/backends.html+++ b/docs/guide/backends.html@@ -149,6 +149,11 @@<td>Supported</td><td>May be a no-op on shipping Pixel AVF builds (requires an AOSP-main SharedPath API not yet in stable releases)</td></tr>+ <tr>+ <td>USB device passthrough</td>+ <td>Supported (opt-in; adds a USB controller at boot)</td>+ <td>Not available - there is no QMP channel to stream device handles to the VM</td>+ </tr><tr><td>Verbose logging toggle</td><td>Not applicable</td>diff --git a/docs/guide/limitations.html b/docs/guide/limitations.htmlindex 55a989e..cfd30ec 100644--- a/docs/guide/limitations.html+++ b/docs/guide/limitations.html@@ -91,6 +91,11 @@<td>No fine-grained vCPU selection</td><td>Requesting more than one vCPU under AVF gives the VM all available host cores rather than the exact count chosen in Settings. The CPU count setting has full effect on the QEMU backend only.</td></tr>+ <tr>+ <td>USB passthrough</td>+ <td>QEMU backend only</td>+ <td>Passing a physical USB device into the VM works only on the QEMU backend, which streams the open device handle to the emulator over QMP. The AVF backend has no equivalent channel, so USB passthrough is unavailable there. It is also opt-in and adds a USB controller at boot, so it must be enabled while the VM is stopped.</td>+ </tr><tr><td>Storage</td><td>Size cannot be changed after setup without a full reset</td>diff --git a/docs/guide/settings.html b/docs/guide/settings.htmlindex 531a364..ec6a931 100644--- a/docs/guide/settings.html+++ b/docs/guide/settings.html@@ -149,6 +149,11 @@<td>Toggle</td><td>Shares the Android Downloads folder into the VM as a virtio-fs mount. May be a no-op on some AVF devices. Can be unstable on some QEMU configurations; disable it if the VM crashes on boot.</td></tr>+ <tr>+ <td>USB passthrough</td>+ <td>Toggle</td>+ <td>Passes a physically attached USB device (Wi-Fi adapter, storage, serial adapter, audio interface) into the VM, with no root. QEMU backend only. It adds a USB controller at boot, so the toggle takes effect only after a VM restart and is locked while the VM is running. When it is on, each device you attach prompts for permission once and then appears inside the guest while the app runs.</td>+ </tr></tbody></table>diff --git a/docs/index.html b/docs/index.htmlindex 7c5f369..93d1322 100644--- a/docs/index.html+++ b/docs/index.html@@ -645,6 +645,14 @@<p>Tap the monitor icon in the terminal and an in-app viewer opens, talking RFB to <code>Xvnc</code> inside the VM. Touch becomes mouse, soft-keyboard becomes keyboard, and PCM audio streams from PulseAudio. Run <code>firefox</code>, <code>xterm</code>, anything from Alpine.</p></div>+ <div class="feature-card">+ <div class="feature-icon">+ <svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" viewBox="0 0 24 24"><circle cx="12" cy="3" r="1.4"/><path d="M12 4.4V21"/><path d="M8.5 10.5 12 7l3.5 3.5"/><rect x="9" y="11" width="6" height="4.5" rx="1"/><path d="M7 16.5h10"/></svg>+ </div>+ <h3>USB device passthrough</h3>+ <p>Plug a real USB device (Wi-Fi adapter, storage, serial adapter, audio interface) into the running VM straight from Android, with no root and no device-filter XML. Flip the opt-in toggle in Settings, attach the device, grant permission once, and it shows up inside the guest. QEMU backend.</p>+ </div>+<div class="feature-card"><div class="feature-icon"><svg width="18" height="18" fill="none" stroke="currentColor" stroke-width="1.8" viewBox="0 0 24 24"><circle cx="12" cy="12" r="10"/><line x1="12" y1="8" x2="12" y2="12"/><line x1="12" y1="16" x2="12.01" y2="16"/></svg>@@ -969,6 +977,13 @@ qmp.sock → runtime port-forward control</div></div></details>+ <details>+ <summary>Can I plug in a USB device?</summary>+ <div class="faq-answer">+ Yes, on the QEMU backend. Enable <strong>USB passthrough</strong> in Settings (it adds a USB controller at boot, so set it while the VM is stopped), then attach a device through a USB-C hub or OTG adapter. Android asks for permission once per device, and it then appears inside the guest while Podroid is running. Works with Wi-Fi adapters, storage, serial adapters, audio interfaces, and more. Not available on the AVF backend, which has no channel to hand the device to the VM.+ </div>+ </details>+<details><summary>How much storage does it use?</summary><div class="faq-answer">