Discord server for talking about forks. https://discord.gg/jgpqB7gUxG
This repository has three branches with extra features based on the main Shad branch. They are experimental or self-added for convenience. They all share the following Bloodborne-specific enhancements:
NOTE: BBFORK IS THE ONLY ONE THAT I WILL UPDATE FROM NOW ON, ALSO IT WILL HAVE ALL THE FEATURES INTO EXPERIMENTAL TAB.
-A sound hack that prevents Bloodborne from losing audio. (originally made by rainvmaker)
-Automatic backups via a checkbox in the Graphics tab in Settings.
-A PM4 Type 0 hack to avoid related issues. (Do not use this with the "Copy Buffer" checkbox under the Debug tab in Settings.)
-An RCAS bar in Settings to adjust FSR sharpness.
-Restart and Stop buttons working (currently both do the same thing – close the current game and restart the emulator).
-Keyboard and mouse custom button mapping for FromSoftware games.
-An Experimental tab with all new features and both isDevKit and Neo Mode (PS4 Pro Mode) checkboxes in Settings.
-Safe Tiling and USB PRs that I developed for main Shad.
This repository has three branches with extra features based on the main Shad branch. They are experimental or self-added for convenience. They all share the following Bloodborne-specific enhancements:
-Extra SFX particles shown (snow, sparks, etc.), originally from the roamic PR – further stabilized with the adjonese hack and rewritten by me to work with the current main Shad implementations.
-A sound hack that prevents Bloodborne from losing audio. (originally made by rainvmaker)
-Automatic backups via a checkbox in the Graphics tab in Settings.
-A PM4 Type 0 hack to avoid related issues. (Do not use this with the "Copy Buffer" checkbox under the Debug tab in Settings.)
-An RCAS bar in Settings to adjust FSR sharpness.
-Restart and Stop buttons working (currently both do the same thing – close the current game and restart the emulator).
-Keyboard and mouse custom button mapping for FromSoftware games.
-An Experimental tab with both isDevKit and Neo Mode (PS4 Pro Mode) checkboxes in Settings.
-Safe Tiling and USB PRs that I developed for main Shad.
PRTBB This is the safest branch at the moment. It doesn’t include any extra features.
BBFork (previously known as mainBB) -Includes a high-resolution hack (thanks to fmod) with adjonesse hack to stabilize it and modified by me to avoid crashing other games. -Note: May impact performance on mid- or low-end systems.
Full-Souls -Includes the AV improvements PR to prevent Dark Souls 2’s main intro from crashing.
-Includes a faster readbacks PR by me. Note: This can cause minor stutters in heavy areas when loading first time.
shadPS4 is an early PlayStation 4 emulator for Windows, Linux and macOS written in C++.
If you encounter problems or have doubts, do not hesitate to look at the Quickstart.
To verify that a game works, you can look at shadPS4 Game Compatibility.
To discuss shadPS4 development, suggest ideas or to ask for help, join our Discord server.
To get the latest news, go to our X (Twitter) or our website.
For those who'd like to donate to the project, we now have a Kofi page!
Important
shadPS4 is early in development, don't expect a flawless experience.
Currently, the emulator can successfully run games like Bloodborne, Dark Souls Remastered, Red Dead Redemption and many other games.
This project began as a fun project. Given our limited free time, it may take some time before shadPS4 can run more complex games, but we're committed to making small, regular updates.
Important
If you want to use shadPS4 to play your games, you don't have to follow the build instructions, you can simply download the emulator from either the release tab or the action tab.
Check the build instructions for Windows.
Check the build instructions for Linux.
Check the build instructions for macOS.
Important
macOS users need at least macOS 15.4 to run shadPS4. Due to GPU issues there are currently heavy bugs on Intel Macs.
For more information on how to test, debug and report issues with the emulator or games, read the Debugging documentation.
Note
Some keyboards may also require you to hold the Fn key to use the F* keys. Mac users should use the Command key instead of Control, and need to use Command+F11 for full screen to avoid conflicting with system key bindings.
| Button | Function |
|---|---|
| F10 | FPS Counter |
| Ctrl+F10 | Video Debug Info |
| F11 | Fullscreen |
| F12 | Trigger RenderDoc Capture |
Note
Xbox and DualShock controllers work out of the box.
| Controller button | Keyboard equivalent |
|---|---|
| LEFT AXIS UP | W |
| LEFT AXIS DOWN | S |
| LEFT AXIS LEFT | A |
| LEFT AXIS RIGHT | D |
| RIGHT AXIS UP | I |
| RIGHT AXIS DOWN | K |
| RIGHT AXIS LEFT | J |
| RIGHT AXIS RIGHT | L |
| TRIANGLE | Numpad 8 or C |
| CIRCLE | Numpad 6 or B |
| CROSS | Numpad 2 or N |
| SQUARE | Numpad 4 or V |
| PAD UP | UP |
| PAD DOWN | DOWN |
| PAD LEFT | LEFT |
| PAD RIGHT | RIGHT |
| OPTIONS | RETURN |
| BACK BUTTON / TOUCH PAD | SPACE |
| L1 | Q |
| R1 | U |
| L2 | E |
| R2 | O |
| L3 | X |
| R3 | M |
Keyboard and mouse inputs can be customized in the settings menu by clicking the Controller button, and further details and help on controls are also found there. Custom bindings are saved per-game. Inputs support up to three keys per binding, mouse buttons, mouse movement mapped to joystick input, and more.
shadPS4 can load some PlayStation 4 firmware files, these must be dumped from your legally owned PlayStation 4 console.
The following firmware modules are supported and must be placed in shadPS4's sys_modules folder.
| Modules | Modules | Modules | Modules |
|---|---|---|---|
| libSceCesCs.sprx | libSceFont.sprx | libSceFontFt.sprx | libSceFreeTypeOt.sprx |
| libSceJson.sprx | libSceJson2.sprx | libSceLibcInternal.sprx | libSceNgs2.sprx |
| libSceUlt.sprx |
Caution
The above modules are required to run the games properly and must be extracted from your PlayStation 4.
Logo is done by Xphalnos
If you want to contribute, please read the CONTRIBUTING.md file.
Open a PR and we'll check it :)
If you want to translate shadPS4 to your language we use Crowdin.
A few noteworthy teams/projects who've helped us along the way are:
-
Panda3DS: A multiplatform 3DS emulator from our co-author wheremyfoodat. They have been incredibly helpful in understanding and solving problems that came up from natively executing the x64 code of PS4 binaries
-
fpPS4: The fpPS4 team has assisted massively with understanding some of the more complex parts of the PS4 operating system and libraries, by helping with reverse engineering work and research.
-
yuzu: Our shader compiler has been designed with yuzu's Hades compiler as a blueprint. This allowed us to focus on the challenges of emulating a modern AMD GPU while having a high-quality optimizing shader compiler implementation as a base.
-
felix86: A new x86-64 → RISC-V Linux userspace emulator