Skip to content

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

keep Spotlight out of the engines and environments

Gauthier Piarrette963d3f74b084
diff --git a/Sources/HighballKit/Paths.swift b/Sources/HighballKit/Paths.swift
index c64311e..03c8f32 100644
--- a/Sources/HighballKit/Paths.swift
+++ b/Sources/HighballKit/Paths.swift
@@ -129,6 +129,19 @@ public struct HighballPaths: Sendable {
for dir in [home, downloads, engines, bottles, logs, manifests, trash] {
try FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)
}
+ excludeFromSpotlight()
+ }
+
+ /// Keeps Spotlight out of the engines and environments. A game install is tens or hundreds of
+ /// gigabytes of files nobody searches for, and indexing them costs real time: after a 75 GB
+ /// install on 2026-09-09 mds_stores sat at 55% with the load average above 300, the machine was
+ /// unusable for minutes, and a game launched into it looked like it had hung. The marker file
+ /// is the documented way to say "never index this subtree" and costs nothing when Spotlight is
+ /// already off.
+ func excludeFromSpotlight() {
+ let marker = home.appending(path: ".metadata_never_index")
+ guard !FileManager.default.fileExists(atPath: marker.path) else { return }
+ FileManager.default.createFile(atPath: marker.path, contents: nil)
}
/// Whether this home holds anything worth moving.
diff --git a/Tests/HighballKitTests/HomeLocationTests.swift b/Tests/HighballKitTests/HomeLocationTests.swift
index c050a70..5583f9f 100644
--- a/Tests/HighballKitTests/HomeLocationTests.swift
+++ b/Tests/HighballKitTests/HomeLocationTests.swift
@@ -55,6 +55,19 @@ final class HomeLocationTests: XCTestCase {
XCTAssertTrue(problem?.contains("larger than") == true, "says why, not just no: \(problem ?? "nil")")
}
+ // A game install is tens or hundreds of GB that nobody searches for. After a 75 GB install on
+ // 2026-09-09, Spotlight's mds_stores sat at 55% with the load average above 300 and the machine
+ // was unusable, which made a game launched into it look hung. ensure() marks the home so
+ // Spotlight skips it.
+ func testEnsureMarksTheHomeAsNeverIndexed() throws {
+ let home = tmp.appending(path: "home")
+ let paths = HighballPaths(home: home)
+ try paths.ensure()
+ XCTAssertTrue(FileManager.default.fileExists(atPath: home.appending(path: ".metadata_never_index").path),
+ "engines and environments must not be indexed")
+ try paths.ensure() // idempotent: a second run must not fail on the existing marker
+ }
+
func testVolumeProbePassesOnAWritableFolderAndLeavesNothing() throws {
let dir = tmp.appending(path: "vol")
try FileManager.default.createDirectory(at: dir, withIntermediateDirectories: true)