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

MacOS is no longer supported due to Apple deprecating OpenGL and their current version not supporting the OpenGL extensions we require.


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

  • pkg-config - brew install pkgconfig
  • SDL2 - brew install sdl2
  • Qt5 - brew install qt5
    • 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 yuzu with Git


  git clone --recursive
  cd yuzu
  git submodule update --init --recursive

Mainline (no assert):

  git clone --recursive
  cd yuzu-mainline
  git submodule update --init --recursive

Using CMake

First of all, you have to tell CMake where 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 makefiles for the build:

  mkdir build
  cd build
  cmake .. -DCMAKE_BUILD_TYPE=Release

Building yuzu

make -j4

A application bundle will now be present under build/bin/. Note that this is non-portable and only works on your machine.

For portability of the appbundle between machines please refer to this script.