ded6bfbdb3
- uses actions/cache@v4 and hendrikmuhs/ccache-action@v1.2.14 - Keeps the cache from CMake Cache configuration (Windows, Linux, macOS) - Keeps the cache from CMake build objects (only Linux works) ci: remove duplicated cache (Windows/Mac) - Remove "qt" cache from macos.yml ci: remove duplicated cache from macos-qt.yml - Rename step on macos.yml ci: revert cp -R and copy -R commands to mv and move respectively (Windows/macOS) - Will decrease cache file size and speed up a little the build steps ci: update cache name with OS-qt/sdl as a prefix - This will invalidate all the other existing caches ci: use the append-timestamp as false for linux/-qt - Existing ccache caches will invalidate, but will produce once ci: add hashes to the ccache keys - Will invalidate caches once again, but I swear this is the last time |
||
|---|---|---|
| .ci | ||
| .github | ||
| .reuse | ||
| LICENSES | ||
| cmake | ||
| documents | ||
| externals | ||
| scripts | ||
| src | ||
| .gitignore | ||
| .gitmodules | ||
| CMakeLists.txt | ||
| CMakeSettings.json | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| README.md | ||
README.md
shadPS4
General information
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.
Status
[!IMPORTANT] shadPS4 is early in developement, don't expect a flawless experience.
Currently, the emulator successfully runs small games like Sonic Mania, Undertale and it can even somewhat run Bloodborne.
Why
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.
Building
Windows
Check the build instructions for Windows.
Linux
Check the build instructions for Linux.
Building status
Windows
| Windows | Build status |
|---|---|
| Windows SDL Build |  |
| Windows Qt Build |  |
Linux
| Linux | Build status |
|---|---|
| Linux SDL Build |  |
| Linux Qt Build |  |
macOS
| macOS | Build status |
|---|---|
| macOS SDL Build |  |
| macOS Qt Build |  |
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 mapping
[!NOTE] Xbox and DualShock controllers work out of the box.
| Controller button | Keyboard equivelant |
|---|---|
| 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 |
| CIRCLE | Numpad 6 |
| CROSS | Numpad 2 |
| SQUARE | Numpad 4 |
| PAD UP | UP |
| PAD DOWN | DOWN |
| PAD LEFT | LEFT |
| PAD RIGHT | RIGHT |
| OPTIONS | RETURN |
| TOUCH PAD | SPACE |
| L1 | Q |
| R1 | U |
| L2 | E |
| R2 | O |
| L3 | X |
| R3 | M |
Main team
Logo is done by Xphalnos
Contributing
If you want to contribute, please look the CONTRIBUTING.md file.
Open a PR and we'll check it :)
Contributors
Sister Projects
- Panda3DS: A multiplatform 3DS emulator from our co-author wheremyfoodat.
- hydra: A multisystem, multiplatform emulator (chip-8, GB, NES, N64) from Paris.