Skip to content

feat: the Steam Frame's desktop on the PICO 4: Plasma in VR with clicks, one-controller laser, desktop mode session - #27

Merged
Xenolphthalein merged 5 commits into
mainfrom
feat/desktop-app
Nov 19, 2026
Merged

Xenolphthalein merged 5 commits into
mainfrom
feat/desktop-app

Conversation

@Xenolphthalein

Copy link
Copy Markdown
Contributor

For overpressure/phoenix#60.

The PICO 4 gets the Steam Frame's desktop: + → Launch Program → Desktop opens KDE Plasma in a window inside VR, the way the Frame does it.

  • The desktop. Valve's steamdeck-kde-presets from the Frame's repository has steamos-nested-desktop (Plasma nested in gamescope), the Desktop entry Steam lists, Return to Gaming Mode and Valve's Plasma defaults. Plasma, kwin, Dolphin and Konsole are Holo's 6.5.3: the Frame's own Plasma 6.2.5 needs its private base's Qt 6.8. About 1.3 GiB more, the system image is 6,007 MiB of the 8 GiB super. The lock follows (179 packages more).
  • Clicks. For a window that isn't Steam's, gamescope sends the laser's click as a touch and sets _STEAMOS_TOUCH_POINTER_EMULATION on Xwayland's root, and Valve's Xwayland turns that into a click. Holo's Xwayland doesn't, and the Frame's needs its private libei, so kwin got bare touches and Plasma saw no clicks at all. overpressure-gamescope now gives those windows the left button, as game windows already get; hover is unchanged.
  • One controller. The dashboard laser now has the whole mouse on each hand, as Valve binds the Touch: trigger left click, joystick click right click (as on the Frame), grip middle click, B/Y back, A/X home, joystick scroll. Before, there was no right click and the grip was back. A's home does nothing, on the Frame too: SteamVR sends it as button 1 and the Frame's Steam client only acts on button 2 (back).
  • Desktop mode. pico4-session now picks its session from sddm's autologin like sddm does on the Frame (session-target, session-switch), so steamos-manager's Switch to Desktop and Default to Desktop Mode would start plasma-session.target. Steam's VR power menu doesn't offer it, so that part isn't tried on the headset.
  • pico4-userspace-check requires the Desktop entry and Plasma's programs, and checks the session target that runs.

Checked worn on my headset with this branch's image: Plasma opens, hover, left, right and middle click and scrolling work with one controller, Dolphin opens folders and its window drags. The userspace check passed on the first install of it; the Valve session check passed its performance part (90 commits/s, 62 °C) and missed only the controllers, which were off on the table. The session tests, layout tests, ruff, ty and shellcheck pass.

Tap Desktop once: a second launch while one runs removes the first one's runtime directory (Valve's script) and Plasma stays black.

phoenix's build script change for plasma.desktop has to land with the pin to the release of this.

…amdeck-kde-presets with Holo's Plasma

steamdeck-kde-presets puts Desktop into Steam's + > Launch Program and runs KDE Plasma nested in gamescope (steamos-nested-desktop), with Return to Gaming Mode and Valve's Plasma defaults. Plasma, kwin, Dolphin and Konsole are Holo's 6.5.3 on Qt 6.10: the Frame's 6.2.5 needs its private base's Qt 6.8. pico4-userspace-check requires the Desktop entry and the programs it starts.
… Switch to Desktop starts Plasma's session

session-target takes PICO4_SESSION_TARGET, else sddm's [Autologin] Session= as sddm reads its files, and that session's start-gamescope-session target: steamos-manager's one-shot plasma.desktop gives plasma-session.target. session-switch, as root around each session, removes a one-shot login left from before the boot (sddm's reset-oneshot-boot.conf), records the running target, and resets the start limit when a session ended for a switch. steamvr-ended and pico4-steamvr-failed stop the running target; pico4-userspace-check checks it.
…ser's click as the left button

For such a window (Steam's + > Launch Program, the Desktop) gamescope sends the click as a touch and sets _STEAMOS_TOUCH_POINTER_EMULATION on Xwayland's root, which Valve's Xwayland turns into the pointer's click. Holo's Xwayland 24.1.9 does not, and the Frame's needs its private base's libei, so kwin's nested X11 backend got bare touches and Plasma saw no clicks. They now get the left button, as game windows do; hover is unchanged.
…, as Valve binds the Touch

The joystick click right-clicks (as on the Frame), the grip middle-clicks, A or X is the laser's home and B or Y back, the trigger clicks and the joystick scrolls: one controller is enough for the desktop. Before, there was no right click, the joystick click middle-clicked and the grip went back.
…: a checkout's recipe scripts are not executable
@Xenolphthalein
Xenolphthalein merged commit 6847593 into main Nov 19, 2026
22 checks passed
@Xenolphthalein
Xenolphthalein deleted the feat/desktop-app branch November 19, 2026 12:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant