Go to file
boykopovar fbb8fcbf4e feat(shader): add translation convert instructions impl 2026-09-16 13:00:51 +03:00
3rdparty feat(repo): add git submodules to 3rdparty 2026-09-11 15:51:24 +03:00
core feat(shader): add translation convert instructions impl 2026-09-16 13:00:51 +03:00
docs refactor(core): add some nodiscard and const 2026-08-03 21:05:36 +03:00
.gitignore feat(agc): extend graphics compiler contract and add mesh and tessellation paths 2026-09-15 21:19:06 +03:00
.gitmodules feat(repo): add git submodules to 3rdparty 2026-09-11 15:51:24 +03:00
CMakeLists.txt feat(shader): rdna memory op decoder impl 2026-09-15 07:07:50 +03:00
LICENSE initial commit 2026-08-03 20:02:52 +03:00
README.md feat(shader): add attr and compare instructions translators 2026-09-16 10:32:38 +03:00

README.md

About

Converter for native execution of PlayStation 5 ELF binaries on Linux and Windows through binary format conversion and ABI compatibility. The relinker implementation uses only the C++20 standard library and performs deterministic transformation of executable binary.

Implementations of system prx libraries suitable for dynamic linking: core/libs/prx

Releases will be published after the first full successful launch of at least one game.

Status

Execution reaches _start, stack unwinding and exception handling tables are built. All unimplemented functions throw std::runtime_error. what() is printed to stderr and the process terminates. Audio output and video output initialization pass. Reaches the main function with render loop (deep call chain, ~64KB stack frame function) - init and shader loading from disk fully complete.

A standalone SPIR-V triangle test passes GPU readback checks and presents a frame through the libSceAgcDriver. The first application draw passes driver state validation and reaches shader recompilation. Application shader execution remains unverified without recompiler.

Now: ShaderRecompiler::Recompile: InstructionTranslator::Translate not implementedgi.

Build

The relinker uses only the C++20 standard library and should build with any conforming compiler.

libc.prx implementations contain compiler-specific code. Linux builds work with GCC; on Windows, MinGW-w64 GCC 15.2.0 (x86_64-ucrt-posix-seh) is currently required.

The project targets maximum compiler portability. Support for additional compilers will be addressed after the first successful game launch.

Disclaimer

This project is intended for interoperability, research, preservation, and compatibility purposes. It does not include, distribute, or require copyrighted software, firmware, cryptographic keys, or proprietary libraries. Users are responsible for ensuring that any binaries used with this project are obtained and used in accordance with applicable laws and their respective license terms.

License

This project is licensed under the GNU General Public License version 2 only.