{"id":13957312,"url":"https://github.com/shadps4-emu/shadPS4","last_synced_at":"2025-07-20T23:30:51.761Z","repository":{"id":63362209,"uuid":"556675672","full_name":"shadps4-emu/shadPS4","owner":"shadps4-emu","description":"PlayStation 4 emulator for Windows, Linux and macOS written in C++","archived":false,"fork":false,"pushed_at":"2025-07-18T10:14:41.000Z","size":42291,"stargazers_count":23077,"open_issues_count":120,"forks_count":1467,"subscribers_count":165,"default_branch":"main","last_synced_at":"2025-07-18T12:30:34.571Z","etag":null,"topics":["cpp","cpp20","emulation","emulator","imgui","linux","macos","playstation4","ps4","sdl3","vulkan","windows"],"latest_commit_sha":null,"homepage":"https://shadps4.net/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shadps4-emu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"ko_fi":"shadps4"}},"created_at":"2022-10-24T09:48:37.000Z","updated_at":"2025-07-18T11:51:28.000Z","dependencies_parsed_at":"2023-10-02T18:59:05.367Z","dependency_job_id":"4b74d15c-b99a-4358-aca5-65a377f5f431","html_url":"https://github.com/shadps4-emu/shadPS4","commit_stats":{"total_commits":2129,"total_committers":129,"mean_commits":"16.503875968992247","dds":0.6787224048849225,"last_synced_commit":"5810c88c00390026ecc33a4244190843afe19b94"},"previous_names":["shadps4-emu/shadps4"],"tags_count":109,"template":false,"template_full_name":null,"purl":"pkg:github/shadps4-emu/shadPS4","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadps4-emu%2FshadPS4","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadps4-emu%2FshadPS4/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadps4-emu%2FshadPS4/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadps4-emu%2FshadPS4/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shadps4-emu","download_url":"https://codeload.github.com/shadps4-emu/shadPS4/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shadps4-emu%2FshadPS4/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266214638,"owners_count":23893927,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpp","cpp20","emulation","emulator","imgui","linux","macos","playstation4","ps4","sdl3","vulkan","windows"],"created_at":"2024-08-08T13:00:37.865Z","updated_at":"2025-07-20T23:30:51.755Z","avatar_url":"https://github.com/shadps4-emu.png","language":"C++","funding_links":["https://ko-fi.com/shadps4","https://ko-fi.com/shadps4)!"],"categories":["C++","cpp","Emulation","Tool","🌐 Web Development - Frontend"],"sub_categories":["Virtual Machine Tool"],"readme":"\u003c!--\nSPDX-FileCopyrightText: 2024 shadPS4 Emulator Project\nSPDX-License-Identifier: GPL-2.0-or-later\n--\u003e\n\n\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n  \u003ca href=\"https://shadps4.net/\"\u003e\u003cimg src=\"https://github.com/shadps4-emu/shadPS4/blob/main/.github/shadps4.png\" width=\"220\"\u003e\u003c/a\u003e\n  \u003cbr\u003e\n  \u003cb\u003eshadPS4\u003c/b\u003e\n  \u003cbr\u003e\n\u003c/h1\u003e\n\n\u003ch1 align=\"center\"\u003e\n \u003ca href=\"https://discord.gg/bFJxfftGW6\"\u003e\n        \u003cimg src=\"https://img.shields.io/discord/1080089157554155590?color=5865F2\u0026label=shadPS4%20Discord\u0026logo=Discord\u0026logoColor=white\" width=\"275\"\u003e\n \u003ca href=\"https://github.com/shadps4-emu/shadPS4/releases/latest\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/downloads/shadps4-emu/shadPS4/total.svg\" width=\"140\"\u003e\n \u003ca href=\"https://shadps4.net/\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/shadPS4-website-8A2BE2\" width=\"150\"\u003e\n \u003ca href=\"https://x.com/shadps4\"\u003e\n        \u003cimg src=\"https://img.shields.io/badge/-Join%20us-black?logo=X\u0026logoColor=white\" width=\"100\"\u003e\n \u003ca href=\"https://github.com/shadps4-emu/shadPS4/stargazers\"\u003e\n        \u003cimg src=\"https://img.shields.io/github/stars/shadps4-emu/shadPS4\" width=\"120\"\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://shadps4.net/\"\u003e\n  \u003cimg src=\"https://github.com/shadps4-emu/shadPS4/blob/main/documents/Screenshots/1.png\" width=\"400\"\u003e\n  \u003cimg src=\"https://github.com/shadps4-emu/shadPS4/blob/main/documents/Screenshots/2.png\" width=\"400\"\u003e\n  \u003cimg src=\"https://github.com/shadps4-emu/shadPS4/blob/main/documents/Screenshots/3.png\" width=\"400\"\u003e\n  \u003cimg src=\"https://github.com/shadps4-emu/shadPS4/blob/main/documents/Screenshots/4.png\" width=\"400\"\u003e\n\u003c/p\u003e\n\n# General information\n\n**shadPS4** is an early **PlayStation 4** emulator for **Windows**, **Linux** and **macOS** written in C++.\n\nIf you encounter problems or have doubts, do not hesitate to look at the [**Quickstart**](https://github.com/shadps4-emu/shadPS4/wiki/I.-Quick-start-%5BUsers%5D).\\\nTo verify that a game works, you can look at [**shadPS4 Game Compatibility**](https://github.com/shadps4-compatibility/shadps4-game-compatibility).\\\nTo discuss shadPS4 development, suggest ideas or to ask for help, join our [**Discord server**](https://discord.gg/bFJxfftGW6).\\\nTo get the latest news, go to our [**X (Twitter)**](https://x.com/shadps4) or our [**website**](https://shadps4.net/).\\\nFor those who'd like to donate to the project, we now have a [**Kofi page**](https://ko-fi.com/shadps4)!\n\n# Status\n\n\u003e [!IMPORTANT]\n\u003e shadPS4 is early in development, don't expect a flawless experience.\n\nCurrently, the emulator can successfully run games like [**Bloodborne**](https://www.youtube.com/watch?v=wC6s0avpQRE), [**Dark Souls Remastered**](https://www.youtube.com/watch?v=-3PA-Xwszts), [**Red Dead Redemption**](https://www.youtube.com/watch?v=Al7yz_5nLag) and many other games.\n\n# Why\n\nThis 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.\n\n# Building\n\n\u003e [!IMPORTANT]\n\u003e 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**](https://github.com/shadps4-emu/shadPS4/releases) or the [**action tab**](https://github.com/shadps4-emu/shadPS4/actions).\n\n## Windows\n\nCheck the build instructions for [**Windows**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/building-windows.md).\n\n## Linux\n\nCheck the build instructions for [**Linux**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/building-linux.md).\n\n## macOS\n\nCheck the build instructions for [**macOS**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/building-macos.md).\n\n\u003e [!IMPORTANT]\n\u003e macOS users need at least macOS 15.4 to run shadPS4. Due to GPU issues there are currently heavy bugs on Intel Macs.\n\n# Debugging and reporting issues\n\nFor more information on how to test, debug and report issues with the emulator or games, read the [**Debugging documentation**](https://github.com/shadps4-emu/shadPS4/blob/main/documents/Debugging/Debugging.md).\n\n# Keyboard and Mouse Mappings\n\n\u003e [!NOTE]\n\u003e 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.\n\n| Button | Function |\n|-------------|-------------|\nF10 | FPS Counter\nCtrl+F10 | Video Debug Info\nF11 | Fullscreen\nF12 | Trigger RenderDoc Capture\n\n\u003e [!NOTE]\n\u003e Xbox and DualShock controllers work out of the box.\n\n| Controller button | Keyboard equivalent |\n|-------------|-------------|\nLEFT AXIS UP | W |\nLEFT AXIS DOWN | S |\nLEFT AXIS LEFT | A |\nLEFT AXIS RIGHT | D |\nRIGHT AXIS UP | I |\nRIGHT AXIS DOWN | K |\nRIGHT AXIS LEFT | J |\nRIGHT AXIS RIGHT | L |\nTRIANGLE | Numpad 8 or C |\nCIRCLE | Numpad 6 or B |\nCROSS | Numpad 2 or N |\nSQUARE | Numpad 4 or V |\nPAD UP | UP |\nPAD DOWN | DOWN |\nPAD LEFT | LEFT |\nPAD RIGHT | RIGHT |\nOPTIONS | RETURN |\nBACK BUTTON / TOUCH PAD | SPACE |\nL1 | Q |\nR1 | U |\nL2 | E |\nR2 | O |\nL3 | X |\nR3 | M |\n\nKeyboard 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.\n\n\n# Firmware files\n\nshadPS4 can load some PlayStation 4 firmware files, these must be dumped from your legally owned PlayStation 4 console.\nThe following firmware modules are supported and must be placed in shadPS4's `sys_modules` folder.\n\n\u003cdiv align=\"center\"\u003e\n\n| Modules                 | Modules                 | Modules                 | Modules                 |  \n|-------------------------|-------------------------|-------------------------|-------------------------|  \n| libSceCesCs.sprx        | libSceFont.sprx         | libSceFontFt.sprx       | libSceFreeTypeOt.sprx   |\n| libSceJson.sprx         | libSceJson2.sprx        | libSceLibcInternal.sprx | libSceNgs2.sprx         |  \n| libSceRtc.sprx          | libSceUlt.sprx          |                         |                         |\n\n\u003c/div\u003e\n\n\u003e [!Caution]\n\u003e The above modules are required to run the games properly and must be extracted from your PlayStation 4.\n\n\n\n# Main team\n\n- [**georgemoralis**](https://github.com/georgemoralis)\n- [**psucien**](https://github.com/psucien)\n- [**viniciuslrangel**](https://github.com/viniciuslrangel)\n- [**roamic**](https://github.com/roamic)\n- [**squidbus**](https://github.com/squidbus)\n- [**frodo**](https://github.com/baggins183)\n- [**Stephen Miller**](https://github.com/StevenMiller123)\n- [**kalaposfos13**](https://github.com/kalaposfos13)\n\nLogo is done by [**Xphalnos**](https://github.com/Xphalnos)\n\n# Contributing\n\nIf you want to contribute, please read the [**CONTRIBUTING.md**](https://github.com/shadps4-emu/shadPS4/blob/main/CONTRIBUTING.md) file.\\\nOpen a PR and we'll check it :)\n\n# Translations\n\nIf you want to translate shadPS4 to your language we use [**Crowdin**](https://crowdin.com/project/shadps4-emulator).\n# Contributors\n\n\u003ca href=\"https://github.com/shadps4-emu/shadPS4/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=shadps4-emu/shadPS4\u0026max=24\"\u003e\n\u003c/a\u003e\n\n\n# Special Thanks\n\nA few noteworthy teams/projects who've helped us along the way are:\n\n- [**Panda3DS**](https://github.com/wheremyfoodat/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\n\n- [**fpPS4**](https://github.com/red-prig/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.\n\n- **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.\n\n- [**felix86**](https://github.com/OFFTKP/felix86): A new x86-64 → RISC-V Linux userspace emulator\n\n# License\n\n- [**GPL-2.0 license**](https://github.com/shadps4-emu/shadPS4/blob/main/LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshadps4-emu%2FshadPS4","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshadps4-emu%2FshadPS4","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshadps4-emu%2FshadPS4/lists"}