YOUR DISC. TWO DIFFERENT ROUTES.

Your PS2 games.
Your browser.
Choose your route.

Try direct emulation with Play!.js, or build a game locally with PS2 Web Recomp. These are separate projects with different compatibility.

New here? Follow the beginner guide

The local launcher does not upload your files.

01 / PLAY!.JS · EMULATION

Play ISO Directly (Experimental)

Compile first?
No. Select a local game file.
Files
ISO, CSO, CHD, ISZ, BIN, ELF
Requirements
Current desktop Chrome / Edge for embedding. No terminal, build tools or BIOS file.
01 YOUR OWN DISC→02 CHOOSE A PLAYER→03 BROWSER PLAYPOWERED BY WEBASSEMBLY

ROUTE 01 / DIRECT EMULATION

Your disc. No compilation.

PLAY!.JS · EXPERIMENTAL

Open the official Play!.js emulator here, then choose a game file from your device. No compiled build or BIOS file is needed.

  1. Open the player below.
  2. Wait for its file chooser, then select your own disc image.
  3. Click the game screen to use the keyboard.

Supports ISO, CSO, CHD, ISZ, BIN and ELF. No games are included. Play!.js has its own compatibility limits; the GT4 and God of War II demonstrations below apply to PS2 Web Recomp.

Open official player in a new tab ↗

Use a current desktop Chrome or Edge here. In Firefox, open the official player in a new tab. Game compatibility and speed vary.

Play! compatibility reports ↗

Desktop compatibility reports do not guarantee browser support.

THE STARTING LINEUP

Two classics. New territory.

UPSTREAM DEMONSTRATIONS 02

These games have been demonstrated by the engine’s creator. No independent game tests are recorded here. Search compatibility records →

Gran Turismo 4

Developer demo

From the first green light to the last corner. The project’s original showcase, demonstrated with a PAL release.

RacingWebGPULocal build required

God of War II

Developer demo

A second journey for the recompilation engine, demonstrated from menus and cutscenes into combat.

Action–adventureWebGPULocal build required

Original illustrations, not gameplay screenshots. Compatibility varies by game release and device. Read the upstream report ↗

YOUR PERSONAL CONSOLE

Load up. Settle in.

LOCAL FILES ONLY

Your game

SETUP / 00

Select the files you compiled, then the same disc image used for that build.

01

Compiled web build

Select ps2web.html, .js, .wasm and .data together.

○
02

Matching disc image

Your original .iso file. Read locally, never uploaded.

○

File selection or launch help →

Select both files above to prepare your session.

Need a build? Follow the setup guide for your operating system. Imported HTML / JavaScript runs with this site’s privileges. Only load builds you created or trust. Read the trust and file-handling details.

ROUTE 02 / LOCAL RECOMPILATION

Make it your build.

LOCAL COMPILATION

The open-source toolchain turns your game’s executable into WebAssembly. This helper prepares the commands; the compilation runs on your computer.

First build? Install the tools using your OS guide. Windows / WSL2 is a reference route, not tested here or listed as tested upstream. macOS requires Homebrew Bash 4+.

YOUR BUILD IN THREE STEPS
Before you compile

Install Git, CMake, Ninja, Python 3 and a C++20 compiler. The upstream build installs Emscripten on its first run and downloads wgpu-native. Allow space for the disc and generated builds.

The helper pins upstream revision f3a550b for reproducibility. New games may hit unimplemented features; successful compilation alone does not guarantee playability.

START HERE

From your first command to your first launch.

Choose your operating system for setup, project download, compilation and loading instructions. Includes screenshots and fixes for common errors.

01 / WINDOWS

Ubuntu inside WSL2.

Separate PowerShell and Ubuntu steps, Windows disc paths and opening the output folder. Reference route; not tested here.

Windows guide →
02 / MACOS

Apple silicon + Homebrew.

Install Command Line Tools and a modern Bash, then build and find your output in Finder. Intel Macs are outside this guide.

macOS guide →
03 / LINUX

A native Linux toolchain.

Ubuntu / Debian commands for dependencies, your ISO path and compiling locally. Upstream reports Linux x86-64 runs.

Linux guide →

GOOD TO KNOW

A few things
before you start.

Explore the original project ↗
Can I play without compiling a game first?+

The experimental Play!.js player loads your own disc image directly. It is a separate emulator with different compatibility and performance. The PS2 Web Recomp launcher requires a compiled build and matching ISO. Gran Turismo 4 and God of War II are demonstrations of that recompilation engine, not verified Play!.js games. Neither option guarantees every PS2 game will work.

Are Gran Turismo 4 and God of War II open source?+

No. The PS2 Web Recomp engine is open source. The games are commercial titles and are not included here. Their compiled code remains game-derived content. Use your own files privately; see the upstream publishing guidance.

What happens to my files and saves?+

For PS2 Web Recomp, the launcher keeps references to selected files for this tab’s session and does not upload them. Reloading requires selecting them again. The upstream build stores its memory card in this browser’s storage for this website. Use its Export card button to back up saves before clearing browser data or changing browsers. Imported builds execute code, so use builds you created or trust. Play!.js handles files inside its separate player. Its embedded session uses temporary storage and does not share saves with the official standalone page; do not rely on saves surviving a reload.

Which browser should I use?+

For embedded Play!.js, use a current desktop Chrome or Edge. Firefox users can open the official player in a new tab. Its own file chooser appears after the emulator loads. For PS2 Web Recomp, use a current desktop Chrome or Edge and run the browser check above; this engine needs cross-origin isolation, WebAssembly JSPI, exception handling, tail calls and SIMD. WebGPU is strongly recommended for its 3D gameplay. Support depends on your browser, operating system and GPU.

What are the PS2 Web Recomp keyboard controls?+
Cross / CircleZ XSquare / TriangleA SStart / SelectEnter BackspaceD-pad↑ ← ↓ →Left stickI J K LShoulder buttonsQ W 1 2FullscreenF

Click inside the game first. These are PS2 Web Recomp defaults; gamepads are handled by the build. Play!.js shows its own control table inside its player.