From 5cc1092149556ff66b09b980aa35611a2f30e6fe Mon Sep 17 00:00:00 2001
From: John Finnerty <297514060+johnfinnerty-nz@users.noreply.github.com>
Date: Thu, 10 Sep 2026 08:59:04 +1200
Subject: [PATCH 1/2] docs: update macOS Wine installation instructions

Signed-off-by: John Finnerty <297514060+johnfinnerty-nz@users.noreply.github.com>
---
 ...1_setting_up_your_os_for_development_macos.md | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/articles/getting_started/1_setting_up_your_os_for_development_macos.md b/articles/getting_started/1_setting_up_your_os_for_development_macos.md
index 1556e588..6cdf9e48 100644
--- a/articles/getting_started/1_setting_up_your_os_for_development_macos.md
+++ b/articles/getting_started/1_setting_up_your_os_for_development_macos.md
@@ -62,7 +62,21 @@ 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
+    ```
+
+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.gz"
+    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 -xzf "$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:

From 9ce548f164937becdaab5c4f618bb947f76a4e62 Mon Sep 17 00:00:00 2001
From: John Finnerty <297514060+johnfinnerty-nz@users.noreply.github.com>
Date: Thu, 10 Sep 2026 10:24:34 +1200
Subject: [PATCH 2/2] docs: correct manual Wine installation

Signed-off-by: John Finnerty <297514060+johnfinnerty-nz@users.noreply.github.com>
---
 .../1_setting_up_your_os_for_development_macos.md            | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/articles/getting_started/1_setting_up_your_os_for_development_macos.md b/articles/getting_started/1_setting_up_your_os_for_development_macos.md
index 6cdf9e48..7380b697 100644
--- a/articles/getting_started/1_setting_up_your_os_for_development_macos.md
+++ b/articles/getting_started/1_setting_up_your_os_for_development_macos.md
@@ -63,6 +63,7 @@ MonoGame provides a setup script that can be executed to setup the Wine environm
 
     ```sh
     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:
@@ -70,10 +71,10 @@ MonoGame provides a setup script that can be executed to setup the Wine environm
     ```sh
     WINE_VERSION="11.0_1"
     WINE_DIR="$HOME/.winemonogame/wine-stable"
-    WINE_ARCHIVE="${TMPDIR:-/tmp}/wine-stable.tar.gz"
+    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 -xzf "$WINE_ARCHIVE" -C "$WINE_DIR"
+    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"