Installation

For the foreseeable future, installation will require Linux in some form.

Update

Third party dependencies have been merged into the source tree as submodules! If you previously installed RPCSX when you needed spirv-cross, gslang, or xbyak, you should run:

git pull
git submodule update --recursive --remote

Install

We provide two installation methods:

Method 1: Linux

Install dependencies

  • .deb-based (Ubuntu etc.) Note: git is only needed for Ubuntu 22.04
sudo apt install build-essential cmake libunwind-dev libglfw3-dev libvulkan-dev vulkan-validationlayers-dev libsox-dev git libasound2-dev nasm g++-14

go to Continued Install.

  • .rpm-based (Fedora etc.)
sudo dnf install cmake libunwind-devel glfw-devel vulkan-devel vulkan-validation-layers-devel gcc-c++ gcc sox-devel alsa-lib-devel nasm

go to Continued Install.

  • Arch vulkan-devel is a group, and you should install all!
sudo pacman -S --needed libunwind glfw-x11 vulkan-devel sox git cmake alsa-lib nasm

go to Continued Install.

Continued Install

  1. Clone the repo.

     git clone --recursive https://github.com/RPCSX/rpcsx && cd rpcsx
     git submodule update --init --recursive
    
  2. Compile the emulator.

     cmake -B build && cmake --build build -j$(nproc)
    

Method 2: WSL

Install WSL Run Windows Powershell as Administrator:

wsl --install

Reboot your machine

Install Ubuntu: Run Windows Powershell

wsl --install -d Ubuntu

Setup user credentials

Download and install RPCSX:

  wget -O - https://raw.githubusercontent.com/DHrpcs3/rpcsx-setup-wsl/refs/heads/main/rpcsx-setup-wsl.sh | bash
  • This script will shutdown your Ubuntu distro when complete, This will not turn off your PC only the virtual environment

After the script has completed succesfully relaunch ubuntu through Windows Powershell

  wsl

Validate RPCSX installed

  rpcsx --version

You are now free to continue onto the Running RPCSX Guide

To update RPCSX for WSL in the future you may use this command

  rpcsx-update

ArchWSL

TODO (under development)