fix(steam): launch Big Picture via -bigpicture instead of -tenfoot -steamdeck (#28) - #58
Merged
Merged
Conversation
…teamdeck Replace the -tenfoot -steamdeck flag combo, which triggers the Steam Deck first-run OOBE (whose update step fails on non-SteamOS distros like CachyOS, issue #28), with -bigpicture. Same Big Picture UI, no Deck bootstrap. - Centralize the steam default command in PresetManager::defaultSteamCommand() - Version the Flatpak launch cache (FLATPAK_CACHE_VERSION=2): stale caches carrying the old command are ignored and rewritten, so existing installs pick up the new flags instead of being pinned to -tenfoot -steamdeck forever - Regression test: stale v1 cache does not override the builtin command
hikaps
force-pushed
the
feature/steam-bigpicture
branch
from
August 20, 2026 21:28
d902584 to
fcba6d5
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
On non-SteamOS distros (CachyOS, #28), the builtin Steam preset launch
steam -tenfoot -steamdeckforces Steam's Deck first-run setup (language → network → update). That update step fails with "unable to download the required update" and blocks Big Picture entirely.Verified with the reporter: plain
steam -steamdeckopens fine, but the session launch (steam -tenfoot -steamdeckinside gamescope) hits the update error. Launching a Steam game via its desktop file (steam steam://rungameid/N— no Deck flags) opens Big Picture and plays games with no error.Change
Replace the launch flags with Steam's documented Big Picture flag:
Applied at all 4 hardcoded sites (
PresetManagerbuiltin preset + flatpakArgs,GamescopeInstancefallback,SessionRunnerfallback) plusCouchPlayHelper.hdoc comment and the tests covering them.Why this is safe
-bigpictureopens the same Big Picture UI without the Deck first-run OOBE.-steamdeckwas "proper Proton prefix handling" (Deck-mode); the reporter's no--steamdeckgame launch played games fine, so the practical delta is low.steamAppIdlaunch mode was already removed —steamAppIdis only used for override paths now, so nothing else depends on Deck-mode flags.Verification
cmake --buildclean (dev-box, Qt 6.10.2)test_monitormanagerfails, and it's environmental (headless container:qt.qpa.wayland: There are no outputs→ placeholder screen 0×0). All touched test files (test_gamescopeinstance,test_presetmanager,test_couchplayhelper) pass.