Skip to content

Ansenchen123/eldenringForMac

Repository files navigation

MacSteamPort

Run Windows Steam games on Apple Silicon Macs through a free GPTK / Wine translation stack — no CrossOver, no paid components. This is an open-source project under the MIT license.

The repository contains two layers:

  1. MacSteamPort (MacSteamPort/) — a native SwiftUI macOS app that detects a GPTK/Wine runtime, imports a shared Windows Steam bottle, scans the Steam library, and launches games with per-game compatibility profiles (Retina/DPI setup, DLL overrides, controller fixes, offline mode).
  2. Legacy shell scripts (repository root) — the original manual workflow the app grew out of, kept as a standalone fallback. See docs/ELDEN_RING_MAC_GPTK_RUNBOOK.md.

Quick start

# Run the tests
swift test --package-path MacSteamPort

# Build the app and an unsigned DMG into dist/
./MacSteamPort/Scripts/package-macsteamport.sh

Requirements: macOS 14+ on Apple Silicon, Xcode command line tools, and a Wineskin / Porting Kit wrapper or the free gcenx/wine/game-porting-toolkit Homebrew cask (the app's first-run wizard can install the latter for you).

Game profiles

Games launch through JSON compatibility profiles (MacSteamPort/Sources/MacSteamPortCore/Resources/Profiles/). Elden Ring ships as the built-in known-good profile; any other installed Steam game falls back to a generic profile that you can override per game from the app. Contributions of verified profiles are welcome.

Anti-cheat disclaimer

The optional "EAC offline bypass" launch option only enables offline single-player play for games whose anti-cheat does not run under Wine/GPTK. It does not and cannot enable online play, and you should not attempt to use it online. Use at your own risk and only with games you own.

Configuration

Both the app and the scripts honor the same environment overrides:

Variable Purpose
MACSTEAMPORT_WINESKIN_WRAPPER Path to the Wineskin/Porting Kit wrapper .app
MACSTEAMPORT_PREFIX Wine prefix path (scripts only)
MACSTEAMPORT_APP_SUPPORT Override the app's Application Support directory

The app also auto-discovers wrappers in ~/Applications and /Applications, configurable in Settings.

Contributing

Bug reports, verified game profiles, and translations are welcome — see CONTRIBUTING.md. Security issues should be reported privately per SECURITY.md. Release history lives in CHANGELOG.md.

License

MIT. The project does not bundle Apple GPTK, Steam, or any game content.

About

MacSteamPort GPTK/Wine Steam launcher for Apple Silicon Macs

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors