0 Fork 0

mirror of https://github.com/Droid-Deck/DroidDeck.git synced 2026-11-11 19:11:08 +00:00

Files

T

MaxsTechReview ab949a4a5a fix(runtime): the x86-64 Steam client starts again on the Ubuntu runtime (liblzo2-2 for FEX) (#1825 )

* fix(runtime): ship liblzo2-2 so the x86-64 Steam client can install FEX

FEX's unsquashfs links liblzo2. The Ubuntu runtime did not ship it, so the FEX check failed on every build, the x86-64 client was never set up, and the session went straight back to the home screen. Only phones with the desktop installed had it.

* fix: the x86-64 Steam client starts again after it updates itself under FEX

On its first start the x86-64 client downloads a 500 MB update and, under FEX, ends on an illegal instruction (rc=132) instead of asking for a restart with rc=42, so the session ended there. The client is started again once.

2026-10-30 13:58:35 -04:00

apt

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

overlay-desktop

feat: show the DroidDeck D mark as the fastfetch logo (#1778 )

2026-10-29 20:21:49 -04:00

overlay-runtime

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

patches

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

proc

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

base.env

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

build-debs.sh

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

build.sh

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

desktop-pack.py

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

mozilla.asc

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

packages-desktop.txt

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

packages-runtime.txt

fix(runtime): the x86-64 Steam client starts again on the Ubuntu runtime (liblzo2-2 for FEX) (#1825 )

2026-10-30 13:58:35 -04:00

protected-desktop.txt

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

protected-runtime.txt

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

README.md

Move the Linux runtime to Ubuntu 26.04 LTS with a separate Kubuntu desktop (#1733 )

2026-10-29 09:05:20 -04:00

setup.sh

fix: ship libxcb-keysyms1 in the Ubuntu runtime so DD-Turnip loads (#1773 )

2026-10-29 12:22:25 -04:00

README.md

The Linux runtime (Ubuntu)

DroidDeck's Linux runtime: Ubuntu 26.04 LTS for arm64, with Kubuntu's Plasma desktop as a separate download, set up as SteamOS's desktop mode (Valve's Vapor theme, the Steam Deck wallpaper, "Return to Gaming Mode" and Steam on the desktop). The app installs it into files/linuxfs and runs it under its patched proot.

build-debs.sh (run in an ubuntu:26.04 container on an arm64 runner) rebuilds two Ubuntu source packages: Mesa with -Dfreedreno-kmds=msm,kgsl, so Turnip and freedreno reach Android's /dev/kgsl-3d0, and KWin with patches/kwin (nested desktop scale, an explicit render node, scroll source/discrete forwarding). Both get a +droiddeck version. patches/mesa adds KGSL UBWC 5/6 (backported from upstream Mesa) and the KGSL device numbers for WSI (from Droid-Deck/Drivers).
The runtime's built-in Vulkan driver is DroidDeck's DD-Turnip Linux build (DD_TURNIP_URL and DD_TURNIP_SHA256 in base.env): Ubuntu's Turnip is diverted to libvulkan_freedreno.so.distrib because it lacks the Adreno 8xx fixes. Zink, EGL and llvmpipe stay Ubuntu's.
build.sh verifies Ubuntu's base image (base.env: signed SHA256SUMS from cdimage plus the pinned hash), chroots into it and runs setup.sh twice. The runtime stage is everything gaming mode needs; it is packed as <tag>.tar.zst. The desktop stage then adds Plasma on top, and desktop-pack.py packs only what that stage added or changed as <tag>-desktop.tar.zst, so the desktop shares every runtime file instead of shipping its own copy. The runtime carries usr/share/droiddeck/desktop-pack.json (tag, URL, hash, size) naming its matching desktop pack.
setup.sh runtime installs packages-runtime.txt without recommends and the +droiddeck debs from a local repository in /var/lib/droiddeck/apt (pinned at 1001 and held), then builds the droiddeck-runtime package from overlay-runtime/. setup.sh desktop installs packages-desktop.txt, Firefox from Mozilla's apt repository (mozilla.asc, fingerprint 35BAA0B33E9EB396F59CA838C0BA5CE6DC6315A3) and builds droiddeck-desktop from overlay-desktop/. Both packages are Protected, depend on protected-*.txt, own our files and divert any Ubuntu file they replace, so apt neither removes the essentials nor overwrites our settings on upgrade.
The desktop pack's usr/share/droiddeck/desktop/files.tsv.gz lists each path the desktop added (N), changed (C) or removed (R), and originals/ keeps the runtime's copies of changed and removed files. Removing the desktop restores those and deletes the added files the user has not changed; a runtime update replaces the tree, and the desktop is downloaded again when it is next opened.

At run time:

sudo, su, pkexec and apt/aptitude (for commands that change the system) go through droiddeck-root: the app runs them in a separate proot with -0 --link2symlink, passing the caller's terminal, so dpkg gets root ownership emulation and hard links while the desktop keeps the fast path. PackageKit (Discover) and polkit are started the same way by the session's system bus (/usr/share/droiddeck/system-services).
apt/remember (a DPkg::Post-Invoke hook) keeps the packages, sources and keys the user added in ~/.local/share/droiddeck/apt; apt/restore (autostarted) puts them back after a runtime update.
The installer turns the image's hard links into proot's link2symlink layout, and proot shows the linked name as /proc/self/exe (patch 0020), so Ubuntu's multi-call coreutils work.

.github/workflows/build-ubuntu-runtime.yml builds it and, run with a new tag (ubuntu-rN), publishes the runtime and its desktop pack in Droid-Deck/DroidDeck-Components; linuxfs-ubuntu.json there names the release the app installs.