From 0b574eb01cafb2af8827a4fcb4202146cfa0e84d Mon Sep 17 00:00:00 2001
From: garakmon <thomastaps194@comcast.net>
Date: Sat, 16 Jun 2018 18:49:53 -0400
Subject: [PATCH] adding macOS install instructions

While the procedure here is similar to the Linux one, there are some
Mac-specific quirks that I thought warranted some more detail.
---
 INSTALL.md | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 59 insertions(+), 4 deletions(-)

diff --git a/INSTALL.md b/INSTALL.md
index cd8f4b185..3eb980eb6 100644
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -8,16 +8,22 @@ Make sure that there is an environment variable called DEVKITARM with the path o
 
 Then get the compiler from https://github.com/pret/agbcc and run the following commands.
 
-	./build.sh
-	./install.sh PATH_OF_POKEEMERALD_DIRECTORY
+```
+./build.sh
+./install.sh PATH_OF_POKEEMERALD_DIRECTORY
+```
 
 Then in the pokeemerald directory, build the tools.
 
-	./build_tools.sh
+```
+./build_tools.sh
+```
 
 Finally, build the rom.
 
-	make
+```
+make
+```
 
 # Windows
 
@@ -26,3 +32,52 @@ Install [**devkitARM**](http://devkitpro.org/wiki/Getting_Started/devkitARM).
 Then get the compiled tools from https://github.com/pret/pokeruby-tools. Copy the `tools/` folder over the `tools/` folder in your pokeemerald directory.
 
 You can then build pokeemerald using `make` in the MSYS environment provided with devkitARM.
+
+# Mac
+
+Installing pokeemerald on a Mac requires macOS >= 10.12 (Sierra or higher).
+
+To get pokeemerald up and running, run the following commands in Terminal:
+
+Make sure you have the right compilers.
+
+```
+xcode-select --install
+```
+   
+Download a [devkitPRO pacman](https://github.com/devkitPro/pacman/releases/tag/v1.0.0) package (`.pkg`) and install using the native Installer.
+
+This will install the devkitPRO package in `/opt/devkitpro`.
+
+You must install devkitARM using
+
+```
+sudo dkp-pacman -S devkitARM 
+```
+
+Then set environment variables 
+
+```
+export DEVKITPRO=/opt/devkitpro
+echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc
+export DEVKITARM=$DEVKITPRO/devkitARM
+echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc
+```
+
+Now download and install the game's compiler from <https://github.com/pret/agbcc>. You should download and unpack the `.zip` and move the folder to the same folder holding pokeemerald. 
+
+```
+cd /PATH/TO/agbcc/
+./build.sh
+./install.sh /PATH/TO/pokeemerald 
+```
+
+Build the necessary tools
+```
+cd /PATH/TO/pokeemerald
+./build_tools.sh
+```
+And finally the ROM should be ready to build
+```
+make
+```