lavavex / rpcs3-PS5

# rpcs3-PS5
> [!CAUTION]
> **EXPERIMENTAL. EXPECT CRASHES, FREEZES AND BROKEN GAMES.**
>
> This is an early, unofficial port, tested on a single console with a handful of games.
> It is **not** supported by the RPCS3 team: do not report problems with it to them.
>
> - Most games are untested; many will crash back to the PS5 home screen or freeze.
> - It runs as a homebrew title on a jailbroken console. Jailbreaks, payloads and
> unsigned titles carry their own risks; you use all of this **at your own risk**.
> - Back up anything on `/data/rpcs3/` (saves, settings) that you care about.
> [!WARNING]
> **Source only, personal use only.** Never share built `eboot.bin`/title folders,
> firmware, keys or games. The licenses involved forbid it (below).
Build scripts for running RPCS3 (the PlayStation 3 emulator) as a
native title on a jailbroken PS5. RPCS3 renders through Vulkan on
PS5_Vulkan's RADV port, plays audio through
SceAudioOut and reads DualSense controllers through ScePad. The frontend is RPCS3's own
Big Picture Mode.
**Source only.** This repository holds no binaries, firmware, keys or games, and builds
from it must not be redistributed. RPCS3 is GPL-2.0-only, and PS5_Vulkan and
PS5_PayloadSDK are GPL-3.0: the combined title cannot be shared under either license.
Build it yourself, for your own console.
Tested on a PS5 Pro, firmware 13.60, with the Relapse jailbreak, etaHEN, ftpsrv and
ShadowMount+. Need for Speed Carbon (BLUS30016) is fully playable.
## Screenshots
Captured over Remote Play on a PS5 Pro (Need for Speed Carbon, BLUS30016).
| | |
| --- | --- |
| | |
| | |
## What you need
- An Arch/CachyOS host (others work if you install the equivalents):
 [code] 
- About 20 GB of disk space. A first build takes about 10 minutes on a 16-core
 desktop (LLVM and RADV are the slow parts); expect longer on smaller machines.
- On the console: an FTP server on port 2121 (ftpsrv) and ShadowMount+ to register the
 title.
- Your own PS3 firmware (`PS3UPDAT.PUP` from playstation.com) and your own game dumps.
## Building
 [code] 
`bootstrap.sh` runs these steps in order; each one skips work it has already done, so
re-run it after fixing a failure:
| Step | Script | Output |
| --- | --- | --- |
| Pinned sources | `tools/fetch-deps.sh` | `deps/PS5_*`, RPCS3's submodules |
| PS5 payload SDK fork | `tools/install-sdk.sh` | `deps/sdk-rpcs3` |
| RADV driver, ps5-native-tool, libc.prx | `tools/build-driver-chain.sh` | `deps/PS5_Vulkan/.deps/native/radv-release` |
| LLVM for the recompilers | `tools/build-llvm.sh` | `deps/llvm-ps5` |
| zlib, libiconv, FFmpeg | `tools/build-{zlib,libiconv,ffmpeg}.sh` | `deps/*-ps5` |
| Per-game settings database | `tools/update-config-database.sh` | `deps/config_database.json` |
| RPCS3 | `tools/build-rpcs3.sh` | `dist/PPSA99300` |
After changing RPCS3's code, rebuild with `ninja -C build/rpcs3-ps5 rpcs3_ps5`.
## Installing
Close RPCS3 on the console first (a running title's files cannot be replaced), then:
 [code] 
This upload