Building for macOS | Citra | Nintendo 3DS Emulator
Read First!

The below wiki article is based on user submitted content.
Please verify all hyperlinks and terminal commands below!

See a mistake? Want to contribute? Edit this article on Github

Building for macOS

Dependencies:

It’s recommended that you use homebrew to install dependencies. You’ll need to download and install the following to build Citra:

  • pkg-config (brew install pkgconfig)
  • SDL2 (brew install sdl2, or download this dmg)
  • Qt5 (brew install qt5) (Note: If you have Qt4 installed, then you will need to remove it before building. brew unlink qt4)
  • CMake (brew install cmake)
  • A recent version of Xcode and the Xcode command line tools

Cloning Citra in Git:

git clone --recursive https://github.com/citra-emu/citra
cd citra

Using CMake:

First of all, you have to tell CMake where your Qt5 is installed (add this line to ~/.profile if you want to make this permanent.):

export Qt5_DIR=$(brew --prefix)/opt/qt5

Now you can generate project files for the build:

export MACOSX_DEPLOYMENT_TARGET=10.9
mkdir build
cd build
cmake .. -GXcode

Optionally, you can use cmake -i .. -GXcode or ccmake .. -GXcode to adjust various options (e.g. disable Qt GUI).

Building with debug symbols:

cmake .. -GXcode -DCMAKE_BUILD_TYPE=Debug

Building Citra:

Open the project file in Xcode, switch the target from ALL_BUILD to citra or citra_qt, and press the play button. The project can also be built via:

xcodebuild -config Release -project citra.xcodeproj -target citra-qt