Skip to content

Run Windows games on Apple Silicon — free, open source, with an open compatibility database that tells you what actually works.

A game the Windows Steam client installed no longer counts as installed in Steam for Mac. Highball reads Steam for Mac's appmanifests from every library folder it lists, and a library folder both clients use (an external drive, now that external drives get letters in environments) shows it the Windows client's manifests too. Such a Windows-only game then read as installed in Steam for Mac, its page led with Play on Mac, and Play went to Steam for Mac with none of the game's fix applied. A Discord player's Forza Horizon 6 page showed exactly that ("Installed in Steam for Mac", Play on Mac, an environment still on Wine 10 r21 with DXMT), though how their copy got there isn't confirmed yet. Each ACF records the client that wrote it (LauncherPath: "C:\\Program Files (x86)\\Steam\\steam.exe" from Steam in an environment, checked on the M1's Gaming environment, a Mac path from Steam for Mac); MacSteam.installedGames now skips manifests a Windows client wrote. A manifest without LauncherPath counts as before. New test.

Gauthier Piarrettefb2aad152556
diff --git a/Sources/HighballKit/MacSteam.swift b/Sources/HighballKit/MacSteam.swift
index 86f7744..241807f 100644
--- a/Sources/HighballKit/MacSteam.swift
+++ b/Sources/HighballKit/MacSteam.swift
@@ -47,7 +47,9 @@ public enum MacSteam {
.filter { $0.lastPathComponent.hasPrefix("appmanifest_") && $0.pathExtension == "acf" }
}
.compactMap { SteamLibrary.parseManifest($0) }
- .filter { $0.isReady && $0.appid != 228980 && seen.insert($0.appid).inserted }
+ // A manifest the Windows client wrote is that client's game, not a Mac install (a shared
+ // library folder lists both).
+ .filter { $0.isReady && !$0.installedByWindowsSteam && $0.appid != 228980 && seen.insert($0.appid).inserted }
.sorted { $0.name.localizedCaseInsensitiveCompare($1.name) == .orderedAscending }
}
}
diff --git a/Sources/HighballKit/SteamLibrary.swift b/Sources/HighballKit/SteamLibrary.swift
index 460e921..5c140f0 100644
--- a/Sources/HighballKit/SteamLibrary.swift
+++ b/Sources/HighballKit/SteamLibrary.swift
@@ -15,11 +15,25 @@ public struct SteamGame: Identifiable, Sendable, Hashable {
/// Steam keeps more than one, the second often on an external disk, so the install path
/// cannot be derived from the bottle alone. nil for a game built without one.
public let libraryRoot: URL?
+ /// The Steam client that installed the game, as the ACF's LauncherPath records it: a Windows
+ /// path for Steam in an environment (`C:\\Program Files (x86)\\Steam\\steam.exe`), a Mac
+ /// path for Steam for Mac. nil when the manifest has none.
+ public let launcherPath: String?
public init(appid: Int, name: String, installdir: String, sizeOnDisk: Int64, stateFlags: Int, lastPlayed: Date?,
- libraryRoot: URL? = nil) {
+ libraryRoot: URL? = nil, launcherPath: String? = nil) {
self.appid = appid; self.name = name; self.installdir = installdir; self.sizeOnDisk = sizeOnDisk
self.stateFlags = stateFlags; self.lastPlayed = lastPlayed; self.libraryRoot = libraryRoot
+ self.launcherPath = launcherPath
+ }
+
+ /// Installed by a Windows Steam, the one in an environment. A library folder both clients use
+ /// (an external drive, say) shows Steam for Mac the Windows client's manifests too, and a
+ /// Windows-only game then read as installed in Steam for Mac and played there: Forza Horizon 6
+ /// got "Play on Mac" and never its own fix (Discord, 2026-10-09).
+ public var installedByWindowsSteam: Bool {
+ guard let path = launcherPath else { return false }
+ return path.lowercased().hasSuffix(".exe") || path.range(of: #"^[A-Za-z]:\\"#, options: .regularExpression) != nil
}
public var id: Int { appid }
@@ -135,7 +149,8 @@ public enum SteamLibrary {
sizeOnDisk: Int64(fields["SizeOnDisk"] ?? "") ?? 0,
stateFlags: Int(fields["StateFlags"] ?? "") ?? 0,
lastPlayed: played > 0 ? Date(timeIntervalSince1970: played) : nil,
- libraryRoot: libraryRoot
+ libraryRoot: libraryRoot,
+ launcherPath: fields["LauncherPath"]
)
}
}
diff --git a/Tests/HighballKitTests/MacSteamBuildTests.swift b/Tests/HighballKitTests/MacSteamBuildTests.swift
index 49fb563..4fc3432 100644
--- a/Tests/HighballKitTests/MacSteamBuildTests.swift
+++ b/Tests/HighballKitTests/MacSteamBuildTests.swift
@@ -71,6 +71,22 @@ final class MacSteamBuildTests: XCTestCase {
"Cuphead is still downloading; redistributables aren't a game; one Balatro")
}
+ /// A library folder both clients use shows Steam for Mac the Windows client's manifests. Those
+ /// are the environment's games, not Mac installs: Forza Horizon 6 got "Play on Mac" (2026-10-09).
+ func testAManifestTheWindowsClientWroteIsNoMacInstall() throws {
+ let root = try macSteam(["root": [(2379780, "Balatro", 4)]])
+ let dir = root.appending(path: "steamapps")
+ try #""AppState" { "appid" "2483190" "name" "Forza Horizon 6" "StateFlags" "4" "installdir" "ForzaHorizon6" "LauncherPath" "C:\\Program Files (x86)\\Steam\\steam.exe" }"#
+ .write(to: dir.appending(path: "appmanifest_2483190.acf"), atomically: true, encoding: .utf8)
+ try #""AppState" { "appid" "588650" "name" "Dead Cells" "StateFlags" "4" "installdir" "Dead Cells" "LauncherPath" "/Users/me/Library/Application Support/Steam/Steam.AppBundle/Steam/Contents/MacOS/steam_osx" }"#
+ .write(to: dir.appending(path: "appmanifest_588650.acf"), atomically: true, encoding: .utf8)
+ XCTAssertEqual(MacSteam.installedGames(root: root).map(\.appid), [2379780, 588650],
+ "the Windows client's Forza is left out, a Mac path or no path counts as before")
+ let forza = try XCTUnwrap(SteamLibrary.parseManifest(dir.appending(path: "appmanifest_2483190.acf")))
+ XCTAssertTrue(forza.installedByWindowsSteam)
+ XCTAssertFalse(try XCTUnwrap(SteamLibrary.parseManifest(dir.appending(path: "appmanifest_588650.acf"))).installedByWindowsSteam)
+ }
+
func testNoSteamForMacIsNothingInstalled() {
let nowhere = FileManager.default.temporaryDirectory.appending(path: "hb-nosteam-\(UUID())")
XCTAssertEqual(MacSteam.installedGames(root: nowhere), [])