34 Building for macOS

liamwhite edited this page 2023-03-15 11:59:37 -04:00

Table of Contents

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

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 boost@1.76 ccache ffmpeg fmt glslang hidapi libtool libusb lz4 ninja nlohmann-json openssl pkg-config qt@5 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/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

• TODO: use newer vcpkg. This fixes the boost context library, and allows using the web service
• 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

Home

• Users:
  • Quickstart guide
  • FAQ
  • Overview of Switch Game Formats
  • User Directory
  • yuzu Early Access
  • yuzu Web Service
  • Telemetry
  • Boxcat
  • Recommended GPU Drivers for Linux

• General:
  • Contributing
  • Bounties

---

• Developers:
  • Building yuzu:
    • Windows
    • Linux
    • Android
    • macOS
  • Switch Hardware and Software Documentation
  • Switch Homebrew and Libraries
  • Service Function Usage
  • Contributing
    • Contributor License Agreement
      • Policy
  • Typical Git workflow