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
Please note this article is intended for development, and yuzu on macOS is not currently ready for regular use.
This article was written for developers. yuzu support for macOS is not ready for casual use.
Install dependencies from Homebrew:
brew install autoconf automake [email protected] ccache ffmpeg fmt glslang hidapi libtool libusb lz4 ninja nlohmann-json openssl [email protected] sdl2 speexdsp zlib zlib zstd
Build with debug symbols (vcpkg is not currently used due to broken boost-context library):
mkdir build && cd build
export Qt5_DIR="/opt/homebrew/opt/[email protected]/lib/cmake"
cmake .. -GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DYUZU_USE_BUNDLED_VCPKG=OFF -DYUZU_TESTS=OFF
ninja
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