2

Building-for-macOS

Maufeat edited this page 2025-06-22 02:25:45 +00:00

Table of Contents

• Method I: ninja
• Method II: Xcode

Please note this article is intended for development, and eden on macOS is not currently ready for regular use.

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

Method I: ninja

---

If you are compiling on Intel Mac or are using a Rosetta Homebrew installation, you must replace all references of /opt/homebrew to /usr/local.

Install dependencies from Homebrew:

brew install autoconf automake boost ccache ffmpeg fmt glslang hidapi libtool libusb lz4 ninja nlohmann-json openssl pkg-config qt@6 sdl2 speexdsp zlib zlib zstd cmake Catch2 molten-vk vulkan-loader

Clone the repo

git clone --recursive https://git.eden-emu.dev/eden-emu/eden

cd eden

Build for release

mkdir build && cd build

export Qt6_DIR="/opt/homebrew/opt/qt@6/lib/cmake"

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

cmake .. -GNinja -DCMAKE_BUILD_TYPE=RelWithDebInfo -DYUZU_USE_BUNDLED_VCPKG=OFF -DYUZU_TESTS=OFF -DENABLE_WEB_SERVICE=ON -DENABLE_LIBUSB=OFF -DCLANG_FORMAT=ON -DSDL2_DISABLE_INSTALL=ON -DSDL_ALTIVEC=ON

ninja

You may also want to include support for Discord Rich Presence by adding -DUSE_DISCORD_PRESENCE=ON after cmake ..

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

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

Run the output:

bin/eden.app/Contents/MacOS/eden

Method II: Xcode

---

If you are compiling on Intel Mac or are using a Rosetta Homebrew installation, you must replace all references of /opt/homebrew to /usr/local.

Install dependencies from Homebrew:

brew install autoconf automake boost ccache ffmpeg fmt glslang hidapi libtool libusb lz4 ninja nlohmann-json openssl pkg-config qt@6 sdl2 speexdsp zlib zlib zstd cmake Catch2 molten-vk vulkan-loader

Clone the repo

git clone --recursive https://git.eden-emu.dev/eden-emu/eden

cd eden

Build for release

mkdir build && cd build

export Qt6_DIR="/opt/homebrew/opt/qt@6/lib/cmake"

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

cmake .. -GXcode -DCMAKE_BUILD_TYPE=RelWithDebInfo -DYUZU_USE_BUNDLED_VCPKG=OFF -DYUZU_TESTS=OFF -DENABLE_WEB_SERVICE=ON -DENABLE_LIBUSB=OFF -DCLANG_FORMAT=ON -DSDL2_DISABLE_INSTALL=ON -DSDL_ALTIVEC=ON

xcodebuild build -project eden.xcodeproj -scheme "eden" -configuration "RelWithDebInfo"

You may also want to include support for Discord Rich Presence by adding -DUSE_DISCORD_PRESENCE=ON after cmake ..

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

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

Run the output:

bin/eden.app/Contents/MacOS/eden

---

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/eden.app/Contents/MacOS/eden