Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Xipzer/mac-windows-gaming

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mac-windows-gaming

Run Windows games on Apple Silicon macOS — for free, no CrossOver. A one-shot installer plus the hard-won knowledge base to get a working gaming environment (Steam / Epic / GOG / Amazon) using Apple's Game Porting Toolkit (D3DMetal) and free, open-source launchers.

Verified on macOS 26.5.2 (Tahoe), Apple M4 Max, July 2026. Built from a real, end-to-end troubleshooting session — every fix here was discovered by hitting the wall first.


TL;DR — one command

curl -fsSL https://raw.githubusercontent.com/Xipzer/mac-windows-gaming/main/install.sh | bash

This installs Rosetta 2, Homebrew, Heroic, Sikarugir, fetches your own copy of Apple's D3DMetal locally, and sets up a Steam-for-Windows wrapper with every fix pre-applied. There are exactly two unavoidable GUI clicks in Sikarugir (it has no headless wrapper-create API); the script tells you precisely what to click, then automates the rest.


What you get

Store Route Notes
Steam Sikarugir wrapper (Wine 10 + D3DMetal) Windows Steam client; works for non-anti-cheat games
Epic / GOG / Amazon Heroic (native) Native logins; games run via GPTk runner
EA / Origin ❌ not free EA App doesn't work under free Wine — needs paid CrossOver

Hard limits (any tool, free or paid):

  • Kernel anti-cheat (VAC-heavy, EAC, BattlEye) → won't run.
  • EA App games (Jedi Survivor, NFS Heat, the EA catalog) → no free route.
  • Online multiplayer is often broken under Wine even when the game runs offline.

The stack (and why)

Launcher     Heroic (Epic/GOG/Amazon)   +   Sikarugir (Steam)
Wine engine  Sikarugir 10  (Wine 10)  ← best: newest Wine, stable Steam webhelper
Renderer     D3DMetal (DX11/12)  ·  DXMT (DX10/11)  ·  DXVK (DX10/11 via Vulkan)
             ^ chosen per-game, INDEPENDENT of the Wine engine (a checkbox)
D3DMetal     Apple GPTk (fetched locally, never redistributed)

Full rationale in docs/ENGINES.md.


Scripts (run any individually)

Script Purpose
install.sh One-shot: everything below in order. Idempotent.
scripts/doctor.sh Read-only: report system + what's installed/current. Start here.
scripts/fetch-d3dmetal.sh Fetch your Apple D3DMetal locally (DMG or Gcenx brew).
scripts/setup-steam.sh Build/repair the Steam wrapper with all fixes.
scripts/swap-engine.sh Change a wrapper's Wine engine from the CLI.
scripts/update-dxmt.sh Update the DXMT (DX10/11→Metal) layer to latest.
scripts/check-compat.sh Will this game run? Encodes the decision tree.
# examples
bash scripts/doctor.sh
bash scripts/check-compat.sh 1790600            # Dragon Ball Sparking! ZERO -> LIKELY WORKS
bash scripts/check-compat.sh 1774580            # Jedi Survivor -> BLOCKED (EA App)
bash scripts/swap-engine.sh WS12WineSikarugir10.0_6 Steam

Native ports beat translation — check first

Several games have official native macOS builds that outperform the Windows-via-Wine route on Apple Silicon. Don't run these through the wrapper:

Game Run as Note
Valheim Native Apple Silicon build; no Rosetta/Wine
Batman: Arkham City Native 64-bit Metal (via Rosetta)
Shadow of Mordor Native 64-bit Metal; Wine route is unplayable
Tomb Raider (2013) Native Add Steam launch option -nolauncher (32-bit launcher is broken)

Rule of thumb: native (even via Rosetta) usually wins; use Wine/D3DMetal only for Windows-exclusive titles. Details in docs/NATIVE-VS-WRAPPER.md.


Troubleshooting

Every error we hit and its fix is in docs/TROUBLESHOOTING.md. Highlights:

Symptom Fix
Wrapper keeps re-running the installer Launch target must be steam.exe, not SteamSetup.exe (auto-fixed by setup-steam.sh)
Failed to load steamui.dll Let Steam self-update; don't block it with steam.cfg
steamwebhelper is not responding / BMainLoop stalled Use Sikarugir 10 (Wine 10) engine, not GPTk 1.1
Unexpected Transport Error (0x3008) Add -tcp launch flag; "VO: Continue Anyway"
EA App INST-14-1627 No free fix — EA App needs paid CrossOver

For AI agents

This repo is designed to be agent-drivable. See AGENTS.md for a structured workflow, decision points, exit codes, and the invariants you must respect (e.g. never delete steamapps/, always prefer native ports, EA App is a hard stop).


Requirements

  • Apple Silicon (M-series). Intel Macs cannot use D3DMetal.
  • macOS 14 (Sonoma)+. macOS 15+ for AVX games; 26 (Tahoe) for MetalFX.
  • You must own the games. This project is about tooling, not piracy.
  • ~free disk space for games (they're large).

Legal / licensing

  • This repo ships no Apple binaries. Apple's D3DMetal is free to download but its EULA forbids redistribution, so each user fetches their own copy locally at install time (scripts/fetch-d3dmetal.sh).
  • Repo code is MIT (see LICENSE). Wine, DXMT, Heroic, Sikarugir, Gcenx builds are the property of their respective projects.

Credits / sources

Built on the work of: Gcenx (Wine/GPTk/DXMT macOS builds), Sikarugir (Wineskin successor), Heroic Games Launcher, 3Shain/DXMT, Apple (Game Porting Toolkit), and the r/macgaming / AppleGamingWiki communities.

See docs/SOURCES.md for the full link list and version snapshot.

About

Run Windows games on Apple Silicon macOS for free (no CrossOver) — one-shot installer + knowledge base using Apple's Game Porting Toolkit / D3DMetal with Heroic + Sikarugir.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Morty Proxy This is a proxified and sanitized view of the page, visit original site.