WinSteamOnMac

KO | EN

gitlite — search

#javascript #python #hacktoberfest #llm #android #machine-learning #deep-learning #macos #java #vue #security #ios #mcp #openai

(★ 211)

Run the Windows version of Steam on macOS Sonoma or Sequoia with Apple's Game Porting Toolkit

파일 탐색기

최종 버전 다운로드 (.zip)

- gameporting.png
- shortcuts.png
- shortcuts2.png
- WindowsSteamOnMac.png
- winecfg.png
README.md
self-builder.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Howto install the Windows version of Steam on Apple Silicon runing macOS Sonoma or Sequoia

We will install the x86 version Homebrew in order to be able to use Apple's modified version of `Wine` and to install the Windows version Steam on Apple Silicon hardware.

We will make sure that our existing environment (and the Apple silicon version of Homebrew we need for 'serious' work) remains undisturbed.

This guide is only tested for Apple Silicon machines.

![Security warning:](http://img.shields.io/badge/Warning-orange.svg?style=flat): [Apple's homebrew recipe](https://raw.githubusercontent.com/apple/homebrew-apple/main/Formula/game-porting-toolkit.rb) uses heavily patched infrastructure components and is currently broken. This guide uses a prebuilt toolkit.

## Alternative: use Asahi Linux instead of unreliable macOS for gaming

- Given the fact that arbitrary and undocumented and intranspartent updates of Apple's macOS continue to break efforts to use macOS for gaming, and
- Given the recent progress of graphics support and wine support with Asahi Linux, the recommended path of action is to instead use an [Asahi Linux](https://asahilinux.org/) installation for Steam gaming, see [AAA Gaming on Asahi Linux](https://asahilinux.org/2024/10/aaa-gaming-on-asahi-linux/).

The trade-offs are:

- you'll have a second (excellent!) operating system on your Mac hardware, which requires additional disk space
- You will need technical skills to install and maintain Asahi Linux
- The graphics environment for Asahi Linux is still in a very early stage and under heavy development
- On the plus-side you'll have an **ever-improving, transparent and open operating system to work with**

## Latest tested versions

- 2024-12-11: ![ERROR:](http://img.shields.io/badge/Error-red.svg?style=flat): This guide is currently broken. Steam setup seems to crash on new installations. Some hints if you want to experiment: `wine` has to be replaced by `wine64` when using the latest (2024/11) beta 3 of GCenX's game-porting-toolkit.

**ALTERNATIVE**: See note on Asahi Linux above.

- 2024-09-22: macOS 15.1 Sequoia and GCenX prebuilt toolkit (see **Update notes**)
- 2024-06-15: macOS 14.5 and the prebuilt `game_porting_toolkit` versions provided by [Dean Greer (GCenX)](https://github.com/Gcenx/game-porting-toolkit) which includes the latest 2.0 beta drivers for easy & up-to-date installation, it's no longer necessary (and anyway broken) to build the toolkit yourself, and all necessary components are included CGenX's build, so no longer necessary to download Apple's toolkit, Xcode or Command Line Toolkits.

## Preparations:

- [Download Steam](https://store.steampowered.com/about/download). Make sure to download the [Windows setup](https://cdn.akamai.steamstatic.com/client/installer/SteamSetup.exe), and not the (default) Mac version. You should now have a file `SteamSetup.exe`.

## Step-by-step installation

- The minimum macOS version is macOS Sonoma 14.5, a prebuilt game-porting-toolkit will be downloaded later via homebrew.
- This guide only applies to **Apple Silicon Macs. No Intel support.**
- Open a terminal (or iTerm2)
- Make sure that rosetta is installed by entering:

```bash
softwareupdate --install-rosetta
```

Now your Mac is able to execute x86_64 code. This is the basis for all the following installation.

- Now switch to a x86 shell by entering: (Note: zsh is no longer supported for x86!)

```bash
arch -x86_64 bash
```

Type `arch` again, to make sure that you are using Intel. It should **not** show `arm64`, but `i386` ( ;-) )

Now, from a terminal that uses `x86_64` arch, install homebrew for x86:

```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

This will install the Intel x86 version of homebrew to `/usr/local`. If you already installed homebrew
for Apple Silicon, then that version resides in `/opt/homebrew` and won't be touched. This guide will assume that the Apple Silicon
homebrew is your important version, and will remain the default when working with terminal or using `brew`. If you do not have
an Apple Silicon version of homebrew installed, don't worry, nothing we do here requires that or modifies any of it.

Do **not** follow the recommendation at the end of the x86-homebrew install script to put `shellenv` into `.zprofile`. (That 
would put the x86 Version of Homebrew into your paths, conflicting with an Apple Silicon version of homebrew. No paths or
environment modifications are needed in order to proceed!)

In order not to mess up the two homebrew versions, we create an alias for the Intel homebrew:

```bash
alias brew86=/usr/local/bin/brew
```

Note: if you are following Apple's readme, make sure to replace all instances of `brew` in Apple's doc with `brew86` from now on.

## Installation using a pre-built toolkit

Use [Dean Greer's (GCenX)](https://github.com/Gcenx/game-porting-toolkit) versions of the toolkit that have been prebuilt. This is the faster installation method (and currently the only non-broken one):

```bash
brew86 install --cask --no-quarantine gcenx/wine/game-porting-toolkit
```

This installs a macOS Application "Game Porting Toolkit" based on the old working binaries that opens a pre-configured terminal with all the game-porting tools.

- Go to macOS 'Applications' and open "Game Porting Toolkit".
- In the terminal window that gets started by the application, enter:

`wine64 winecfg`

to verify everything is working. Close Winecfg and start with the update procedure to the latest drivers.

### Updating the drivers (OPTIONAL, currently not necessary)

Since CGenc's toolkit already contains the 2.0 beta drivers, it's currently not necessary to manually update the drivers. Skip to **Steam installation**, if current version of toolkit is 2.0 beta.

> Make sure that you have opened the "Evaluation environment for Windows Games". You should see a folder at `/Volumes/Evaluation environment for Windows games 2.0`. Then start the update:
>
> ```bash
> cd /Applications/Game\ Porting\ Toolkit.app/Contents/Resources/wine/lib/external
> 
> mv D3DMetal.framework D3DMetal.framework-old; mv libd3dshared.dylib libd3dshared.dylib-old
>
> ditto /Volumes/Evaluation\ environment\ for\ Windows\ games\ 2.0/redist/lib/external/ .
> ```
>
> This is silent on success.

### Steam installation

Now you are ready to install Steam. Again, use a Terminal that is opened by the "Game Porting Toolkit" application in your `Applications` folder, not the default terminal. Enter:

```bash
MTL_HUD_ENABLED=0 WINEESYNC=1 wine64 ~/Downloads/SteamSetup.exe
```

After some time, the Steam login appears!

Steam has been installed into the wine prefix at `~/.wine` and your Toolkit software resides within the application "Game Porting Toolkit". From any Terminal, you can now start Steam directly with:

```bash
MTL_HUD_ENABLED=0 WINEESYNC=1 /Applications/Game\ Porting\ Toolkit.app/Contents/Resources/wine/bin/wine64 ~/.wine/drive_c/Program\ Files\ $x86$/Steam/steam.exe
```

This takes some times, but then Steam starts.

## Create a shortcut for Steam

We can use Apple's 'Shortcuts' app to automate the process of launching Wine & Steam Windows. Start the Shortcuts app, create a new shortcut and add the action 'Run Shell Script'.

![](https://raw.githubusercontent.com/domschl/WinSteamOnMac/main/Resources/shortcuts2.png)

The script text is:

```bash
cd ~/.wine/drive_c
MTL_HUD_ENABLED=0 WINEESYNC=1 /Applications/Game\ Porting\ Toolkit.app/Contents/Resources/wine/bin/wine64 ~/.wine/drive_c/Program\ Files\ $x86$/Steam/steam.exe
```

> **Note:** 'Shortcut' might ask you for confirmation, if you want to run scripts, and you need to enable that via the settings-link provided.

Add an icon to the shortcut, and you are ready to go. The shortcut can be put into the dock, and now you simply can directly start Steam for Windows! 
(Right-click the shortcut script in the 'Shortcuts' app and select 'Add to dock' to create shortcut for your shortcut in the Shortcuts app...)

Just be patient when starting Steam, it takes quite a long time!

## Update or repair notes

- Steam should work with macOS 15.0 and Gcenx's version of the game-porting-toolkit.
- I had to reinstall and update `brew86` _and_ Steam, your mileage might vary.

After an OS update, you might want:

- Make sure that you have Xcode 16 or the v16 Command Line Tools installed. When using Xcode, start Xcode at least once, because Apple only allows to compile code after you accepted their license agreement.

Switch to X86 console:

```bash
arch -x86_64 bash  
```

Add an alias:

```bash
alias brew86=/usr/local/bin/brew
```

Upgrade x86 brew:

```bash
brew86 upgrade
```

Reinstall or upgrade [Dean Greer's (GCenX) game-porting-toolkit](https://github.com/Gcenx/game-porting-toolkit) Use `upgrade` instead of `install` below to simply look for upgrades of the toolkit:

```bash
brew86 upgrade --cask --no-quarantine gcenx/wine/game-porting-toolkit
```
***or***
```bash
brew86 install --cask --no-quarantine gcenx/wine/game-porting-toolkit
```

Note: if `install` fails, because there are still debris of old versions, (Errors like "`wine already exists`"), look at `ls /usr/local/bin/wine*` and remove the files that block the install.

Now check that `wine` works correctly:

```bash
wine64 winecfg
```

The Wine setup screen should appear. There's no need to adapt settings in the setup dialog, simply close it with 'OK'.

At last, install a fresh copy of steam, after downloading the _Windows_ version of Steam's setup: `SteamSetup.exe`, then:

```bash
MTL_HUD_ENABLED=0 WINEESYNC=1 wine64 ~/Downloads/SteamSetup.exe
```

The setup throws quite a number of warning, not-implemented, and error messages. Nevertheless, after waiting patiently for a few minutes, the Steam login should appear!

### References

- Good collection of information: [Apple Gaming Wiki](https://www.applegamingwiki.com/wiki/Game_Porting_Toolkit)
- A 'batteries-included' GUI version to get the game-porting-toolkit running: [Whisky](https://github.com/Whisky-App/Whisky)
- Pre-built versions of the toolkit are available at [Gcenx repository](https://github.com/Gcenx/game-porting-toolkit/releases)
- [Apple Games](https://developer.apple.com/games/) hosts the original [Game Porting Toolkit](https://developer.apple.com/download/all/?q=game%20porting%20toolkit). There are two possible downloads: "Evaluation environment for Windows games 2.0 beta" and "Game porting toolkit 2.0 beta". The later is larger and contains the 'Evaluation environment' too. We will need the "Evaluation environment for Windows games 2.0" only. The "Evaluation environment for Windows games 2.0" contains a Readme that outlines the installation process, but here we will customize it, in order to run Steam.

### History

- 2024-12-11: This guide stops recommending to fight against Apple's undocumented and intransparent macOS updates and recommends using Asahi Linux instead.
- 2024-09-22: Retested installation with macOS 15.0 Sequoia, added paragraph 'Update notes'.
- 2024-06-15: Installation based on [Gcenx repository](https://github.com/Gcenx/game-porting-toolkit) is now even easier, since it already contains the toolkit components.
- 2024-06-11: Apple releases `game_porting_toolkit` 2.0 beta 1, self-built is __still__ broken, but a work-around is available using a pre-built toolkit. The self-builder instructions have been moved [here](https://github.com/domschl/WinSteamOnMac/blob/main/self-builder.md) (build is broken!).
- 2024-03-26: Apple's `game_porting_toolit` requires Command Line Tools version 15.1 to build successfully, newer versions are not (yet) supported.
- 2024-03-24: Apple's `game_porting_toolkit` is broken, the project currently doesn't install until the build is fixed by Apple.
- 2024-03-08: macOS 14.4 testet ok.
- 2023-11-24: Apple Game Porting Toolkit 1.1 changes. Addressed suggestions by @mobigroup and @cdtj concerning username placeholders.
- 2023-10-06: New installations with Xcode 15, Sonoma 14.0 release and `game-porting-toolkit` 1.0 retested, ok.
- 2023-10-06: Small fixes for release version of `game-porting-toolkit` 1.0, Uninstallation and troubleshooting notes.
- 2023-09-26: macOS Sonoma 14.0 Release tested ok. No changes.
- 2023-09-24: Retest with Sonoma RC, `game-porting-toolkit` Beta 4 (Note: library path on Apple's IMG has changed from `lib` to `redist/lib`.
- 2023-08-14: Updates for `game-porting-tookit` Beta 3 alias 1.0.3 and Sonoma Beta 5. (No significant changes to the update procedure).
- 2023-07-04: Section **Update notes** added. Apple has published a new version 1.0.2 of the game-porting toolkit.

WinSteamOnMac

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

WinSteamOnMac

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README