rpcs3/BUILDING.md

Building

Only Windows and Linux are officially supported for building. However, various other platforms are capable of building RPCS3. Other instructions may be found here.

Setup your environment

Windows 10 or later

• CMake 3.28.0+ (add to PATH)
• Python 3.6+ (add to PATH)
• Qt 6.7.3
• Visual Studio 2022 (or at least Visual Studio 2019 16.11.xx+ as C++20 is not included in previous versions)
• Vulkan SDK 1.3.268.0 (See "Install the SDK" here) for now future SDKs don't work. You need precisely 1.3.268.0.

Either add the QTDIR environment variable, e.g. <QtInstallFolder>\6.7.3\msvc2019_64\ , or use the Visual Studio Qt Plugin

NOTE: If you have issues with the Qt plugin, you may want to uninstall the Qt Plugin and install the Legacy Qt Plugin instead.

Linux

These are the essentials tools to build RPCS3 on Linux. Some of them can be installed through your favorite package manager.

• Clang 17+ or GCC 13+
• CMake 3.28.0+
• Qt 6.7.3
• Vulkan SDK 1.3.268.0 (See "Install the SDK" here) for now future SDKs don't work. You need precisely 1.3.268.0.
• SDL2 (for the FAudio backend)

If you have an NVIDIA GPU, you may need to install the libglvnd package.

Arch Linux

sudo pacman -S glew openal cmake vulkan-validation-layers qt6-base qt6-declarative qt6-multimedia qt6-svg sdl2 sndio jack2 base-devel

Debian & Ubuntu

sudo apt-get install build-essential libasound2-dev libpulse-dev libopenal-dev libglew-dev zlib1g-dev libedit-dev libvulkan-dev libudev-dev git libevdev-dev libsdl2-2.0 libsdl2-dev libjack-dev libsndio-dev

Ubuntu is usually horrendously out of date, and some packages need to be downloaded by hand. This part is for Qt, GCC, Vulkan, and CMake

Qt PPA

Ubuntu usually does not have a new enough Qt package to suit rpcs3's needs. There is currently no PPA available to work around this.

GCC 13.x installation

If the gcc-13 package is not available on your system, use the following commands

sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt-get update
sudo apt-get install gcc-13 g++-13

You can either use update-alternatives to setup gcc-13/g++-13 as your default compilers or prefix any cmake command by CXX=g++-13 CC=gcc-13 to use it.

Vulkan SDK

For Ubuntu systems, it is strongly recommended to use the PPA from LunarG which will provide a compatible Vulkan SDK to compile RPCS3. If your Vulkan SDK is older, it can lead to compilation errors.

. /etc/os-release
wget -qO - https://packages.lunarg.com/lunarg-signing-key-pub.asc | sudo apt-key add -
sudo wget -qO /etc/apt/sources.list.d/lunarg-vulkan-1.3.268-$UBUNTU_CODENAME.list https://packages.lunarg.com/vulkan/1.3.268/lunarg-vulkan-1.3.268-$UBUNTU_CODENAME.list
sudo apt update
sudo apt install vulkan-sdk

CMake

. /etc/os-release
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | sudo apt-key add -
sudo apt-add-repository "deb https://apt.kitware.com/ubuntu/ $UBUNTU_CODENAME main"
sudo apt-get update
sudo apt-get install kitware-archive-keyring
sudo apt-key --keyring /etc/apt/trusted.gpg del C1F34CDD40CD72DA
sudo apt-get install cmake

Fedora

sudo dnf install alsa-lib-devel cmake glew glew-devel libatomic libevdev-devel libudev-devel openal-devel qt6-qtbase-devel qt6-qtbase-private-devel vulkan-devel pipewire-jack-audio-connection-kit-devel qt6-qtmultimedia-devel qt6-qtsvg-devel

OpenSUSE

sudo zypper install git cmake libasound2 libpulse-devel openal-soft-devel glew-devel zlib-devel libedit-devel vulkan-devel libudev-devel libqt6-qtbase-devel libqt6-qtmultimedia-devel libqt6-qtsvg-devel libQt6Gui-private-headers-devel libevdev-devel libsndio7_1 libjack-devel

Setup the project

Clone and initialize the repository

git clone https://github.com/RPCS3/rpcs3.git
cd rpcs3
git submodule update --init

Windows

Configuring the Qt plugin (if used)

1. Go to Extensions->Qt VS Tools->Qt Versions.
2. Add the path to your Qt installation with compiler e.g. <QtInstallFolder>\6.7.3\msvc2019_64, version will fill in automatically.
3. Go to Extensions->Qt VS Tools->Options->Legacy Project Format. (Only available in the legacy Qt plugin)
4. Set Build: Run pre-build setup to true. (Only available in the legacy Qt plugin)

Building the projects

Open rpcs3.sln. The recommended build configuration is Release. (On older revisions: Release - LLVM)

You may want to download the precompiled LLVM libs and extract them to 3rdparty\llvm\, as well as download and extract the additional libs to lib\%CONFIGURATION%-x64\ to speed up compilation time (unoptimised/debug libs are currently not available precompiled).

If you're not using the precompiled libs, build the following projects in __BUILD_BEFORE folder by right-clicking on a project > Build.:

• glslang
• Either llvm_build or llvm_build_clang_cl
• spirv

Afterwards:

Build > Build Solution

Linux

While still in the project root:

1. cd .. && mkdir --parents rpcs3_build && cd rpcs3_build
2. cmake ../rpcs3/ && make or CXX=g++-13 CC=gcc-13 cmake ../rpcs3/ && make to force these compilers
3. Run RPCS3 with ./bin/rpcs3

When using GDB, configure it to ignore SIGSEGV signal (handle SIGSEGV nostop noprint). If desired, use the various build options in CMakeLists.