RoberixStudios/rpcs3-port-for-ps4

RPCS3 PORT FOR PS4 is a port of RPCS3, the PlayStation 3 emulator, to PlayStation 4 consoles running the GoldHEN homebrew enabler. It is made by Roberix Studio & Mifi Studios.

The emulation core is the original RPCS3 code (upstream commit 9d52b338058bda2d5a9d7cd5e4fbc8148e55a385), cross-compiled for the PS4 with the OpenOrbis PS4 Toolchain. The port adds the console frontend, native adapters for memory, video, audio, controllers, network and USB, and an XMB-style launcher.

This folder holds the complete source code of version 0.39, released under the GNU General Public License version 2 (see LICENSE).

rpcs3-ps4/ and orbis-compat/ must stay side by side: the build finds orbis-compat at rpcs3-ps4/../orbis-compat by default.

• The RPCS3 PPU and SPU LLVM recompilers running on the PS4 itself (LLVM pinned by RPCS3's own submodule), plus SPU ASMJIT and the interpreters.
• Vulkan through the Mesa RADV driver (the original VKGSRender), and OpenGL through Mesa EGL and Zink over RADV (the original GLGSRender).
• Automatic configuration: a PS4 profile and the known fixes of each title are applied when a game starts; after a failure the next start adapts by itself. Per-game settings remain possible.
• Up to 4 players, one DualShock 4 per signed-in PS4 user.
• Online play through RPCN (RPCS3's own server).
• XMB launcher: game list (folders, ISO, PKG), PS3 PKG installation (games, updates, DLC), .rap license import, global and per-game settings, patches and cheats, PS3 discs read from the PS4 drive.
• Return from a game to the XMB without closing the application (L1 + R1 + Triangle for 1 second, or L1 + R1 + Options for 2 seconds).

The user guide (in Portuguese) is rpcs3-ps4/ps4-port/TUTORIAL.txt, and the console test guide is rpcs3-ps4/ps4-port/TESTAR_NO_PS4.txt. Both are also inside the PKG.

• A PS4 or PS4 Pro with GoldHEN (on a PS4 Pro, turn on Boost Mode in the system settings).
• The official PS3 system software (PS3UPDAT.PUP), installed from the XMB (see below).
• Your own PS3 games (disc folder, ISO or PKG). The package contains no games, firmware, keys or licenses.

The PS4's Jaguar CPU is much slower than a PC's: light games run well, heavy ones may have a low frame rate. The first start of each game compiles its code ("Compiling PPU Modules" / "Building SPU Cache") and can take many minutes; later starts use the cache.

1. Copy the .pkg to /data/pkg on the console and install it with GoldHEN (Debug Settings > Package Installer). Installing a newer package keeps the settings and caches.
2. Put PS3UPDAT.PUP on a USB drive (in PS3/UPDATE/ or the root) and use XMB > Settings > Install PS3 firmware. It is installed to /data/rpcs3/dev_flash.
3. Put your games in one of these places:
   • /data/rpcs3/games/NAME (with PS3_GAME/USRDIR/EBOOT.BIN), or an ISO in /data/rpcs3/games;
   • PS3 PKG files in /data/rpcs3/pkgs;
   • on a USB drive: PS3, GAMES, PS3ISO or PKG;
   • .rap licenses in /data/rpcs3/raps (or next to the PKG files);
   • or insert a PS3 disc in the PS4 drive (with GoldHEN's FTP server on) and choose "PS3 disc" ("Disco de PS3" in Portuguese) in the list to install it.
4. Start RPCS3 PORT FOR PS4 from the home screen (title ID RPCS30010).

The build runs on a Windows host and produces the native ELF, the EBOOT and the PKG. In short: OpenOrbis PS4 Toolchain + llvm-mingw, the Mesa PS4 bundle and orbis-porting-kit next to this folder, the dependency scripts in ps4-port/, one CMake/Ninja target (rpcs3_ps4_elf) and ps4-port/package-native.ps1. Every step is in BUILDING.md.

• RPCS3: the whole emulation core, the renderers, the recompilers and the interface icons are the work of the RPCS3 team and its contributors (https://rpcs3.net, https://github.com/RPCS3/rpcs3), licensed under GPL-2.0. This port is distributed under the same license.
• PS4 port: Roberix Studio & Mifi Studios.
• orbis-compat and orbis-porting-kit (orbis-ports, by Mikołaj Mikołajczyk, MIT): the PS4 compatibility runtime and the Vulkan loader the port is built on.
• OpenOrbis PS4 Toolchain: the SDK, the C/C++ runtime and the packaging tools.
• Mesa (RADV, EGL, Gallium/Zink), LLVM, FFmpeg, wolfSSL, curl and the other components listed in THIRD_PARTY_NOTICES.md.
• GoldHEN, which makes homebrew such as this possible on the console.

The port and the RPCS3 code are licensed under the GNU General Public License, version 2 (LICENSE, the same text as rpcs3-ps4/LICENSE). Third-party components keep their own licenses; see THIRD_PARTY_NOTICES.md.

This is an unofficial project. It is not affiliated with, endorsed by or sponsored by Sony Interactive Entertainment or the RPCS3 team. "PlayStation", "PS3" and "PS4" are trademarks of Sony Interactive Entertainment Inc. No games, system software, keys or licenses are included or distributed: use only copies of games you own.