Files
archived-shadps4-qtlauncher/documents/building-macos.md
DanielSvoboda 7bed6653f1 Fix links and update documentation files (#217)
* Update README links for qtlauncher

* Update build instructions for shadPS4QtLauncher

* Update debugging instructions for shadPS4QtLauncher

* Update macOS build instructions for shadPS4QtLauncher

* Update documentation for shadPS4QtLauncher build
2025-12-09 18:31:01 +02:00

1.9 KiB

Build shadPS4QtLauncher for macOS

Install the necessary tools to build shadPS4QtLauncher:

First, make sure you have Xcode 16.0 or newer installed.

For installing other tools and library dependencies we will be using Homebrew.

On an ARM system, we will need the native ARM Homebrew to install tools and x86_64 Homebrew to install libraries.

First, install native Homebrew and tools:

# Installs native Homebrew to /opt/homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Adds Homebrew to your path
echo 'eval $(/opt/homebrew/bin/brew shellenv)' >> ~/.zprofile
eval $(/opt/homebrew/bin/brew shellenv)
# Installs tools.
brew install clang-format cmake

Next, install x86_64 Qt. You can skip these steps and move on to Cloning and compiling if you do not intend to build the Qt GUI.

If you are on an ARM Mac:

# Installs x86_64 Homebrew to /usr/local
arch -x86_64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Installs libraries.
arch -x86_64 /usr/local/bin/brew install qt@6

If you are on an x86_64 Mac:

brew install qt@6

Cloning and compiling:

Clone the repository recursively:

git clone --recursive https://github.com/shadps4-emu/shadPS4QtLauncher.git
cd shadPS4QtLauncher

Generate the build directory in the shadPS4QtLauncher directory:

cmake -S . -B build/ -DCMAKE_OSX_ARCHITECTURES=x86_64

If you want to build the Qt GUI, add -DENABLE_QT_GUI=ON to the end of this command as well.

Enter the directory:

cd build/

Use make to build the project:

cmake --build . --parallel$(sysctl -n hw.ncpu)

Now run the emulator:

./shadps4 /"PATH"/"TO"/"GAME"/"FOLDER"/eboot.bin