A Game Boy, Super Game Boy and Game Boy Color emulator written in C3, with SDL3 for video, sound and input.
It aims at accuracy: the CPU, timer, PPU and APU are modelled at the level the common hardware test suites check (results).
Play it in your browser: https://8lall0.github.io/wer/ (bring your own ROMs: they never leave the browser; touch controls on phones).
- Every Game Boy: DMG, Pocket, Super Game Boy 1 and 2, Game Boy Color in each chip revision, and a Game Boy Advance running Game Boy games.
- Accurate: every test of Mooneye, Mealybug Tearoom, Blargg, SameSuite, Gambatte, AGE and more passes (results).
- Nearly every cartridge: all of Nintendo's mappers with their clocks, rumble, tilt and the Game Boy Camera (through your webcam), the Nintendo Power GB Memory, and the unlicensed and bootleg boards.
- The link cable and its accessories: two or four Game Boys in one window or over the network, the Printer, the Mobile Adapter GB back online, card readers, infrared toys and more (accessories).
- Save states, rewind, fast forward, cheats, IPS/UPS/BPS patches, GIF and WAV recording, movies, a debugger; on Linux, Windows, macOS, Android and in the browser. Its own boot ROMs: no Nintendo code.
The whole list is in docs/FEATURES.md.
Linux, Windows, macOS and web builds are on the releases page. To build it, with c3c 0.8.x and SDL 3.2 or newer:
c3c build -O3 # build/werThe other platforms, the tests and the source layout are in docs/DEVELOPMENT.md.
wer game.gb # or start without a ROM and open one from the menu
wer --mode=cgb game.gbcEsc opens the menu; arrows, Z and X play. Every option, key and the debugger are in docs/USAGE.md.
| Features | what wer emulates, and its test results |
| Using wer | command-line options, controls, debugger, saves |
| Link cable and accessories | linking Game Boys, network play and every accessory |
| Building and developing | every platform's build, the tests, the source layout |
Wer began as a hand-written project. Since then it has been developed together with Claude Code, which wrote the test harnesses and a large part of the emulator (among others the pixel-by-pixel PPU, Game Boy Color support, the APU accuracy work and the boot ROMs), under the author's direction and review.
MIT.
The sound (src/apu/) is a port of SameBoy's
APU and the pixel renderer follows SameBoy's, as does the WorkBoy
(src/link/workboy.c3); those parts also carry
SameBoy's MIT licence (LICENSE-sameboy).
src/cart/tama5.c3, src/cart/sachen.c3 and src/cart/bootleg.c3 follow
mGBA's TAMA5, Sachen and bootleg mappers and are under the
Mozilla Public License 2.0 instead.
src/cart/unlicensed.c3 follows MAME's Game Boy
cartridge boards and carries its BSD 3-Clause licence
(LICENSE-mame); its table of known dumps comes from MAME's
software lists (CC0).
src/cart/hhugboy.c3 (SKOB LEE8, Pokemon 2 in 1, more bootleg signatures)
was written from a description of what hhugboy
(taizou, NewRisingSun and contributors) knows about those boards
(docs/HHUGBOY-BOARDS.md); its SKOB LEE8 and LB
multicart mappers are CC0.