db32c9d882
* [SpirvTranslator] Keep pure scalar lane spills in private slots under emulated wave64 A wave64 program run as a 64-thread workgroup on a 32-lane host emulates v_readlane with an LDS exchange and a workgroup barrier. Compilers use constant-lane v_writelane/v_readlane pairs on a VGPR as SGPR spill slots; when that VGPR is written only by constant-lane writelanes and read only by constant-lane readlanes, each (vgpr, lane) pair is a private scalar, so the readlane loads the slot instead of exchanging through LDS. This halves the heaviest compute dispatch in Silent Hill: The Short Message's menu. (cherry picked from commit 9915b88e68b6b69d6b74ea931a22eb0589c56f1a) * [SpirvTranslator] Zero private LDS lazily through a written-dword bitmap Graphics stages model LDS as a per-invocation private array that must read zero where the invocation has not written. The array carried a zero initializer, but Metal keeps a dynamically indexed private array in stack memory, so every invocation cleared all of it: an NGG vertex shader (the PS5 default, with in-shader culling through LDS) cleared 8 KiB per vertex. The array is now uninitialized and a zero-initialized bitmap of written dwords (1/32 of the size) records which slots were addressed; LdsPointer zeroes a slot the first time it is addressed, so loads, stores and atomics keep the zero-read semantics. Compute LDS stays workgroup memory. Silent Hill: The Short Message's menu, dominated by ~45M shadow-pass vertices per frame, goes from about 2.0 to 3.1 FPS. (cherry picked from commit 5738b8574397cf2be08cd4e1518b33057c8867b5) * [SpirvTranslator] Test the lane's mask bit in one register under emulated wave64 VCC and EXEC keep a per-lane boolean that every mask write refreshes, and the refresh composed the 64-bit mask from its two registers, built a 64-bit lane bit and masked them. A host without 64-bit integer arithmetic (Apple GPUs through MoltenVK) emulates each of those with a pair of 32-bit operations. The bit lives in exactly one of the two registers, so selecting that register and shifting inside it is the same test in 32-bit arithmetic. Only the emulated-wave64 path changes; wave32 already tested one register, and a native wave64 host keeps the existing form, which also clears the bit for lanes outside the guest wave. (cherry picked from commit 1b2651047fdf232304142c82168e487244dda4ef) * [SpirvTranslator] Let s_barrier publish only what the guest waited for Every compute s_barrier became an OpControlBarrier with AcquireRelease over uniform, workgroup and image memory, on the assumption that the guest had drained vector memory first. s_barrier only orders execution; what it publishes is whatever the preceding s_waitcnt drained. A barrier that follows an LDS-only wait (lgkmcnt(0)) publishes LDS, and ordering device memory there costs a cache flush the guest never asked for: UE's FFT bloom convolution barriers 48 times per group, all LDS-only. The translator now tracks, per block, whether any wait drained vector memory - SOPP vmcnt(0), or the GFX10 SOPK vscnt(0)/vmcnt(0) forms, since stores are counted by vscnt there - and a barrier after an LDS-only wait carries workgroup memory only. A drained counter stays drained for the rest of the block, and a barrier with no wait in its block keeps the full semantics (the wait may be in a block this one cannot be ordered against). (cherry picked from commit 1f81df59bc07d05f2baa6283da95f4901dada444) |
||
|---|---|---|
| .github | ||
| LICENSES | ||
| assets/images | ||
| docs | ||
| scripts | ||
| src | ||
| tests | ||
| tools | ||
| .editorconfig | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| Directory.Build.props | ||
| Directory.Packages.props | ||
| LICENSE.txt | ||
| README.md | ||
| REUSE.toml | ||
| SharpEmu.slnx | ||
| global.json | ||
| nuget.config | ||
README.md
SharpEmu
An experimental PlayStation 5 emulator for Windows, Linux and macOS.
Join our official Discord server for development updates, compatibility discussions, support, and community chat.
[!IMPORTANT] Official channels: Only sharpemu.app and the links listed in this GitHub repository are affiliated with SharpEmu. Any other websites, accounts, or donation pages are unofficial and unauthorized.
[!NOTE]
SharpEmu supports Windows x64, Linux x64, and macOS x64. Apple Silicon Macs can run the macOS x64 build through Rosetta 2, and Windows on ARM devices (e.g. Snapdragon) can run the Windows x64 build through Windows' built-in x64 emulation.
[!WARNING]
SharpEmu is an experimental PS5 emulator developed from scratch in C#. The current focus is on accuracy and infrastructure setup rather than game-specific compatibility.
Info
SharpEmu is an emulator project currently in its early stages of development.
This project is developed purely for research and educational purposes. There are no commercial goals associated with it. We enjoy learning about system architecture and reverse engineering.
SharpEmu focuses exclusively on the PlayStation 5.
Our goal is not to emulate PS4 games, as there is already an excellent emulator dedicated to that platform: ShadPS4.
Games Tested
| Demon's Souls Remake | ASTRO BOT |
|---|---|
 |
 |
| ASTRO's PLAYROOM | Dead Cells |
|---|---|
 |
 |
| God of War: Sons of Sparta | Tomb Raider V Remastered |
|---|---|
 |
 |
Status
The emulator can currently load the eboot.bin of real games, execute native CPU instructions, and partially handle gpu-related functionality. Included 3D games.
SharpEmu supports Windows, Linux, and macOS hosts. Video output uses Vulkan on Windows and Linux, and MoltenVK on macOS. Platform support is still experimental, so compatibility and performance vary by game, operating system, and GPU driver.
Using
Download the release archive for your operating system, extract it, and launch
SharpEmu with the path to a legally obtained game's eboot.bin.
Or command line;
Windows PowerShell:
.\SharpEmu.exe "C:\path\to\game\eboot.bin" --log-to-file
Linux and macOS:
chmod +x ./SharpEmu
./SharpEmu "/path/to/game/eboot.bin" --log-to-file
SharpEmu supports environment variables that can be configured from the GUI. Undocumented variables are listed here: docs/sharpemu-gui-undocumented-env-vars.md
You can set them per game or globally in the GUI, or pass them directly through the CLI.
A Vulkan-capable GPU and current graphics driver are required. The macOS release includes the MoltenVK Vulkan implementation.
[!IMPORTANT]
This project does not support or condone piracy.
All games used during development and testing are dumped from consoles that we personally own.
Users are expected to use legally obtained copies of their games.
Build
- Install the .NET SDK version specified in
global.json. - Clone the repository:
git clone https://github.com/sharpemu/sharpemu.git - Open the solution file (
SharpEmu.slnx) in VSCode. - Build the project:
dotnet buildordotnet publish - Build artifacts will be located in the
artifactsdirectory.
Disclaimer
SharpEmu is an experimental emulator intended for research and educational purposes.
This project does not contain any copyrighted system firmware, game data, or proprietary PlayStation assets.
Special Thanks
The following projects were extremely helpful during development:
-
ShadPS4
Helped with understanding the basic architecture of the PlayStation 4. -
Kyty
One of the few PS5 emulator projects available and very useful for studying native code execution. -
Ryujinx
Provided valuable references for filesystem handling and low-level C# implementation patterns.
License
Support
Support SharpEmu via GitHub Sponsors or cryptocurrency. Every contribution helps fund ongoing development and long-term maintenance. GitHub Sponsors is the preferred way to support the project, but cryptocurrency donations are also appreciated.
ETH/USDT
0xF315F5d986c790bB3A58DbE60F1B2760997dEd82
BTC
bc1qmr9k8899njys5ny63xsues4jgmkk96erslrkmv
Contributing
Before opening an issue or pull request, please read our contribution guidelines:
The guide covers:
- Coding style and formatting
- AI-assisted contributions
- Pull request expectations
- Testing guidelines
- Legal and reverse engineering policy