Skip to content

About

Arm64 / Arm64EC Wine 11.20 with FEX, and Wine 11.17 x86_64 for MacOS Silicon 15+

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

37 stars

Watchers

1 watching

Forks

MetalSharp Wine

MetalSharp Wine

Release License: AGPL-3.0

The Official Open-Source Wine of MetalSharp

Wine 11.20 as a native arm64 macOS app for Apple silicon. It runs ARM64, x86_64 and 32-bit x86 Windows programs, with x86 code translated by FEX, and Direct3D 9–12 and OpenGL 4.6 on Metal. No Rosetta. It needs macOS 15 or later, and 32-bit programs need macOS 26.4 or later.


Early access. Contribution is Welcome!


Install

  1. Download MetalSharp-Wine-<version>-arm64.zip from Releases.
  2. Unzip it and move MetalSharp-Wine.app to /Applications.

MetalSharp uses the app from its Play button, so there's nothing else to set up there. On its own the app has no window: you run it from Terminal, as below.

Steam

Paste each block into Terminal. Each one sets up what it needs, so they work in a new window too.

1. Make a prefix for Steam (~/Games/steam; it takes a minute or two):

APP=/Applications/MetalSharp-Wine.app/Contents; export WINEPREFIX=~/Games/steam WINEDEBUG=-all
"$APP/MacOS/wine" wineboot -u -r && "$APP/MacOS/wineserver" -w
for a in x64 x86; do "$APP/MacOS/wine" "$APP/share/metalsharp/redist/vcrun2022/vc_redist.$a.exe" /install /quiet /norestart; "$APP/MacOS/wineserver" -w; done

2. Install Steam:

APP=/Applications/MetalSharp-Wine.app/Contents; export WINEPREFIX=~/Games/steam WINEDEBUG=-all
"$APP/MacOS/wine" "$APP/share/metalsharp/steam/SteamSetup.exe" /S; "$APP/MacOS/wineserver" -w

3. Launch Steam (run this one whenever you want Steam):

APP=/Applications/MetalSharp-Wine.app/Contents; export WINEPREFIX=~/Games/steam WINEDEBUG=-all
cd "$WINEPREFIX/drive_c/Program Files (x86)/Steam" && "$APP/MacOS/wine" steam.exe

Steam updates itself the first time it starts. To close everything in the prefix:

WINEPREFIX=~/Games/steam /Applications/MetalSharp-Wine.app/Contents/MacOS/wineserver -k

Other programs

export WINE=/Applications/MetalSharp-Wine.app/Contents/MacOS/wine
WINEPREFIX=~/Games/my-prefix $WINE ~/Downloads/setup.exe

The first run makes the prefix. Switches such as the Direct3D backend are in docs/USAGE.md.

Reporting problems

More

docs/CHANGES.md What's new in each release
docs/USAGE.md Running programs, and every switch
docs/FEATURES.md What's included, how it works on macOS, and limitations
docs/X86_64.md The x86_64 build (MetalSharp-Wine-x86_64.app, under Rosetta 2, with D3DMetal)
docs/BUILDING.md The sources and how to build
docs/LICENSES.md Licenses. MetalSharp Wine's own material is AGPL-3.0

About

Arm64 / Arm64EC Wine 11.20 with FEX, and Wine 11.17 x86_64 for MacOS Silicon 15+

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

37 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages