Download · Documentation · Samples · Support
ps2build is an end-to-end platform for building PlayStation 2 software. One declarative ps2.yaml describes your Emotion Engine (EE) and I/O Processor (IOP) targets. ps2build generates the build, IDE metadata and installable packages, and keeps the SDK and compilers up to date.
| Declarative builds | Describe ee, iop, ee_lib and iop_lib targets in one file. No hand-written Makefiles. |
| Two compilers | Build with the GCC or LLVM toolchain, including a PS2-aware LLVM fork for R5900 and R3000A. |
| Self-updating SDK | ps2build update installs and upgrades the toolchain, SDK and tools. Each component versions independently. |
| IDE ready | Emits compile_commands.json and a JSON Schema for ps2.yaml completion. |
| Package ecosystem | Build and install libraries into the SDK, and consume them from other projects. |
| Automation | Built-in MCP server, plus GitHub Actions for CI. |
Install on Linux or macOS:
curl -sSfL https://ps2build.dev/install.sh | sh
Install on Windows (PowerShell):
irm https://ps2build.dev/install.ps1 | iex
Then create and build a project:
ps2build init my-game
cd my-game
ps2build build
| Area | Repositories |
|---|---|
| Build system | ps2build · manifest · ninja · cmake |
| Toolchains | toolchain · llvm-toolchain · llvm · gcc · binutils-gdb · newlib · newlib-llvm |
| SDK | sdk-core · sdk-world · ps2_drivers · pthread-embedded |
| Libraries | ps2gl · ps2stuff · romfs · freetype · libjpeg-turbo · ogg · vorbis |
| Developer tools | tools · vcl |
| CI | setup-sdk |
| Learn | docs · ps2build-samples |
ps2build is released under CC0 1.0 Universal. Third-party components keep their own licenses, listed in each repository.
Contributions are welcome. Read the CONTRIBUTING.md in the repository you want to change, and open an issue before starting large work.
PlayStation and PS2 are trademarks of Sony Interactive Entertainment Inc. ps2build is an independent project and is not affiliated with or endorsed by Sony.