Go to file

Alberto Ruiz cc3d2d21ef fix(shader): skip the push constant copy when there is nothing to copy decodeResult and decodeAllocation called memcpy with the data() of empty vectors, which may be null. Passing a null pointer to memcpy is undefined even for a zero size, and UBSan reports it on every entry without push constants, including the existing shader disk cache test. The copy now runs only for a non-empty table, as Reader::Values does. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01R5WJS4ZdQynAJesCZKH5hb		2026-10-01 13:28:36 +02:00
.github	Merge pull request #189 from adriadam10/ci/label-colors	2026-09-30 19:16:28 +03:00
3rdparty	feat(audio): AJM MP3 through FFmpeg, 16-bit and ambisonic AudioOut2, voice	2026-09-29 21:22:15 +03:00
core	fix(shader): skip the push constant copy when there is nothing to copy	2026-10-01 13:28:36 +02:00
docs	feat(relinker): lower CLZERO for --to-intel	2026-10-01 12:30:35 +02:00
tools	fix(tools): count tested shared shader instruction variants	2026-10-01 20:23:58 +10:00
.gitignore	chore(gitignore): ignore build_tools/ secondary CMake tree	2026-09-25 16:27:49 -07:00
.gitmodules	feat(audio): AJM MP3 through FFmpeg, 16-bit and ambisonic AudioOut2, voice	2026-09-29 21:22:15 +03:00
CMakeLists.txt	refactor(cmake): place all test executables in build tests directory	2026-10-01 12:28:06 +03:00
CONTRIBUTING.md	docs: add contributing guide	2026-09-30 16:53:17 +02:00
LICENSE	initial commit	2026-08-03 20:02:52 +03:00
README.md	refactor(cmake): move some libs test definitions to local cmakelists	2026-10-01 12:21:46 +03:00

README.md

About

Tool for automatic executables porting to Linux and Windows.

Includes a relinker that converts executable to the target system's native format and implementations of system prx libraries suitable for dynamic linking. No emulation or separate runtime process.

Status

_{* System libraries: percentage of the functions known to the project so far (declared in core/libs/prx), not of every PS5 system function. The total grows as more functions are declared.}

List of verified games

Dreaming Sarah (2D platformer) runs at a stable 60 fps on a GTX 1050 Ti / i5-7500 3.4GHz.

Unsupported or unexpected states strictly throw std::runtime_error. what() is printed to stderr and the process terminates.

The shader recompiler successfully produces SPIR-V (validated via Spirv-Tools when built with ANYPS5_ENABLE_SPIRV_TOOLS).

Technical debt of the project, code style conventions, contributing

Build

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

On Intel hosts, pass --to-intel to the relinker to lower supported AMD-only instructions in the executable and bundled sce_module/sce_modules PRX files. Unsupported instructions or stub jumps outside the x86-64 relative branch range produce an error.

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

The project targets maximum compiler portability (but now it is not implemented).

Compatibility

See the game compatibility list for tested games and known issues.

Input mapping

SDL-mapped game controllers are supported, including analog sticks and triggers. Keyboard and mouse controls can be configured with an anyps5-input.ini file. See input mapping for the supported devices and configuration format.

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.