PHPBoy
github.com
- macOS
- Linux
- Web
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.