THE INDEPENDENT PLAYER’S GUIDE

PS2 Web Recomp

Setup guides & game compatibility.

Turn a PS2 game’s code into WebAssembly for a local browser build. Learn the setup, watch the author’s Gran Turismo 4 demo, and check the documented progress for each game.

Bring your own disc image. The demo is a video; game builds run on your machine.

Original project on GitHub by snuri00
EARLY PROJECT. REAL POSSIBILITIES.SCROLL TO EXPLORE ↓
Static recompilation → WebAssembly Game-by-game, evidence-first Open-source roots. Independent voice.
01 / THE IDEA

What is
PS2 Web Recomp?

A PS2 game’s main CPU code, translated before you press play.

PS2 Web Recomp is snuri00’s open-source project for translating a game’s Emotion Engine code to C++, then compiling it to WebAssembly. A browser runtime handles the remaining console systems, from vector units and audio to WebGPU graphics.

This independent guide explains the local build workflow, browser requirements, and evidence behind each game record. Start with the documented setup and keep the original sources close by.

How to set up a local build
01Your gameA disc image you own
02Static recompilationEmotion Engine → C++ → Wasm
03A local browser buildRuntime emulation + WebGPU
Gran Turismo 4 — project author recording1:24

Project author recording · Not an independent test

Recorded by snuri00. Play the video here without leaving this site.

Recording source

This recording comes from the project author’s public documentation. View the original source (opens in a new tab).

SEE THE AUTHOR’S WORK

Gran Turismo 4
browser demo.

Watch the project author’s race recording right here. Use the player to pause, seek, or view fullscreen, then explore the conditions behind the result.

Read the game record Recording by snuri00 · 1:24 · Video, not an online game.
Video loads when you play it. Original source is linked below the player.
02 / GAME FIELD NOTES

Games & compatibility.

Gran Turismo 4 and God of War II: author-documented progress, conditions, and current limits.

Explore all records

These records come from project author documentation. We have not independently tested either game. Demonstrated progress does not establish a full playthrough.

How we label evidence
03 / KNOW BEFORE YOU BUILD

A little preparation goes a long way.

Bring these along

  • A disc image of a game you own. No game data is included.
  • Git, CMake, Ninja, a C++20 compiler and Python 3.
  • Documented build platforms: Linux x86-64 and Apple silicon macOS.
  • A WebGPU-capable browser and the supplied local server.
Full setup checklist
SET YOUR EXPECTATIONS

An experiment worth understanding.

This is an early, game-by-game project. Other titles can stop at missing system calls, I/O functions or graphics features. There is no guarantee that an arbitrary ISO will work.

Performance depends on the scene, device and resolution. Keep generated game code and builds private, as the author instructs.

Understand the current limits
04 / YOUR NEXT STEP

Setup, controls, saves & browsers.

Follow the local setup walkthrough, then check input, memory cards, and graphics requirements.

All guides
Setup / AUTHOR-DOCUMENTED

Your first local build

Build and run PS2 Web Recomp locally with a source-backed setup walkthrough, tool checklist, expected outputs, troubleshooting, and a timestamped video overview.

Read guide
Controls / AUTHOR-DOCUMENTED

Controls & gamepads

The documented PS2 Web Recomp keyboard layout, browser gamepad support, pressure-sensitive triggers, and useful checks before reporting an input problem.

Read guide
Saves / AUTHOR-DOCUMENTED

Keep your progress

Understand browser-local memory cards, export and import .ps2 backups, and record save issues without claiming untested game compatibility.

Read guide
Settings / AUTHOR-DOCUMENTED

Browsers & graphics

Understand WebGPU, native versus scaled resolution, cross-origin isolation, and the limits of the author's PS2 Web Recomp performance reports.

Read guide
05 / THE COMMON QUESTIONS

Start with
the right context.

Answers grounded in the
project’s public documentation.

Check the original README
What is PS2 Web Recomp?

It is snuri00’s open-source project for bringing individual PlayStation 2 games to the browser. It translates the game’s Emotion Engine code ahead of time to C++, then compiles that to WebAssembly. The remaining console systems are handled by a runtime.

How the project works
Is this still emulation?

Yes, in part. The main CPU game code is statically recompiled rather than interpreted. The operating system and other console hardware are still emulated or reimplemented by the runtime. WebGPU handles the GPU renderer.

Read the browser and graphics guide
Can I upload any ISO and start playing?

No. You build a page locally for a game using the project’s scripts and a disc image you own. Only two titles are documented in the reviewed README. Other games may encounter missing runtime functions or graphics features.

See the local build workflow
Which games have been demonstrated?

The author documents Gran Turismo 4 reaching races and God of War II reaching combat. Those are specific milestones, not full-playthrough verification. We have not independently run either game.

Explore the game records
What browser and hardware do I need?

The GPU renderer needs a usable WebGPU adapter. The author documents Chrome and Edge on Windows and macOS, with extra configuration on Linux. The runtime also checks shared memory and required WebAssembly features. No universal minimum hardware specification is published.

Check the browser requirements
Where can I watch the demo?

Watch the author’s 84-second Gran Turismo 4 recording directly on this page. It is a local copy of the original public recording, with its source linked below the player. This is a video, not a playable game; the reviewed README has no separate God of War II recording.

Watch the recording on this page
LEAVE A USEFUL TRAIL

Your next test could help the next player.

A precise game record, a reproducible issue, a source-backed correction. Small contributions make this field guide better.

Make a contribution

DOCUMENTATION CHECKED · UPSTREAM ebf86d3