wiki/install-guide.md
Darkhost1999 0bb6f40a30 Update the Wiki with PS5 changes
DH made a new WSL script today for ease of installation to help Windows people with getting started. So I incorporated that script into the install guide and decided to run through every file and cleanup what I could see was notably functional but could be improved wording, URLs, and more.
PlayStation 5 support was added to RPCSX and there is a lot more working than just 2 titles at this time. Many games are seeing title screens and commands are overdue on simplification for booting content.
2024-11-23 14:20:44 -06:00

2.4 KiB

layout title order permalink description
libdoc/page Installation 2 /installation/ For the foreseeable future, installation will require Linux in some form.
  • TOC {:toc}

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)