# ProsperoEden ports the Eden emulator to PS5 homebrew, and it is still alpha

> ProsperoEden is an unofficial PS5 port of the Eden emulator, built on a native PS5 application boilerplate with Vulkan rendering on a Mesa driver ported for the console. It renders games with ASTC texture handling, frame generation and ReShade post-processing, and the project says plainly that it is an early alpha with a fixed release train.

**Swordpdf/ProsperoEden** — Experimental Eden port for PS5

- Repository: https://github.com/Swordpdf/ProsperoEden
- Stars: 813 · Forks: 113
- Language: C++
- License: GPL-3.0
- Published: 2026-10-20 · Updated: 2026-10-20 · Language: en
- Canonical page: https://hysenlabs.com/projects/swordpdf-prosperoeden

## An upstream emulator with a new native foundation

ProsperoEden is described as an unofficial PlayStation 5 port of Eden, an accurate, high-performance emulator, and the README is explicit about credit: all credit for the emulator core belongs to the Eden project and its contributors. It also states that ProsperoEden is not affiliated with or endorsed by the Eden team or Sony.

What the port itself consists of is stated in the source code section: the complete ProsperoEden source is in the repository, with the PS5 frontend and launcher in headless/ and the build and packaging tools in tools/.

The native foundation comes from elsewhere. The project is built on the PS5 Native App Boilerplate, the same native foundation used by ProsperoLight, which provides the native PS5 application structure, runtime, packaging and homebrew deployment foundation. Graphics come through ps5-opengl, an OpenGL implementation that provides the native PS5 rendering layer used by the Eden graphics backend. Vulkan is powered by Mihawk's PS5 Mesa and PS5 Vulkan, where Mihawk's Mesa and RADV driver for the PS5 runs the Vulkan renderer. And ps5-vulkan by mpereiraesaa is an experimental Vulkan graphics and compute API for native PS5 homebrew.

So this is a stack of four upstream projects, and the port is the integration work rather than the emulation work. That framing matters for evaluating the project: the interesting work is the platform port, and the emulation correctness belongs upstream.

## Alpha means alpha, and the README does not hide it

The status line is unambiguous. This is an early alpha. Video, audio, controller input and saves have been confirmed working. Compatibility and performance will vary between games. The current release is v1.005.000.

The release history shows a tight cadence around that version: v1.003.000 on 2026-10-16, v1.004.000 on 2026-10-17 and v1.005.000 on 2026-10-18, with the last push to the repository on 2026-10-18. The version numbering with three digits for the last component is a PlayStation title identifier convention, and the build Makefile confirms it with a release app path of build/release/PPSA99008.

What changed in each release is tracked in a changelog at docs/CHANGELOG.md, and the README points there for v1.005.000 and for every release before it. That is the file to read before deciding whether to upgrade, because in an alpha the release notes are the changelog and the changelog is the documentation.

The GitHub Actions built release ZIPs can be checked with the GitHub CLI, and the README is precise about the coverage of that check.

```bash
gh attestation verify <ZIP> -R blackbearreloaded/ProsperoEden
```

That covers releases built from now on, after v1.000.090, and not earlier ones. So if you are verifying an artifact, whether it carries an attestation depends on when it was built, and the README does not pretend otherwise.

The licence is GPL-3.0, with a LICENSE file and a THIRD_PARTY_NOTICES.md at the root, which is what you would expect given how many upstream projects are involved.

## Building it means make on Linux with pinned dependencies

The build is a Makefile, and it runs on Linux, with Ubuntu 26.04 named as the reference and WSL called out as working.

```bash
make
```

The default goal builds the release files into dist/, and the help target lists every target and variable.

```bash
make help
```

What makes this build unusual is the dependency handling. The Makefile header states that missing dependencies are fetched at their pinned revisions from tools/deps.json, and that nothing that already exists is changed. That is a hermetic build in the practical sense: the revisions are recorded in a file rather than left to whatever a package manager resolves today, which matters for a project that is rebuilding against moving upstream repositories on every release.

The variables are worth reading before you build. JOBS sets the parallel compile jobs and defaults to the number of processors. DEV_TITLE is the sixteen hex digit title ID that a development build boots, and it can also be written to .local/dev-profile-title. PS5_HOST and PS5_PORT are the console address and the port of its FTP server, defaulting to 2121, and they are what the install target uses to push the build to a console.

```bash
JOBS ?= $(shell nproc)
DEV_TITLE ?= $(shell cat .local/dev-profile-title 2>/dev/null)
PS5_HOST ?=
PS5_PORT ?= 2121
```

The dev target refuses to run without a title ID and exits with a message telling you to set DEV_TITLE or write the file. The release target runs a Python script to produce the distribution, and the package target shells out to a build script for the release application. The declared targets are release, package, dev, prepare, deps, deps-status, toolchain, test, install, clean and distclean, and docs/BUILDING.md covers the details.

## Two renderers, and a Vulkan path that depends on a ported driver

The graphics stack has two backends and the choice is a real trade-off rather than a formality.

The Vulkan renderer is the recommended one and the default, running on Mihawk's PS5 Mesa RADV driver. The OpenGL renderer is still available through ps5-opengl, and you switch between them in Settings > Video.

The reason the Vulkan path is preferred is presumably the maturity of the underlying driver, since the whole Vulkan stack here is ported work: Mihawk's Mesa and RADV driver for the PS5, and ps5-vulkan as an experimental graphics and compute API for native PS5 homebrew. The OpenGL path through ps5-opengl is described as the native PS5 rendering layer used by the Eden graphics backend.

Resolution handling is unusually configurable. You can render at 0.5x to 4x of the game's resolution and pick the scaling filter, with Bilinear, AMD FSR, Bicubic and Nearest listed, in Settings > Video. Output resolution is separate, with the picture made at 1080p, 1440p or 2160p, and the menu drawn at that size too, with the PS5 scaling it to your television.

There is also a memory-conscious texture decision. Textures in a format the PS5 GPU cannot read, which is ASTC, are kept compressed as BC3, which takes a quarter of the graphics memory they would need decoded. Setting ASTC textures to Full quality instead keeps them decoded, which uses four times the graphics memory for them and can make a game run out of memory above 1x. That is a real setting with a real failure mode attached, documented rather than hidden.

On top of that sit frame generation, 120 Hz output, and ReShade FX post-processing with six presets, all in Settings > Video or in a game's own settings.

## Frame pacing, frame generation and post-processing

Three features in the list go beyond the job of just running a game, and they are worth understanding separately.

The steadier frame rate option addresses a specific behaviour of games that time their own frames. The README explains that some games drop to a lower frame rate, 30 to 20 or 60 to 30, as soon as a frame takes a little too long. ProsperoEden lets the game's clock give by up to 15% in those moments, so the game keeps its frame rate and runs a few percent slower instead of losing a third of its frames. That is a timing policy, not a performance trick, and it trades a little game speed for consistency.

The 120 Hz output option runs games on a 120 Hz output on a display that shows it, and the README gives the reasoning in latency terms: a frame that is a little late is shown 8 ms later instead of 17 ms, and patches for more than 60 FPS need it. The menu stays at 60 Hz.

Frame generation shows one synthesised picture between two of the game's own, so a 30 FPS game looks like 60. There are two methods, MihawkGen which comes with the app, and Lossless Scaling with your own copy of it.

Post-processing is ReShade FX, drawn over the game's picture, and it works with the Vulkan renderer. Six presets ship with the app: Anime, Cinematic, Clean, Dreamy, Retro and Vivid. Your own presets go in /data/prosperoeden/user/post_presets/ and the effects they use in /data/prosperoeden/user/post_shaders/, while a game's own presets and effects live in that game folder's reshade/ directory and are offered for that game only. Both are listed after a restart.

The file layout is worth noting for one practical reason: the per-user paths are on the console's data volume, so a custom preset is not tied to a single game install and is not lost when you reinstall one.

## Homebrew deployment, file placement and the launcher

The non-emulation half of the project is the native application around it.

Game files can live anywhere the PS5 can read: internal storage, an M.2 or external drive, or a USB device. Keys, firmware and games all follow the same rule. The folder browser in Settings > Game files shows how many keys, firmware files and games each folder holds, with L1 and R1 held to page quickly.

The library shows games as covers with the selected game's details beside them, and the home screen has Continue Playing and Recently Played that keep working after you move your files.

The launcher is drawn with OpenGL and has sound effects, with their level in Settings > Audio, plus a loading screen showing the game's cover while it starts. It opens from the console's own launch picture without a cut, the mark appearing over the picture and going to its place as the menu arrives, and any button skips it. Its five sections, Home, Library, Multiplayer, Settings and About, sit on a rail at the left, with L1 and R1 moving between them and Left from a screen edge opening the rail.

Beyond that there are themes, chosen in Settings > Theme, with one shipped called Canopy, and wallpapers, which are your own images behind the menu rather than the theme artwork. Wallpapers accept PNG or JPEG and also BMP, GIF, TGA and DDS, and live in /data/prosperoeden/wallpapers, chosen in Settings > Appearance > Wallpaper. Themes and wallpapers are the kind of thing that separates a homebrew port from a bare test build, and docs/THEMES.md and docs/WALLPAPERS.md cover them.

## Multiplayer through Eden rooms is new and experimental

Local-wireless multiplayer through Eden rooms arrived in v1.000.110 and the README labels it experimental. Two documents cover it: a setup guide with current limitations at docs/MULTIPLAYER.md, and a validation status document at docs/MULTIPLAYER_IMPLEMENTATION.md.

The qualification note is the part to note: Tailscale forwarding is not yet qualified.

That is a specific and useful thing for a reader to know, because local wireless multiplayer and forwarding across networks are different problems. A setup that works on a LAN says nothing about behaviour over a forwarded connection, and the project distinguishes the two rather than implying the feature is complete.

Multiplayer also appears in the launcher's five sections, between Library and Settings, so it is a first-class part of the interface even while the implementation behind it is being qualified.

The broader context for all of this is that the project is early and moving quickly, with three tagged releases in three days at the time of writing. Experimental features in that context are likely to change shape between versions, and the validation status document exists precisely so you can check rather than assume.

## Where ProsperoEden is the wrong choice

The first limitation is the one the README states most plainly: this is an early alpha where compatibility and performance vary between games, and only video, audio, controller input and saves are confirmed working. If you need a reliable way to play a specific title, the variance is the problem, not a missing feature list.

The second is the dependency on ported graphics drivers. The recommended Vulkan path runs on Mihawk's Mesa and RADV driver for the PS5, which in turn sits on ps5-vulkan, described as an experimental Vulkan graphics and compute API for native PS5 homebrew. The chain from your game to the screen includes several projects that are themselves ports of ports. That is not a reason to avoid it, since the same is true of any console port, but it does mean the OpenGL fallback through ps5-opengl is a genuine second path rather than a formality.

The third is the platform. This is native PS5 homebrew. There is nothing here for a PC, and nothing for the PS4 or PS3.

The fourth is the build environment for anyone wanting to work on it rather than install it. The build runs on Linux with Ubuntu 26.04 as the reference, pinned dependency revisions fetched from tools/deps.json, and a development target that needs a sixteen hex digit title ID to boot. That is a real setup, and the docs/BUILDING.md file is the entry point.

The fifth is the verification story, which is good but partial. Attestation verification covers releases built after v1.000.090, so an older ZIP cannot be checked the same way, and the project asks you to read the changelog for what changed rather than assuming the newest tag is what you want.

## How it compares with running Eden elsewhere

The alternative is running Eden on a PC or on the other consoles the upstream project targets, and the difference is not subtle.

Eden running on a PC gets you a mature desktop emulator with a long history of configuration, and the recent console hardware is generally faster than the older consoles Eden emulates. For someone whose goal is to play a game, that is usually the better path.

What running it on the PS5 buys is different. The console is the target device, the game runs on the same hardware it would run on natively, and the port is built on a native PS5 application with homebrew deployment support rather than an emulator running on foreign hardware. The launcher, the profiles, the themes and the per-game settings are part of a native application, which is what the PS5 Native App Boilerplate foundation provides.

The other dimension is the upstream contribution. The README credits the Eden project for the core and says all credit for the emulator core belongs to that project and its contributors, and the third party notices file at the root reflects a stack of upstream dependencies. So a PS5 port is best understood as a contribution to Eden's hardware coverage rather than a fork with its own ideas about emulation.

The honest summary is that ProsperoEden and Eden on a PC are not competing tools for the same job. One is a native port that extends the upstream emulator to new hardware, and the other is the mature way to play today. The port's value is that it exists at all, and that its dependencies and build are reproducible enough for someone to pick up and continue.

## Conclusion

ProsperoEden fits a PS5 homebrew developer who wants to run the Eden emulator core natively on the console and is prepared to debug early alpha software, since the project confirms only video, audio, controller input and saves as working. It does not fit someone who wants a stable retail experience, because the README labels it an early alpha, states that compatibility and performance vary between games, and its multiplayer support through Eden rooms is experimental with Tailscale forwarding not yet qualified. Before building or running it, read docs/CHANGELOG.md for what changed in the current release, confirm your hardware meets the Vulkan requirements of the Mesa driver it depends on, and check the attestation story for your build, since gh attestation verify only covers releases built after v1.000.090.

## FAQ

### What is ProsperoEden and is it affiliated with Sony or the Eden team?

ProsperoEden is an unofficial PlayStation 5 port of the Eden emulator, built as native PS5 homebrew. The README states that all credit for the emulator core belongs to the Eden project and its contributors, and that ProsperoEden is not affiliated with or endorsed by the Eden team or Sony.

### How do I build ProsperoEden from source?

Run make on Linux, with Ubuntu 26.04 as the reference and WSL called out as working. Missing dependencies are fetched at their pinned revisions from tools/deps.json, the release files are written to dist/, and make help lists every target. The Makefile variables include JOBS, DEV_TITLE, PS5_HOST and PS5_PORT.

### Which graphics backends does ProsperoEden support?

The Vulkan renderer is the recommended default and runs on Mihawk's PS5 Mesa RADV driver, while an OpenGL renderer remains available through ps5-opengl. You switch between them in Settings > Video, where resolution scaling, output resolution, ASTC texture quality, 120 Hz output, frame generation and ReShade post-processing are also configured.

### How do I verify a ProsperoEden release ZIP?

A release ZIP built by GitHub Actions can be checked with the GitHub CLI using gh attestation verify <ZIP> -R blackbearreloaded/ProsperoEden. The README notes that this covers releases built after v1.000.090 and not earlier ones.

### Is multiplayer supported in ProsperoEden?

Local-wireless multiplayer through Eden rooms is new in v1.000.110 and is marked experimental. The setup guide and current limitations are in docs/MULTIPLAYER.md, the validation status is in docs/MULTIPLAYER_IMPLEMENTATION.md, and Tailscale forwarding is not yet qualified.

## Sources

- [Issues](https://github.com/Swordpdf/ProsperoEden/issues)
- [License: GPL-3.0](https://github.com/Swordpdf/ProsperoEden/blob/main/LICENSE)
- [README](https://github.com/Swordpdf/ProsperoEden/blob/main/README.md)
- [Releases](https://github.com/Swordpdf/ProsperoEden/releases)
- [Swordpdf/ProsperoEden on GitHub](https://github.com/Swordpdf/ProsperoEden)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/swordpdf-prosperoeden