From ffc320904e8806143bb9b9044a6cbe95f0efa11a Mon Sep 17 00:00:00 2001
From: The Brink of Tomorrow
 <36106138+TheBrinkOfTomorrow@users.noreply.github.com>
Date: Sat, 25 Feb 2023 10:39:00 -0500
Subject: [PATCH] Update README.md with macOS build details

Update README.md with macOS build and run instructions
---
 README.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/README.md b/README.md
index b8f6611..b964183 100644
--- a/README.md
+++ b/README.md
@@ -71,3 +71,42 @@ For network support:
 ```
 make -f Makefiles/Makefile.UNIX NET_BOARD=1
 ```
+
+### macOS
+
+Ensure Apple's Xcode Command Line Tools are installed:
+
+From a terminal:
+```
+xcode-select --install
+```
+
+Ensure SDL2 is installed.  Download the latest *.dmg files from both of the links below, and install per the READMEs in the .dmgs (i.e. in "/Library/Frameworks")
+
+* SDL2: https://github.com/libsdl-org/SDL/releases
+
+* SDL_net: https://github.com/libsdl-org/SDL_net/releases
+
+
+And then build Supermodel:
+
+```
+make -f Makefiles/Makefile.OSX
+```
+
+For network support:
+
+```
+make -f Makefiles/Makefile.OSX NET_BOARD=1
+```
+
+### Note: running on macOS
+If you try and run a macOS binary that was downloaded from the internet and/or built on a different machine, you need to grant macOS permission to execute the binary (just 1-time):
+
+* Open the folder containing the binary in Finder, and right (or ctrl) click on it:
+
+* Click "Open" when the following dialogue box appears : "macOS cannot verify the developer of “supermodel-git-xxxx”. Are you sure you want to open it?"
+
+* Close the terminal window that opens (after clicking open)
+
+Details: https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac