# 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. The inventories use `.gzip` rather than `.gz`: Android's asset packer expands `.gz` and strips its suffix. The shared local/CI runtime payload check verifies the exact APK names and bytes. Desktop removal uses `app/src/main/assets/desktop-removal/`, generated by `removal-manifests.py` from the checksum-pinned LXQt r1, KDE r1/r2 and emulator r1 archives. KDE candidates are the files of the desktop applications/themes in `seeds.txt` (their source package hashes verified against `desktop-kde.packages.txt`) plus our overlay. Shared dependencies, fonts, Xwayland and Qt Wayland remain available to Steam, native apps and emulators. Regenerate the inventories and add the new version to `versions.txt` when publishing another desktop pin; unknown versions cannot be removed. Removal checks file size and SHA-256, or the exact symlink target, before unlinking. Base-runtime pacman files and emulator bundle paths are protected even when they overlap an application. It never follows parent symlinks or recursively deletes directories. Home, added apps, custom files and modified package files stay. A pending marker disables the installed state and allows retry after interruption. Installing the desktop again repairs its package files and clears it. The old LXQt applications are cleaned after KDE installation and before the next guest launch on an already-upgraded runtime, protecting both KDE inventories as well as the runtime and emulators. Only files owned by `lxqt-applications.txt`'s application packages are candidates; dependencies stay even when the old runtime's pacman database does not record them. In particular, gamescope still needs the old package's libseat. The source LXQt application archives are the versions in the published `steamdeck-desktop-r1/desktop.packages.txt`; verify their `.sig` files with `gpgv --keyring tools/desktop-kde/archlinuxarm-builder.gpg` and the Build System fingerprint used by `build.sh`. Put their filenames in `selected.txt` in the LXQt cache. `sources.json` records their SHA-256 values; file identities still come from the checksum-pinned published desktop.