775141d58c
* [GPU] Sweep CPU writes for device-address programs at memory visibility points A device-address program may read any mapped page, so before each such draw or dispatch the buffer cache uploaded every CPU-dirty page whenever the global CPU-dirty epoch had moved. A guest that streams its per-draw ring while the command stream is being translated moves the epoch between almost every pair of draws, and each upload ended the rendering scope and drained the GPU with an ALL_COMMANDS barrier pair - about 670 times per frame in Silent Hill: The Short Message's menu. CPU writes only need to be visible at memory visibility points: when a submission slice starts, when a wait packet is satisfied, and after a command-processor memory write (later commands may read those bytes through device addresses). The sweep now runs at the first device-address program after such a point, and its uploads share one barrier pair instead of one per buffer. SHARPEMU_BDA_SWEEP_EVERY_DRAW=1 restores the per-draw sweep. Menu GPU time drops from about 435 to 290 ms per frame. (cherry picked from commit fafe92b71271cf750dd89251891bac20fb87f1ff) * [GPU] Let command-processor DMA writes turn pages CPU-dirty instead of copying A DMA fill or copy into memory without GPU-written bytes is executed on the CPU, and the bytes were then pushed into every overlapping cache buffer through a staging copy and a barrier pair, which ends the rendering scope (~60 per frame in Silent Hill: The Short Message's menu). When no GPU-written byte shares the written pages, the pages now simply turn CPU-dirty: every later GPU reader synchronizes CPU-dirty pages before reading (bound buffers on obtain, device-address programs at the next memory visibility point, which the write now raises), so the bytes still arrive in command order. Pages that hold GPU-written bytes keep the staging copy. SHARPEMU_DEFER_HOST_WRITES=0 restores the copy. (cherry picked from commit 3fe21faa3821551fa99b9398064f0652e45d2e84) * [GPU] Keep hot CPU-written pages writable across device-address sweeps A page the guest rewrites every frame turns hot after two upload/write cycles, and the bound-buffer path then serves it from the stream ring so the page stays writable. The device-address sweep and the range synchronization still re-protected hot pages after every upload, so the guest's next write to each ring page took a protection fault - about 5,000 faults per second on Silent Hill: The Short Message's render thread, each a signal round trip under Rosetta plus page-guard lock traffic shared with the command worker. Both sweeps now preserve hot pages: they stay dirty and writable and are copied again on the next sweep, a few hundred KiB of ring memory per sweep. Faults drop to a third and the menu goes from 3.8 to 4.2 FPS. SHARPEMU_BDA_SWEEP_REPROTECT_HOT=1 restores the re-protection. (cherry picked from commit 65d2b55ddc07644d52e5ad3112cbe323a2421abd) * [GPU] Refresh writable hot pages at every BDA visibility point |
||
|---|---|---|
| .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