Release v1.2.13.1 background Steam setup

Signed-off-by: moontheripper <moontheripper@users.noreply.github.com>

Author: MoonTheRipper

README.md

@@ -148,6 +148,14 @@ Install Windows Steam during bootstrap:
 ./install.zsh --install-steam
 ```
 
+That foreground command validates Steam and closes it after install. Open the Steam profile later when you are ready to sign in.
+
+For app-style first-run setup, start Steam in the background so users can configure game folders and cover art while Steam finishes:
+
+```zsh
+./install.zsh --install-steam-background
+```
+
 See [docs/commands.md](docs/commands.md) for the full command reference.
 
 Run the SwiftUI launcher:

Sources/RipperMoonKitLauncher/RipperMoonKitLauncherApp.swift

@@ -1958,7 +1958,7 @@ private struct GameDetailScreen: View {
                               title: model.steamReady ? "Repair Steam" : "Install Steam") {
                         model.installSteam()
                     }
-                    .help("Downloads SteamSetup.exe if needed, runs it in the Steam prefix, then validates that steam.exe exists.")
+                    .help("Downloads SteamSetup.exe if needed, starts Steam installation in the background, then validates that steam.exe exists.")
                 }
                 RMKButton(kind: .primary, icon: "gamecontroller.fill",
                           title: profile.isSteamApp ? "Launch Steam" : (profile.useModEngine == true ? "Launch Modded" : "Launch"),
@@ -2064,7 +2064,7 @@ private struct GameDetailScreen: View {
                     if profile.isSteamApp {
                         CommandPreview(title: model.steamReady ? "Repair Steam" : "Install Steam",
                                        command: model.previewInstallSteamCommand())
-                        .help("Runs the Steam installer in the Steam prefix and validates steam.exe after the installer exits.")
+                        .help("Starts Steam installation in the background and validates steam.exe when it appears.")
                     }
                     CommandPreview(title: profile.isSteamApp ? "Launch Steam" : "Launch From Steam",
                                    command: model.previewSteamManagedLaunchCommand(for: profile))
@@ -2793,7 +2793,11 @@ private struct SetupGuideView: View {
                 Text("You're all set")
                     .font(.system(size: 22, weight: .bold))
                     .foregroundStyle(Onyx.text)
-                Text("Every required piece is installed. The Mac is ready to reap — go play something.")
+                Text(model.steamReady
+                     ? "Steam is installed and RipperMoonKit is ready. Sign into Steam when a game needs it, then add copied Windows game folders and cover art."
+                     : model.steamInstallPending
+                     ? "RipperMoonKit is ready. Steam is installing in the background, so you can set game folders and cover art while it finishes."
+                     : "Core setup is ready. Install Steam from the Steam profile before Steam-dependent games, then add copied Windows game folders and cover art.")
                     .font(.system(size: 12.5))
                     .foregroundStyle(Onyx.textDim)
                     .multilineTextAlignment(.center)
@@ -2805,12 +2809,26 @@ private struct SetupGuideView: View {
             }
 
             VStack(alignment: .leading, spacing: 10) {
-                Text("OPTIONAL — YOU MIGHT ALSO WANT TO:")
+                Text("NEXT STEPS")
                     .font(.system(size: 10, weight: .bold))
                     .foregroundStyle(Onyx.textMute)
                     .frame(maxWidth: .infinity, alignment: .leading)
 
-                if !model.steamReady {
+                if model.steamReady {
+                    optionalCard(
+                        icon: "person.crop.circle.badge.checkmark",
+                        title: "Sign into Steam",
+                        detail: "Open the Steam profile when you need Steam, sign in, and keep it running for Steam-dependent games.",
+                        action: "Steam Profile"
+                    ) { model.goToSteamSetup() }
+                } else if model.steamInstallPending {
+                    optionalCard(
+                        icon: "clock.arrow.circlepath",
+                        title: "Steam is installing",
+                        detail: "Leave the background install alone. In the meantime, set paths, add game profiles, and add cover art.",
+                        action: "Steam Profile"
+                    ) { model.goToSteamSetup() }
+                } else {
                     optionalCard(
                         icon: "arrow.down.app.fill",
                         title: "Finish Steam setup",
@@ -2821,7 +2839,7 @@ private struct SetupGuideView: View {
                 optionalCard(
                     icon: "folder.fill",
                     title: "Set your games folder",
-                    detail: "Tell RipperMoonKit where your game files live so it can find and launch them.",
+                    detail: "Use a copied, already-installed Windows game folder. Do not point the app at installer files.",
                     action: "Settings"
                 ) { model.openSetupRelatedSettings() }
                 optionalCard(
@@ -3368,10 +3386,18 @@ private final class LauncherModel: ObservableObject {
         FileManager.default.fileExists(atPath: steamInstallerPath)
     }
 
+    var steamInstallPendingPath: String {
+        "\(config.gptkHome)/state/steam-install.pending"
+    }
+
     var steamReady: Bool {
         steamExecutableExists(in: steamProfile)
     }
 
+    var steamInstallPending: Bool {
+        !steamReady && FileManager.default.fileExists(atPath: steamInstallPendingPath)
+    }
+
     var setupChecks: [SetupCheck] {
         [
             SetupCheck(
@@ -3438,6 +3464,7 @@ private final class LauncherModel: ObservableObject {
         if !config.hasToolkitScripts || !config.exists { return "Install Toolkit" }
         if !config.hasLocalGPTK { return "Begin GPTK Install" }
         if !steamInstallerReady { return "Download Steam" }
+        if steamInstallPending { return "Steam Installing" }
         if !steamReady { return "Install Steam" }
         return "Refresh Setup"
     }
@@ -3854,6 +3881,9 @@ private final class LauncherModel: ObservableObject {
             config.hasGPTKInstallMedia ? beginGPTKInstall() : showGPTKDownloadStep(openBrowser: true)
         } else if !steamInstallerReady {
             downloadSteamInstaller()
+        } else if steamInstallPending {
+            reload()
+            commandOutput = "Steam is still installing in the background. You can set game folders and cover art while it finishes.\n"
         } else if !steamReady {
             installSteam()
         } else {
@@ -3914,9 +3944,12 @@ private final class LauncherModel: ObservableObject {
         }
 
         echo
-        echo "➡️  Step 3 of 3 — installing Windows Steam…"
+        echo "➡️  Step 3 of 3 — starting Windows Steam install in the background…"
         if [[ "$setup_status" -eq 0 ]]; then
-          ./install.zsh --install-steam || echo "⚠️  Steam step incomplete — install it later from the Steam profile."
+          echo "    Steam can take several minutes, but you do not need to wait here."
+          echo "    RipperMoonKit will move on while Steam installs in the background."
+          echo "    In the meantime, set your game folders and cover art API from the app."
+          ./install.zsh --install-steam-background || echo "⚠️  Steam background install did not start — use the Steam profile's Install Steam action later."
         else
           echo "⏭️  Skipping Steam until the required toolkit pieces are installed."
         fi
@@ -3945,7 +3978,7 @@ private final class LauncherModel: ObservableObject {
     func installSteam() {
         runShell(
             title: steamReady ? "Repair Steam Install" : "Install Steam",
-            command: "\(toolkitSourceBootstrapCommand)\n./install.zsh --no-homebrew-bootstrap --skip-gptk --install-steam",
+            command: "\(toolkitSourceBootstrapCommand)\n./install.zsh --no-homebrew-bootstrap --skip-gptk --install-steam-background",
             completion: { [weak self] in self?.reload() }
         )
     }
@@ -4325,7 +4358,7 @@ private final class LauncherModel: ObservableObject {
     }
 
     func previewInstallSteamCommand() -> String {
-        "\(toolkitSourceBootstrapCommand)\n./install.zsh --no-homebrew-bootstrap --skip-gptk --install-steam"
+        "\(toolkitSourceBootstrapCommand)\n./install.zsh --no-homebrew-bootstrap --skip-gptk --install-steam-background"
     }
 
     func previewStopSteamCommand() -> String {

VERSION

@@ -1 +1 @@
-1.2.13
+1.2.13.1

bin/gptk-steam

@@ -17,6 +17,8 @@ Host folders are exposed inside Wine through GPTK_DRIVE_MAPS.
 
 Options:
   --install [SteamSetup.exe]       Install or repair Windows Steam
+  --install-only                   Install or repair Steam, validate steam.exe, then exit without launching Steam
+  --wait-for-steam-exe SECONDS     After installer exit, wait for steam.exe to appear
   --kill                           Stop the Steam Wine prefix
   --repair-compat                  Reapply Steam CEF compatibility registry entries
   --install-spacewar               Launch AppID 480 once so Steam installs Spacewar
@@ -36,6 +38,8 @@ USAGE
 prefix="${GPTK_STEAM_PREFIX:-Steam}"
 installer=""
 install=0
+install_only=0
+install_wait_seconds="${GPTK_STEAM_INSTALL_WAIT_SECONDS:-0}"
 kill_only=0
 repair_compat_only=0
 install_spacewar=0
@@ -54,6 +58,15 @@ while [[ $# -gt 0 ]]; do
         shift
       fi
       ;;
+    --install-only)
+      install_only=1
+      shift
+      ;;
+    --wait-for-steam-exe)
+      [[ $# -ge 2 ]] || gptk_die "--wait-for-steam-exe requires a number of seconds"
+      install_wait_seconds="$2"
+      shift 2
+      ;;
     --kill)
       kill_only=1
       shift
@@ -135,6 +148,12 @@ if [[ "${install}" == "1" ]]; then
   [[ -n "${installer}" ]] || installer="${STEAM_SETUP_PATH:-${HOME}/Library/Application Support/RipperMoonKit/Downloads/SteamSetup.exe}"
   [[ -f "${installer}" ]] || gptk_die "Steam installer not found: ${installer}"
   "${launcher}" --prefix "${prefix}" --init --set-winver "${GPTK_DEFAULT_WINVER}" -- "${installer}" /S
+  if [[ ! -f "${steam_exe}" && "${install_wait_seconds}" == <-> && "${install_wait_seconds}" -gt 0 ]]; then
+    deadline=$(( SECONDS + install_wait_seconds ))
+    while [[ ! -f "${steam_exe}" && "${SECONDS}" -lt "${deadline}" ]]; do
+      sleep 2
+    done
+  fi
   [[ -f "${steam_exe}" ]] || gptk_die "Steam installer finished, but steam.exe was not created at ${steam_exe}"
 fi
 
@@ -144,6 +163,11 @@ if [[ "${legacy_cef}" == "1" ]]; then
   apply_steam_compat
 fi
 
+if [[ "${install_only}" == "1" ]]; then
+  "${launcher}" --prefix "${prefix}" --no-log -- wineserver -k >/dev/null 2>&1 || true
+  exit 0
+fi
+
 if [[ "${repair_compat_only}" == "1" ]]; then
   exit 0
 fi

docs/commands.html

@@ -67,6 +67,14 @@ <h2>Start And Stop Steam</h2>
       <pre><code>gptk-steam --log
 gptk-steam --kill</code></pre>
 
+      <h2>Install Steam Without Launching It</h2>
+      <p>Use this during setup so Steam is validated and then closed instead of opening the Steam UI.</p>
+      <pre><code>gptk-steam --install-only --install "$GPTK_EXTERNAL_ROOT/Installers/SteamSetup.exe"</code></pre>
+
+      <h2>Start Steam Install In Background</h2>
+      <p>Use this app-style setup command so users can set paths and cover art while Steam installs.</p>
+      <pre><code>./install.zsh --install-steam-background</code></pre>
+
       <h2>Install Spacewar / AppID 480</h2>
       <p>Run this once from the Steam prefix when a co-op Steamworks test path needs Spacewar initialized. Let Steam finish installing Spacewar, then close Spacewar before launching the game profile.</p>
       <pre><code>gptk-steam --log --install-spacewar</code></pre>

docs/commands.md

@@ -14,6 +14,12 @@ Install Windows Steam during bootstrap:
 ./install.zsh --install-steam
 ```
 
+Start Windows Steam installation in the background during app-style setup:
+
+```zsh
+./install.zsh --install-steam-background
+```
+
 Use a specific mounted GPTK source:
 
 ```zsh
@@ -127,9 +133,11 @@ gptk-launch --prefix MyGame --no-esync -- ./MyGame.exe
 Install Steam:
 
 ```zsh
-gptk-steam --install "$GPTK_EXTERNAL_ROOT/Installers/SteamSetup.exe"
+gptk-steam --install-only --install "$GPTK_EXTERNAL_ROOT/Installers/SteamSetup.exe"
 ```
 
+Use `--install-only` during setup so Steam is validated and then closed instead of launched.
+
 Start Steam:
 
 ```zsh

docs/dependencies.md

@@ -128,14 +128,22 @@ For the randomizer GUI, RipperMoonKit prefers Wine Staging 11.8 when available.
 
 ## Installing Windows Steam
 
-The default install downloads `SteamSetup.exe` but does not run the Windows Steam installer, because that creates or modifies the Steam Wine prefix.
+The default source install downloads `SteamSetup.exe` but does not run the Windows Steam installer, because that creates or modifies the Steam Wine prefix.
+
+The guided app setup starts Steam installation in the background. The user can move to the finished screen, set game folders, and add cover art while Steam validates `steam.exe`. After validation, Steam is closed instead of launched.
 
 To install Steam during bootstrap:
 
 ```zsh
 ./install.zsh --install-steam
 ```
 
+To start Steam installation in the background:
+
+```zsh
+./install.zsh --install-steam-background
+```
+
 ## Apple Game Porting Toolkit
 
 Apple Game Porting Toolkit is not redistributed by this project. Download **Game Porting Toolkit 3** from Apple Developer, mount the DMG, then run:

docs/faq.html

@@ -73,6 +73,9 @@ <h2>Can I close the game without closing Steam?</h2>
       <h2>Why install Visual C++ runtime per prefix?</h2>
       <p>Wine prefixes behave like separate Windows environments. Installing the runtime into the prefix that launches the game avoids many runtime popups and early exits.</p>
 
+      <h2>Why does source setup download SteamSetup but not always install Steam?</h2>
+      <p>Downloading SteamSetup.exe is safe and repeatable. Installing Windows Steam creates or modifies the Steam prefix. The guided app setup starts Steam installation in the background, moves to the finished screen, and closes Steam after validation. The source installer only installs Steam when requested with <code>./install.zsh --install-steam</code>.</p>
+
       <h2>Will updates delete saves?</h2>
       <p>Normal updates are designed to avoid saves, Wine prefixes, Steam data, games, and GPTK runtime folders. The installer backs up small toolkit files before replacing them.</p>
 

docs/faq.md

@@ -45,9 +45,9 @@ Steam API access depends on Steam client IPC. If Steam is running in one prefix
 
 For the documented ERSC workflow, Steam and ERSC run from the same `Steam` prefix.
 
-## Why Does The Installer Download SteamSetup But Not Always Install Steam?
+## Why Does The Source Installer Download SteamSetup But Not Always Install Steam?
 
-Downloading `SteamSetup.exe` is safe and repeatable. Installing Windows Steam creates/modifies the `Steam` prefix and may open UI. The installer only does that when requested:
+Downloading `SteamSetup.exe` is safe and repeatable. Installing Windows Steam creates/modifies the `Steam` prefix. The guided app setup starts Steam installation in the background, moves to the finished screen, and closes Steam after validation. The source installer only installs Steam when requested:
 
 ```zsh
 ./install.zsh --install-steam

docs/gui.html

@@ -72,6 +72,11 @@ <h1>One page per game.</h1>
       <h2>Library</h2>
       <p>The sidebar opens a library view with a grid of games and apps. Steam appears as its own app tile, and it can still be started automatically by profiles that depend on Steam. Profile pages now collapse large advanced sections so new users can stay focused while technical users can still inspect exact commands.</p>
 
+      <h2>First-Run Setup</h2>
+      <p>The first-run setup keeps required GPTK work separate from optional Steam waiting time. It prepares the bundled toolkit source, installs helper scripts, pauses for Apple GPTK 3.0 when needed, verifies the local GPTK runner/runtime, then starts Windows Steam installation in the background.</p>
+      <p>The app can move to <strong>You're all set</strong> while Steam continues installing. That finished screen tells users they can sign into Steam later from the Steam profile, set paths, add copied already-installed Windows game folders, and add a TheGamesDB API key for cover art.</p>
+      <p>While Steam is still installing, the app shows that state instead of claiming Steam is ready. The background log is written under <code>$GPTK_HOME/logs/steam-install-background-YYYYmmdd-HHMMSS.log</code>.</p>
+
       <h2>Profiles</h2>
       <p>Use <strong>Add Game</strong> to create a profile. Set the display name, icon, prefix, game folder, executable, and any game-specific runner. The square icon in the page header belongs to the selected game.</p>