Go to file
SaynedBread 41a93dcae4
docs: Added some fancy Markdown formating to the README
2024-08-25 02:54:46 +02:00
.ci video_core: prefer discrete gpu if available (#116) 2024-04-30 00:19:12 +03:00
.github Misc changes 2024-08-18 17:56:29 +02:00
.reuse Adding icons to categories (#479) 2024-08-19 18:42:23 +03:00
LICENSES reuse: fix license for externals (#358) 2024-08-02 15:57:16 +03:00
cmake cmake: prefer system renderdoc library (#452) 2024-08-16 19:49:32 +03:00
documents Lot of small fixes 2024-08-22 18:01:30 +02:00
externals Lot of small fixes 2024-08-22 18:01:30 +02:00
scripts reuse fix (again) 2024-05-12 19:13:37 +03:00
src video_core: Bloodborne stabilization pt1 (#543) 2024-08-24 22:51:47 +03:00
.gitignore print git info in windows title 2024-08-01 00:56:10 +03:00
.gitmodules Lot of small fixes 2024-08-22 18:01:30 +02:00
CMakeLists.txt cmake: fix version constraints 2024-08-23 19:40:11 +02:00
CMakeSettings.json Separation between release mode and RelWithDebInfo (#186) 2024-06-10 22:59:28 +03:00
CONTRIBUTING.md Fix typo in CONTRIBUTING.md comment 2024-08-23 18:29:00 -07:00
LICENSE Initial commit 2022-10-24 12:48:38 +03:00
README.md docs: Added some fancy Markdown formating to the README 2024-08-25 02:54:46 +02:00

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, Dysmantle, and a few others. Most importantly shadPS4 can 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-sdl
Windows Qt Build Windows-qt
Linux
Linux Build status
Linux SDL Build Linux-sdl
Linux Qt Build Linux-qt
macOS
macOS Build status
macOS SDL Build macOS-sdl
macOS Qt Build macOS-qt

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] Keyboard mappings can be changed from the Qt interface of shadPS4. 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.

License