A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.
docs(site): cover the permissions step and render scale, move to v1.2.9
ExTvce0121896b28
diff --git a/CLAUDE.md b/CLAUDE.mdindex 136cbd5..d26359a 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -39,10 +39,9 @@ All native/VM components are coordinated by `build-all.sh` (Docker-cached):./build-all.sh initramfs # kernel + minimal initramfs./build-all.sh rootfs # Alpine squashfs -> app/src/main/assets/alpine-rootfs.squashfs./build-all.sh qemu # QEMU + native helpers via Docker (slow first time)-./build-all.sh termux # terminal-emulator JNI for 16KB pages./build-all.sh apk # Android APK via Gradle./build-all.sh all # everything-./build-all.sh deploy # all + install + launch+./build-all.sh deploy # APK + install in place (adb install -r)./build-all.sh test # boot validation: installs, polls console.log for "Ready!"```diff --git a/docs/guide/backends.html b/docs/guide/backends.htmlindex 0937b2c..684bd6b 100644--- a/docs/guide/backends.html+++ b/docs/guide/backends.html@@ -172,7 +172,7 @@<a class="prev" href="performance.html"><span class="dir">Previous</span>← Performance</a><a class="next" href="networking.html"><span class="dir">Next</span>Networking & ports →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/desktop.html b/docs/guide/desktop.htmlindex 2f08553..387b957 100644--- a/docs/guide/desktop.html+++ b/docs/guide/desktop.html@@ -227,6 +227,10 @@ password=na</code></pre><td>Server DPI</td><td>96 to 192. Tells Xvnc what DPI to report to apps. Takes effect on the next VM start.</td></tr>+ <tr>+ <td>Render scale</td>+ <td>100%, 75% or 50%. Lower is faster: the desktop is drawn at a reduced size and scaled up to fit the screen.</td>+ </tr><tr><td>Audio</td><td>PulseAudio streams PCM from the VM to the app over port 4713. Toggle to enable or disable.</td>@@ -241,14 +245,14 @@ password=na</code></pre><div class="callout note"><span class="label">Performance</span>- <p>The viewer currently uses uncompressed Raw encoding (ZRLE was disabled after it desynced on complex content). On a high-DPI phone, selecting the 720p or 900p preset reduces the amount of screen data transferred each frame and noticeably improves smoothness on heavy desktops. See the <a href="performance.html">Performance</a> page for general tuning advice.</p>+ <p>The viewer draws on its own thread and lets the GPU do the scaling, so the desktop stays responsive while frames arrive. It uses uncompressed Raw encoding. On a high-DPI phone, selecting the 720p or 900p preset, or a lower render scale, reduces the amount of screen data handled each frame and noticeably improves smoothness on heavy desktops. See the <a href="performance.html">Performance</a> page for general tuning advice.</p></div><div class="pagenav"><a class="prev" href="packages.html"><span class="dir">Previous</span>← Packages & services</a><a class="next" href="settings.html"><span class="dir">Next</span>Terminal & settings →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/getting-started.html b/docs/guide/getting-started.htmlindex 94ffac7..3e8e9be 100644--- a/docs/guide/getting-started.html+++ b/docs/guide/getting-started.html@@ -65,7 +65,7 @@</div><h2>Setup wizard</h2>- <p>The first time you open Podroid a three-step wizard runs before anything else.</p>+ <p>The first time you open Podroid a four-step wizard runs before anything else.</p><h3>Step 1: Persistent storage size</h3><p>Choose how large the writable VM disk image will be: from 2 GB up to 512 GB, limited to the free space on your phone. This image lives in the app's private storage and holds everything you install inside the VM - packages, container images, config files. Pick more than you think you need.</p>@@ -86,6 +86,9 @@<p>On the QEMU backend, Downloads sharing can be unstable on some devices. If the VM behaves oddly after enabling it, try disabling it in Settings. The AVF path is stable.</p></div>+ <h3>Step 4: Permissions</h3>+ <p>The last card lists the permissions Podroid asks for, with the reason for each and a Grant button. Notifications, because the VM runs in a foreground service whose notification is how you see its state and stop it. Unrestricted background use, because Android otherwise stops the VM once the app is in the background. Both can be skipped. If one is missing later, including after an update that starts needing a new one, the same rows appear at the top of the home screen.</p>+<h2>First boot</h2><p>Tap <strong>Start VM</strong> on the home screen. The first boot takes roughly 50-60 seconds, noticeably longer than the 10-15 seconds of later boots. Two one-time tasks run:</p><ul>@@ -127,7 +130,7 @@<a class="prev" href="index.html"><span class="dir">Previous</span>← Overview</a><a class="next" href="how-it-works.html"><span class="dir">Next</span>How it works →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/how-it-works.html b/docs/guide/how-it-works.htmlindex db11f12..dc9ee5a 100644--- a/docs/guide/how-it-works.html+++ b/docs/guide/how-it-works.html@@ -143,7 +143,7 @@<a class="prev" href="getting-started.html"><span class="dir">Previous</span>← Getting started</a><a class="next" href="performance.html"><span class="dir">Next</span>Performance & why it's slow →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/index.html b/docs/guide/index.htmlindex f0efd6c..97c8bf8 100644--- a/docs/guide/index.html+++ b/docs/guide/index.html@@ -81,7 +81,7 @@<span></span><a class="next" href="getting-started.html"><span class="dir">Next</span>Getting started →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/limitations.html b/docs/guide/limitations.htmlindex 6579e36..b34aaa3 100644--- a/docs/guide/limitations.html+++ b/docs/guide/limitations.html@@ -196,7 +196,7 @@<a class="prev" href="settings.html"><span class="dir">Previous</span>← Terminal & settings</a><a class="next" href="use-cases.html"><span class="dir">Next</span>Use cases →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/migrations.html b/docs/guide/migrations.htmlindex 03915d6..0803649 100644--- a/docs/guide/migrations.html+++ b/docs/guide/migrations.html@@ -142,7 +142,7 @@ rc-update -u add my-service default</code></pre><a class="prev" href="packages.html"><span class="dir">Previous</span>← Packages & services</a><a class="next" href="desktop.html"><span class="dir">Next</span>Desktops & X11 viewer →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/networking.html b/docs/guide/networking.htmlindex 99014f6..b140826 100644--- a/docs/guide/networking.html+++ b/docs/guide/networking.html@@ -289,7 +289,7 @@ pasv_addr_resolve=NO<a class="prev" href="backends.html"><span class="dir">Previous</span>← Backends: QEMU & AVF</a><a class="next" href="packages.html"><span class="dir">Next</span>Packages & services →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/packages.html b/docs/guide/packages.htmlindex 43f321e..bd24238 100644--- a/docs/guide/packages.html+++ b/docs/guide/packages.html@@ -199,7 +199,7 @@<a class="prev" href="networking.html"><span class="dir">Previous</span>← Networking & ports</a><a class="next" href="migrations.html"><span class="dir">Next</span>Updates & migrations →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/performance.html b/docs/guide/performance.htmlindex bbcbcd8..c9b17f5 100644--- a/docs/guide/performance.html+++ b/docs/guide/performance.html@@ -147,7 +147,7 @@<a class="prev" href="how-it-works.html"><span class="dir">Previous</span>← How it works</a><a class="next" href="backends.html"><span class="dir">Next</span>Backends: QEMU & AVF →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/settings.html b/docs/guide/settings.htmlindex 723148d..486fae1 100644--- a/docs/guide/settings.html+++ b/docs/guide/settings.html@@ -224,7 +224,7 @@<a class="prev" href="desktop.html"><span class="dir">Previous</span>← Desktops & X11 viewer</a><a class="next" href="limitations.html"><span class="dir">Next</span>Limitations & troubleshooting →</a></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>diff --git a/docs/guide/use-cases.html b/docs/guide/use-cases.htmlindex 0b81df0..87832d8 100644--- a/docs/guide/use-cases.html+++ b/docs/guide/use-cases.html@@ -186,7 +186,7 @@<a class="prev" href="limitations.html"><span class="dir">Previous</span>← Limitations & troubleshooting</a><span></span></div>- <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.8. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p>+ <p class="docfoot">Podroid is free software (GPL). Docs for v1.2.9. Found something inaccurate? <a href="https://github.com/ExTV/Podroid/issues">Open an issue</a>.</p></main></div>