diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index 6e5fae82f8..f83701d7ab 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -3,11 +3,11 @@
DroidDeck
- First run downloads Steam. This may take a few minutes.
- - Steam keeps running in the background.
+ - By default, leaving the app pauses Steam; it picks up where it left off when you come back.
- Your controller appears as an Xbox 360 pad. Otherwise, use the on-screen controls.
Session
- Keeps Steam running in the background
+ Shows while a Steam or desktop session is open
Steam is running
Session paused - tap Resume when ready
Resume
diff --git a/tools/linuxfs/overlay/usr/local/bin/bannerlator-session b/tools/linuxfs/overlay/usr/local/bin/bannerlator-session
index 94a2396c61..d4e6094532 100755
--- a/tools/linuxfs/overlay/usr/local/bin/bannerlator-session
+++ b/tools/linuxfs/overlay/usr/local/bin/bannerlator-session
@@ -252,6 +252,49 @@ case $mode in
if [ ! -f "$steam_root/steamapps/appmanifest_4427310.acf" ]; then
step "asking the client to fetch the ARM64 Proton"
set -- "$@" steam://install/4427310
+ # Ported from Bannerlator (bannerlator-session, device-proven 2026-09-22). The client decides
+ # a title's compatibility tool when the title is installed and keeps that decision for the
+ # rest of its run, and the tool is set up before the client comes up. So once the depot has
+ # fully landed, restart the client once - its own -shutdown, then the loop below, which knows
+ # the marker - and every title installed from then on runs through the tool, with the
+ # refreshed tool list and defaults, and no second launch by the user. A first run only: with
+ # the depot present at session start nothing here is armed.
+ (
+ _bl_acf="$steam_root/steamapps/appmanifest_4427310.acf"
+ for _ in $(seq 1 360); do
+ sleep 10
+ # StateFlags 4 = fully installed; a moment more for the client to finish its bookkeeping.
+ if grep -q '"StateFlags"[[:space:]]*"4"' "$_bl_acf" 2>/dev/null; then
+ sleep 10
+ bannerlator-steam-compat "$steam_root" >/dev/null 2>&1 || true
+ step "compatibility layer installed: restarting the Steam client once"
+ : > "$HOME/.bl-restart-once"
+ "$steam_root/steamrtarm64/steam" -shutdown >/dev/null 2>&1 || true
+ exit 0
+ fi
+ done
+ ) &
+ # A client that starts signed out drops that request - on a fresh install nobody has signed
+ # in yet - so the install dialog only appeared after the user restarted the client by hand.
+ # With no remembered sign-in, ask again once the sign-in has happened: the client binary
+ # started a second time with a URL hands it to the running instance and exits.
+ if ! grep -q '"RememberPassword"[[:space:]]*"1"' "$steam_root/config/loginusers.vdf" 2>/dev/null; then
+ (
+ _bl_conn="$steam_root/logs/connection_log.txt"
+ _bl_from=$(stat -c %s "$_bl_conn" 2>/dev/null || echo 0)
+ for _ in $(seq 1 180); do
+ sleep 10
+ [ -f "$steam_root/steamapps/appmanifest_4427310.acf" ] && exit 0
+ if tail -c +$((_bl_from + 1)) "$_bl_conn" 2>/dev/null | grep -q "RecvMsgClientLogOnResponse() : processing complete"; then
+ sleep 15
+ [ -f "$steam_root/steamapps/appmanifest_4427310.acf" ] && exit 0
+ step "signed in: asking the client again for the ARM64 Proton"
+ "$steam_root/steamrtarm64/steam" steam://install/4427310 >/dev/null 2>&1 || true
+ exit 0
+ fi
+ done
+ ) &
+ fi
fi
# The tool is registered before the client starts and finds the depot at launch time, so
# nothing here waits for a download. What can still change under a running client is which
@@ -384,17 +427,21 @@ BUSCONF
# channel Armada bootstraps its ARM64 client from. Whatever wrote package/beta, the branch on
# disk has to agree with the one forced here - a disagreement is the restart loop above, and
# it is silent apart from rc=42 in this log.
+ # Checked before every start, not once: the client rewrites package/beta during its own run,
+ # and a restart below (rc=42, or the one after the ARM64 Proton lands) would otherwise start it
+ # again on the branch it just wrote.
steam_channel=${BL_STEAM_CHANNEL:-publicbeta}
steam_beta=$steam_root/package/beta
- if [ -f "$steam_beta" ] && [ "$(cat "$steam_beta" 2>/dev/null)" != "$steam_channel" ]; then
- echo "== steam: client branch on disk was '$(cat "$steam_beta" 2>/dev/null)', set to '$steam_channel' to match -clientbeta"
- echo "$steam_channel" > "$steam_beta"
- fi
echo "== steam args: ${_bl_ui[*]} -clientbeta $steam_channel -no-cef-sandbox -cef-force-gpu -cef-ozone-platform=x11 -cef-use-gl=angle -cef-use-angle=vulkan $*"
# An update that cannot install asks for a restart (rc=42) every time; the count is capped so a
# session can never again loop in silence, which reads as a menu opening and closing by itself.
steam_updates=0
while :; do
+ rm -f "$HOME/.bl-restart-once"
+ if [ -f "$steam_beta" ] && [ "$(cat "$steam_beta" 2>/dev/null)" != "$steam_channel" ]; then
+ echo "== steam: client branch on disk was '$(cat "$steam_beta" 2>/dev/null)', set to '$steam_channel' to match -clientbeta"
+ echo "$steam_channel" > "$steam_beta"
+ fi
step "starting the Steam client${BL_STEAM_UI:+ ($BL_STEAM_UI UI)}"
"$steam_root/steamrtarm64/steam" "${_bl_ui[@]}" -clientbeta "$steam_channel" \
-no-cef-sandbox -cef-force-gpu -cef-ozone-platform=x11 \
@@ -402,6 +449,13 @@ BUSCONF
rc=$?
echo "== steam exited rc=$rc"
collect_steam_logs
+ # The session asked for this exit (the ARM64 Proton landed): start again, without the URL
+ # arguments, which were acted on. Not counted against the update cap.
+ if [ -f "$HOME/.bl-restart-once" ]; then
+ echo "== steam: restarting once so the new compatibility layer is in the client's lists"
+ set --
+ continue
+ fi
[ "$rc" -eq 42 ] || break
steam_updates=$((steam_updates + 1))
if [ "$steam_updates" -ge 3 ]; then