Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

PHPBoy

github.com

  • macOS
  • Linux
  • Web
6.6 Club score Visit github.com

What PHPBoy is

PHPBoy is a free, open-source Game Boy Color emulator written in PHP 8.4, with support for original Game Boy software through DMG compatibility. It offers a command-line terminal frontend, a browser WebAssembly frontend, and an SDL2 desktop frontend that remains experimental. Emulation includes GBC color palettes and cartridges using MBC1, MBC3, and MBC5. The project reports 25–30 FPS without JIT and 60+ FPS with PHP JIT enabled. It passes all 11 of Blargg’s CPU instruction tests, while 10 of 39 Mooneye tests pass and more support is in progress. Browser use requires WebAssembly and works without a backend, with keyboard controls, speed adjustment, and pause/resume. The browser version is described as slow because of WebAssembly overhead. CLI audio uses SoX; browser audio is still in progress. Docker, Docker Compose, and Make are listed requirements. PHPBoy is MIT licensed.

Who it suits

PHPBoy suits users who want a PHP-based emulator for Game Boy or Game Boy Color software on Linux, macOS, or the web. It is also relevant to developers comfortable with Docker-based setup and experimental frontends.

Good to know, and what to watch

  • Free and open-source under the MIT License
  • Supports Game Boy and Game Boy Color software
  • Browser frontend runs without a backend
  • Includes CLI, WebAssembly, and SDL2 frontends
  • Supports MBC1, MBC3, and MBC5 cartridges
  • Browser version is described as slow
  • SDL2 desktop frontend is experimental
  • Browser audio output remains in progress
  • Setup requires Docker, Docker Compose, and Make

The verdict

PHPBoy combines Game Boy Color emulation with several ways to run it, including a backend-free browser frontend. Its accuracy coverage and desktop integration are still developing, so users should review the stated limitations before choosing it.

What the maker publishes

Accuracy
It passes all 11 of Blargg’s CPU instruction tests; 10 of 39 Mooneye tests pass, with further support in progress. source
Accuracy
The project reports passing all 11 Blargg CPU instruction tests, while 10 of 39 Mooneye tests pass and Acid test support is in progress. source
Audio
The CLI frontend supports audio using SoX, while browser audio output is in progress. source
Audio
The CLI frontend supports audio playback using SoX, while browser audio integration is still in progress. source
Browser limits
The README describes the browser version as slow due to WebAssembly overhead and lists Chrome 90+, Firefox 88+, Safari 14+, or Edge 90+ with WebAssembly support. source
Browser requirements
The WebAssembly frontend requires a browser with WebAssembly support; listed browser versions are Chrome 90+, Firefox 88+, Safari 14+, or Edge 90+. source
Browser use
The WebAssembly version runs in a browser without a backend and supports keyboard controls, speed control, and pause/resume. source
Cartridges
Its cartridge support includes MBC1, MBC3, and MBC5. source
Cartridges
Its cartridge support includes MBC1, MBC3, and MBC5. source
Dependencies
The documented setup requires Docker, Docker Compose, and Make, with SoX needed for CLI audio playback. source
Desktop status
The SDL2 desktop frontend is experimental and is not fully tested or integrated. source
Development tools
The project describes a Docker-based development workflow using PHPUnit 10 and PHPStan level 9. source
Emulation
The emulator supports GBC color palettes and DMG backward compatibility. source
Emulation
The emulator supports GBC color palettes, VRAM bank switching, DMG compatibility, and automatic colorization of original Game Boy games. source
Frontends
It provides a CLI terminal frontend, a browser WebAssembly frontend, and an SDL2 desktop frontend that is still a work in progress. source
Frontends
It offers a CLI terminal frontend, a browser WebAssembly frontend, and an SDL2 native desktop frontend that is marked work in progress. source
License
The repository is released under the MIT License. source
License
PHPBoy is distributed under the MIT License, which permits use, copying, modification, distribution, sublicensing, and sale subject to its stated conditions. source
Maker
The GitHub profile identifies the maker as Edd Mann and lists London, UK. source
Maker
The GitHub profile identifies the maker as Edd Mann and lists London, UK as the location. source
Performance
The README reports 25–30 FPS without JIT and 60+ FPS with PHP JIT enabled. source
Performance
The README reports 25–30 FPS without JIT and 60+ FPS with PHP 8.4 JIT enabled. source
Product
PHPBoy is a Game Boy Color emulator written in PHP 8.4 with backward compatibility for original Game Boy games. source
Purpose
PHPBoy is a Game Boy Color emulator written in PHP 8.4 with backward compatibility for original Game Boy games. source

Checked against the maker's pages on 9 Oct 2026.