shadps4-emu / shadPS4

shadPS4 
| Bloodborne by From Software | Hatsune Miku Project DIVA Future Tone by SEGA |
| :-----------------------------------------------------------: | :--------------------------------------------------------------------------------------------: |
| | |
| Yakuza 0 by SEGA | DRIVECLUB™ by Evolution Studios |
| :------------------------------------------------------------------------: | :------------------------------------------------------------------: |
| | |
# General information
**shadPS4** is an early **PlayStation 4** emulator for **Windows**, **Linux** and **macOS** written in C++.
> [!IMPORTANT]
> This is the emulator core, which does not include a GUI. If you just want to use the emulator as an end user, download the **QtLauncher** instead.
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**.\
You can donate to the project via our **Kofi page**.
# Status
> [!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.
# Why
This project began for fun. 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.
# Building
## Docker
For building shadPS4 in a containerized environment using Docker and VSCode, check the instructions here: 
**Docker Build Instructions**
## Windows
Check the build instructions for **Windows**.
## Linux
Check the build instructions for **Linux**.
## macOS
Check the build instructions for **macOS**.
> [!IMPORTANT]
> macOS users need at least macOS 26.0 to run shadPS4. Intel Macs are not supported.
# Usage examples
> [!IMPORTANT]
> For a user-friendly GUI, download the **QtLauncher**.
To get the list of all available commands and also a more detailed description of what each command does, please refer to the `--help` flag's output.
Below is a list of commonly used command patterns:
 [code] 
# Debugging and reporting issues
For more information on how to test, debug and report issues with the emulator or games, read the **Debugging documentation**.
# Keyboard and Mouse Mappings
> [!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 (or game-only screenshot if RenderDoc is unavailable)
Alt+F12 | Capture screenshot including HUD/dialog overlays
> [!NOTE]
> Xbox and