ProsperoLight

Moonlight game streaming, natively on PlayStation 5.
Stream games and your desktop from a Sunshine-compatible PC to a homebrew-enabled PS5.

Features and fixes in the main branch may not be available in the latest published release. Check the changelog and the release notes before updating.

Features

• Native PS5 video: hardware-accelerated H.264 and HEVC (including HDR10) through VideoDec2 and AGC, with 1080p, 1440p and 4K stream options.
• High-refresh streaming: 30, 60, 90 and 120 FPS presets, plus Custom 30–120 FPS. Actual performance depends on codec, bitrate and hardware.
• Frame pacing and VRR: Unpaced, fixed-refresh Paced and adaptive Paced+VRR modes. Current source builds include Low Latency, Balanced and Smooth VRR timing profiles and low-FPS frame repetition.
• PyroWave: an optional Vulkan GPU decoder with SDR/HDR and 4:2:0/4:4:4 profiles, requiring a compatible Vibepollo/Vibeshine host.
• Controllers and input: up to four DualSense controllers, supported haptics/adaptive triggers, USB keyboard and mouse, plus on-screen keyboard and controller-driven mouse mode.
• Audio: selectable stereo or 5.1-channel Opus playback.
• A console-first launcher: automatic LAN discovery, multiple saved PCs, application artwork, persistent settings, and a UI available in 31 languages.
• Updates and diagnostics: in-app update support for compatible folder installations, performance overlay, and optional timing/log capture.

Get started

1. Prepare your PS5. You need a console with a compatible homebrew environment and title loader already configured. ProsperoLight does not install or provide an exploit.
2. Install ProsperoLight. Get PPSA99002.zip from Releases, extract it, and copy the complete PPSA99002/ folder to /data/homebrew/. Close the app before replacing an older installation; refresh your homebrew loader's title registration.
3. Start Sunshine (or a compatible host) on your PC. A wired local network is strongly recommended.
4. Pair and play. Open ProsperoLight, select a discovered PC or add its address, and enter the pairing PIN in your host's web interface. Open Games and choose an app or Desktop.

Press Touchpad + L1 to end the stream and return to the launcher. Pairings and settings normally remain in /data/prosperolight when updating the app.

Full user guide → — installation, pairing, updates, controllers, settings and saved data.

Controls

Touchpad means pressing the touchpad until it clicks. See the complete controls reference, including the host Back/Guide shortcuts and multi-controller behavior.

Video quality and compatibility

Bitrate limits

H.264/HEVC decoding and PyroWave have different performance characteristics. In measured native 4K HEVC sessions, bitrates above roughly 80 Mbps at 120 FPS can exceed the PS5 decoder's real-time budget. Increasing bitrate is not always an improvement. PyroWave has different host and network requirements.

VRR and frame timing

VRR support depends on the console, firmware, TV and actual output mode; a successful VideoOut API call does not prove physical HDMI VRR or a particular latency improvement. For a starting point, try a wired network, native HEVC, and conservative bitrate before experimenting with higher refresh rates.

Performance and video guide → — codec selection, measured bitrate limits, pacing modes and VRR caveats.

Documentation

Build from source

See Getting started for Linux/WSL prerequisites and reproducible dependencies. Once set up:

git submodule update --init --recursive
make doctor
make check

The build produces a complete dist/PPSA99002/ app directory. For the safe FTP deployment workflow, see Deployment.

Support and contributions

Found a bug? Open an issue with your PS5 firmware, host version, codec/settings and reproduction steps. For stream problems, enable Diagnostic logs and attach relevant logs after reviewing Troubleshooting. Logs can contain local host addresses and app names; review them before sharing.

Contributions and testing across different TVs, firmwares and network setups are welcome. See CONTRIBUTING.md.

[!IMPORTANT] This is an independent homebrew project, not an official Sony, Moonlight or Sunshine product. It requires a compatible homebrew-enabled console and includes no exploits, proprietary Sony SDK, firmware, keys or game assets. Use at your own risk and only with hardware and content you are entitled to use.

Credits

Thanks to ProsperoLight contributors: Nikita Dybov, KrisEnigma.

Built with the PS5 Payload SDK by John Törnblom (ps5-payload-dev). Third-party components, authors and licenses are listed in THIRD_PARTY_NOTICES.md.

License

Copyright © 2026 BlackBearReloaded. Licensed under GPL-3.0-or-later; see LICENSE. Third-party components keep their own licenses. Binary releases are built from the tagged source in this repository.

Disclaimer

• No affiliation. This is an independent homebrew project. It is not affiliated with, endorsed by, or sponsored by Sony Interactive Entertainment. "PlayStation", "PS5" and related marks are trademarks of Sony Interactive Entertainment Inc. This project is not affiliated with or endorsed by the Moonlight or Sunshine projects.
• No proprietary material. No Sony SDK, firmware, encryption keys or decrypted system modules are included.
• No warranty. This project is provided "as is", without warranty of any kind, to the extent permitted by law. See sections 15 and 16 of the GPL.
• Use at your own risk. Running homebrew requires a modified console, which may void its warranty, breach the platform's terms of service, or cause data loss.
• Legal use only. Use it only with hardware, accounts and content you own. This project does not support or enable piracy.

AI assistance

This project was developed with AI assistance from OpenAI and/or Anthropic tools.