Files
DroidDeck/tools/desktop-kde/README.md
T

2.5 KiB

The desktop package (KDE Plasma)

The desktop the app installs into its Linux runtime the first time the desktop is opened: KDE Plasma set up as SteamOS's desktop mode, with Valve's Vapor theme, the Steam Deck wallpaper and launcher icon, Plasma's default bottom panel, and "Return to Gaming Mode" and Steam on the desktop.

  • seeds.txt: the packages asked for. build.sh takes their closure over Arch Linux ARM's repositories (closure.py) and drops what the runtime already has.
  • runtime-packages.txt: the runtime's own packages, name version from its pacman database (ls /var/lib/pacman/local in the rootfs). Refresh it when the runtime is rebuilt.
  • overlay/: our files on top - system-wide KDE defaults in /etc/xdg, the Vapor theme and its layout script, the menu entries Steam and Return to Gaming Mode use.

.github/workflows/build-desktop-kde.yml builds it and, run with a new tag, publishes it as a release in Droid-Deck/DroidDeck-Components. release.env pins the tag, sha256 and size the apk installs (DesktopCatalog.desktopEntry); a published tag is never replaced, so a changed package is a new tag and a release.env update.

At run time the desktop is started by tools/linuxfs/desktop/droiddeck-desktop (the app stages it at every session): Plasma's own startplasma-wayland, with KWin nested in the app's compositor through kwin_wayland_wrapper. KWin composites in software (QPainter) - the Adreno node is not a DRM device - so games and emulators from the menu go through droiddeck-gpu, and Steam goes back to the app as a Steam session.

build-kwin.sh builds KWin 6.7.5's Wayland executable and library on a native ARM64 runner, using a disposable Arch Linux ARM chroot with every build package signature-checked. The KDE source tarball is pinned by SHA-256 (the same digest in Arch's KWin PKGBUILD); patches/0001-respect-nested-desktop-scale.patch lets Display Settings control the inner desktop scale independently of the outer window size. It keeps layer sizes, pointer/touch coordinates and the cursor in the same physical pixels. The behavior is enabled only with DROIDDECK_NESTED_SCALE, which the desktop script supplies.

The desktop workflow replaces the same-version kwin_wayland executable and libkwin.so; the rest comes from the signature-checked Arch packages. desktop-kde.kwin.txt records the source, patch, executable, library and build package hashes. Corresponding source is https://download.kde.org/stable/plasma/6.7.5/kwin-6.7.5.tar.xz plus the patch in this repository.