SethRobinson · mateusbentes · Feb 20, 2026 · Feb 20, 2026 · Feb 20, 2026 · Feb 20, 2026
diff --git a/INSTALL.md b/INSTALL.md
@@ -10,7 +10,7 @@ See [README.md](README.md) for download links if you just want to play the game.
 | **Linux** | CMake | Proton SDK cloned inside project, uses SDL2 + SDL2_mixer for audio |
 | **iOS** | Xcode | Proton SDK sibling layout, uses FMOD for audio |
 | **Android** | Gradle + CMake | Proton SDK sibling layout, uses FMOD for audio |
-| **macOS** | Xcode | Broken/unmaintained |
+| **macOS** | Xcode | Universal binary (Intel + Apple Silicon), uses SDL2 + SDL2_mixer for audio (see [macOS section](#macos)) |
 | **HTML5** | Emscripten | See [Proton HTML5 setup](https://www.rtsoft.com/wiki/doku.php?id=proton:html5_setup) |
 
 All platforms require the **Dink Smallwood game data** (`dink/` directory) to play. See [README.md](README.md#just-want-to-play) for how to obtain it.
@@ -92,23 +92,79 @@ proton/
 
 ---
 
-## macOS (broken/unmaintained)
+## macOS
 
-> **Note:** The macOS build has not been maintained for a long time and likely does not build without fixes. It is left here for reference.
+The macOS build uses the Xcode project at `OSX/RTDink.xcodeproj`.
 
-The Xcode project is at the repo root (`RTDink.xcodeproj`). Same sibling layout as Windows:
+- **Supported architectures:** Universal binary — runs natively on both **Intel (x86_64)** and **Apple Silicon (ARM64 / M1+)**.
+- **Audio:** Uses **SDL2** + **SDL2_mixer** — no FMOD required.
+- **SDL2 frameworks are bundled inside the `.app`** — no SDL2 installation required to run the game.
+
+### Directory layout
+
+Clone both repos as **siblings**:
 
 ```
-proton/
-  shared/          <-- Proton SDK
-  RTDink/
-    RTDink.xcodeproj
+some_folder/
+  proton/              <-- Proton SDK (cloned here)
+    shared/
+  RTDink/              <-- this repo (cloned here)
+    OSX/
+      RTDink.xcodeproj
 ```
 
-1. Clone [Proton SDK](https://github.com/SethRobinson/proton)
-2. Clone this repo inside the Proton directory
-3. Open `RTDink.xcodeproj` in Xcode
-4. Build and run (may require fixes)
+The Xcode project references `../../shared/` (relative to `OSX/`) to find the Proton SDK.
+
+### Steps
+
+1. Clone the Proton SDK and this repo as siblings:
+
+```bash
+git clone https://github.com/SethRobinson/proton.git
+git clone https://github.com/SethRobinson/RTDink.git
+```
+
+2. Install **SDL2** and **SDL2_mixer** frameworks:
+
+   **Option A — DMG frameworks** (recommended, works on all Macs, required for universal binary):
+   ```bash
+   # SDL2 framework
+   curl -L -o ~/SDL2.dmg "https://github.com/libsdl-org/SDL/releases/download/release-2.30.9/SDL2-2.30.9.dmg"
+   hdiutil attach ~/SDL2.dmg
+   mkdir -p ~/Library/Frameworks
+   cp -r /Volumes/SDL2/SDL2.framework ~/Library/Frameworks/
+   hdiutil detach /Volumes/SDL2
+
+   # SDL2_mixer framework
+   curl -L -o ~/SDL2_mixer.dmg "https://github.com/libsdl-org/SDL_mixer/releases/download/release-2.8.0/SDL2_mixer-2.8.0.dmg"
+   hdiutil attach ~/SDL2_mixer.dmg
+   cp -r "/Volumes/SDL2_mixer/SDL2_mixer.framework" ~/Library/Frameworks/
+   hdiutil detach /Volumes/SDL2_mixer
+   ```
+   The Xcode project looks for both frameworks in `~/Library/Frameworks/` automatically. These are universal frameworks (arm64 + x86_64) so the resulting `.app` runs on both Intel and Apple Silicon Macs.
+
+   **Option B — Homebrew** (native arch only, not suitable for universal binary):
+   ```bash
+   brew install sdl2 sdl2_mixer
+   ```
+   > **Note:** Homebrew on Apple Silicon only provides arm64 libraries. Use Option A if you need a universal binary.
+
+3. Generate the required libpng config header:
+
+```bash
+LIBPNG=proton/shared/Irrlicht/source/Irrlicht/libpng
+cp "$LIBPNG/pnglibconf.h.prebuilt" "$LIBPNG/pnglibconf.h"
+```
+
+4. Open the Xcode project:
+
+```bash
+open RTDink/OSX/RTDink.xcodeproj
+```
+
+5. Select the **Release** configuration and build (`⌘B`).
+
+> **Note:** The SDL2 frameworks are automatically embedded into the `.app` bundle at build time, so the final app is self-contained and does not require SDL2 to be installed on the target machine.
 
 ---
 

diff --git a/OSX/English.lproj/InfoPlist.strings b/OSX/English.lproj/InfoPlist.strings
@@ -0,0 +1,4 @@
+/* Localized versions of Info.plist keys */
+
+CFBundleGetInfoString = "Dink Smallwood HD v2.08, Copyright © 2024 Robinson Technologies";
+NSHumanReadableCopyright = "Copyright © 2024, Robinson Technologies";
diff --git a/OSX/English.lproj/MainMenu.xib b/OSX/English.lproj/MainMenu.xib
@@ -0,0 +1,90 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document type="com.apple.InterfaceBuilder3.Cocoa.XIB" version="3.0" toolsVersion="21701" targetRuntime="MacOSX.Cocoa" propertyAccessControl="none" useAutolayout="YES" customObjectInstantiationMethod="direct">
+    <dependencies>
+        <deployment identifier="macosx"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.CocoaPlugin" version="21701"/>
+        <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
+    </dependencies>
+    <objects>
+        <customObject id="-2" userLabel="File's Owner" customClass="NSApplication">
+            <connections>
+                <outlet property="delegate" destination="Voe-Tx-rLC" id="GzC-gU-4Uq"/>
+            </connections>
+        </customObject>
+        <customObject id="-1" userLabel="First Responder" customClass="FirstResponder"/>
+        <customObject id="-3" userLabel="Application" customClass="NSObject"/>
+        <customObject id="Voe-Tx-rLC" customClass="MainController">
+        </customObject>
+        <menu title="Main Menu" systemMenu="main" id="AYu-sK-qS6">
+            <items>
+                <menuItem title="Dink Smallwood HD" id="1Xt-HY-uBw">
+                    <modifierMask key="keyEquivalentModifierMask"/>
+                    <menu key="submenu" title="Dink Smallwood HD" systemMenu="apple" id="uQy-DD-JDr">
+                        <items>
+                            <menuItem title="About Dink Smallwood HD" id="5kV-Vb-QxS">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="orderFrontStandardAboutPanel:" target="-1" id="Exp-CZ-Vem"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="VOq-y0-SEH"/>
+                            <menuItem title="Services" id="NMo-om-nkN">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <menu key="submenu" title="Services" systemMenu="services" id="hz9-B4-Xy5"/>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="4je-JR-u6R"/>
+                            <menuItem title="Hide Dink Smallwood HD" keyEquivalent="h" id="Olw-nP-bQN">
+                                <connections>
+                                    <action selector="hide:" target="-1" id="PnN-Uc-m68"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Hide Others" keyEquivalent="h" id="Vdr-fp-XzO">
+                                <modifierMask key="keyEquivalentModifierMask" option="YES" command="YES"/>
+                                <connections>
+                                    <action selector="hideOtherApplications:" target="-1" id="VT4-aY-XCT"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Show All" id="Kd2-mp-pUS">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="unhideAllApplications:" target="-1" id="Dhg-Le-xox"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="kCx-OE-vgT"/>
+                            <menuItem title="Quit Dink Smallwood HD" keyEquivalent="q" id="4sb-4s-VLi">
+                                <connections>
+                                    <action selector="terminate:" target="-1" id="Te7-pn-YzF"/>
+                                </connections>
+                            </menuItem>
+                        </items>
+                    </menu>
+                </menuItem>
+                <menuItem title="Window" id="aUF-d1-5bR">
+                    <modifierMask key="keyEquivalentModifierMask"/>
+                    <menu key="submenu" title="Window" systemMenu="window" id="Td7-aD-5lo">
+                        <items>
+                            <menuItem title="Minimize" keyEquivalent="m" id="OY7-WF-poV">
+                                <connections>
+                                    <action selector="performMiniaturize:" target="-1" id="VwT-WD-YPe"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem title="Zoom" id="R4o-n2-Eq4">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="performZoom:" target="-1" id="DIl-cC-cCs"/>
+                                </connections>
+                            </menuItem>
+                            <menuItem isSeparatorItem="YES" id="eu3-7i-yIM"/>
+                            <menuItem title="Bring All to Front" id="LE2-aR-0XJ">
+                                <modifierMask key="keyEquivalentModifierMask"/>
+                                <connections>
+                                    <action selector="arrangeInFront:" target="-1" id="DRN-fu-gQh"/>
+                                </connections>
+                            </menuItem>
+                        </items>
+                    </menu>
+                </menuItem>
+            </items>
+        </menu>
+    </objects>
+</document>