Building Yuzu For macOS

Please note this article is intended for development/archival and preservation reasons, and yuzu on macOS was never released.

This article was written for developers. yuzu support for macOS is not ready for casual use and never was.

Install dependencies from Homebrew:

Command: brew install autoconf automake [email protected] ccache ffmpeg fmt glslang hidapi libtool libusb lz4 ninja nlohmann-json openssl pkg-config qt@5 sdl2 speexdsp zlib zlib zst

Build with debug symbols (vcpkg is not currently used due to a broken boost-context library), the command is:

mkdir build && cd build
export Qt5_DIR=”/opt/homebrew/opt/qt@5/lib/cmake”
cmake .. -GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DYUZU_USE_BUNDLED_VCPKG=OFF -DYUZU_TESTS=OFF -DENABLE_WEB_SERVICE=OFF -DENABLE_LIBUSB=OFF
ninja

1: TODO: use newer vcpkg. This fixes the boost context library and allows using the web service

2: TODO: figure out what’s up with libusb

Run the output:

bin/yuzu.app/Contents/MacOS/yuzu

To run with MoltenVK, install additional dependencies:

brew install molten-vk vulkan-loader

Run with Vulkan loader path:

export LIBVULKAN_PATH=/opt/homebrew/lib/libvulkan.dylib

bin/yuzu.app/Contents/MacOS/yuzu

Scroll to Top