Installing RGBDS on macOS

Using the Homebrew package manager

On recent macOS major releases¹, RGBDS is available on Homebrew as the rgbds package.

brew install rgbds

Then you will be able to update RGBDS at any time by simply running brew update then brew upgrade!

You can also install the master branch by passing the --HEAD flag:

brew install rgbds --HEAD

Using our pre-built binaries

1. Download the latest release of rgbds-macos.zip. (Or pick a specific version and download it under "Assets" at the bottom.)

2. Extract the downloaded rgbds-macos.zip file into a new directory, and run install.sh as root inside that directory. For example, you can do that with these Console commands:

   % unzip -d rgbds rgbds-macos.zip
   % cd rgbds
   % sudo ./install.sh

3. Check that RGBDS was correctly installed by running rgbasm -V. It should print out the version number you installed!

---

If none of these options are suitable to you, build RGBDS from source.

Footnotes

1. Older macOS systems have been reported to compile for several days with Homebrew. ↩