Skip to content

docs: update macOS Wine installation instructions #309

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
johnfinnerty-nz wants to merge 2 commits into
base: main
Choose a base branch
from
+16 −1
Open

docs: update macOS Wine installation instructions #309

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5cc1092
docs: update macOS Wine installation instructions
johnfinnerty-nz Sep 9, 2026
9ce548f
docs: correct manual Wine installation
johnfinnerty-nz Sep 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion articles/getting_started/1_setting_up_your_os_for_development_macos.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,22 @@ MonoGame provides a setup script that can be executed to setup the Wine environm
1. Enter the following command:

```sh
brew install wget p7zip curl && brew install --cask wine-stable && xattr -dr com.apple.quarantine "/Applications/Wine Stable.app"
brew install wget p7zip curl
brew install --cask xquartz
```

1. Download and install Wine manually because the Homebrew `wine-stable` cask is no longer available:

```sh
WINE_VERSION="11.0_1"
WINE_DIR="$HOME/.winemonogame/wine-stable"
WINE_ARCHIVE="${TMPDIR:-/tmp}/wine-stable.tar.xz"
mkdir -p "$WINE_DIR"
curl --fail --location --output "$WINE_ARCHIVE" "https://github.com/Gcenx/macOS_Wine_builds/releases/download/${WINE_VERSION}/wine-stable-${WINE_VERSION}-osx64.tar.xz"
tar -xf "$WINE_ARCHIVE" -C "$WINE_DIR"
xattr -dr com.apple.quarantine "$WINE_DIR/Wine Stable.app"
echo "export PATH=\"\$PATH:$WINE_DIR/Wine Stable.app/Contents/Resources/wine/bin\"" >> "$HOME/.zprofile"
export PATH="$PATH:$WINE_DIR/Wine Stable.app/Contents/Resources/wine/bin"
```

1. Now that the prerequisites are installed, download the [mgfxc_wine_setup.sh](https://monogame.net/downloads/net9_mgfxc_wine_setup.sh) script and execute it by entering the following command in the terminal:
Expand Down