Tool

PsyZ

C porting library that replaces the API of PSY-Q, Sony's PlayStation runtime library, with native implementations, so decompiled or original PlayStation source can be compiled for Linux, macOS, iOS, Windows, WebAssembly and PSP while still building for the console. It aims at PSY-Q API compatibility and offers an optional GPU and SPU emulation layer behind emulated MMIO endpoints, and carries a matching decompilation of the PSY-Q 4.0 libraries.

Targets: Game
Category: Game analysis tools
Relationship: Foundation tool
Sources reviewed: 2026-10-19

Stars: 102
Last commit: 2026-11-07
Language: C

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

Requirements & limits

CMake 3.21 or newer, a C11 compiler, SDL3 and a recursive clone of the SDL, cimgui and nugget submodules are needed; WebAssembly builds use Emscripten.
A game port needs reconstructed C source and the changes in the porting guide, including ordered-table and primitive-tag types and 64-bit pointer fixes. The PSY-Q decompilation is ongoing; hardware-dependent game bugs may behave differently.
Optional PlayStation SDK setup downloads proprietary PSY-Q 4.0 and 4.7 SDK archives hosted by the project to cross-compile and check the decompiled libraries.
CI tests Linux, Windows, macOS and PSP builds; the reported Symphony of the Night prologue comparison is a single author measurement.
Licensing varies: nugget, psyq2elf, samples and ztest are MIT; psyz/src/platform and psyz/src/psyz are MPL-2.0; psyz/include and psyz/src/psyq are unlicensed; decomp/ has its own MIT license.

Cite

BibTeX

@misc{psyz,
  title = {{PsyZ}},
  howpublished = {\url{https://github.com/Xeeynamo/psyz}},
  url = {https://github.com/Xeeynamo/psyz},
  urldate = {2026-10-19},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/psyz/}}
}

Plain text

PsyZ. https://github.com/Xeeynamo/psyz (accessed 2026-10-19). Awesome REA entry: https://awesomerea.org/resources/psyz/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · Xeeynamo/psyz · Revision 559adc7
LICENSE GitHub · Xeeynamo/psyz · Revision 559adc7
PORTING_GUIDE.md GitHub · Xeeynamo/psyz · Revision 559adc7
decomp/README.md GitHub · Xeeynamo/psyz · Revision 559adc7
decomp/LICENSE GitHub · Xeeynamo/psyz · Revision 559adc7
decomp/sdk/Makefile GitHub · Xeeynamo/psyz · Revision 559adc7
Makefile GitHub · Xeeynamo/psyz · Revision 559adc7
psyz/CMakeLists.txt GitHub · Xeeynamo/psyz · Revision 559adc7
.github/workflows/build.yaml GitHub · Xeeynamo/psyz · Revision 559adc7