Freedom251 › Game Boy Emulators
SDL2-GNUBoy

What SDL2-GNUBoy is
SDL2-GNUBoy is a free emulator for Game Boy and Game Boy Color, based on the GNUBoy core and focused on an SDL 2 port for input, video, and sound. It supports keyboard and gamepad controls, including joystick input and rumble. Display features include fullscreen mode, hardware rendering, scaling, and integer scaling. Release notes list BIOS support for both systems and link cable emulation for *nix. The project is available for Windows, macOS, and Linux, but packaged releases are currently offered only for Windows. Mac and Linux users can build from source; SDL2 is required, and Linux builds also require GCC. The project provides platform-specific build instructions, including a Linux Makefile and Windows cross-compilation guidance. It is licensed under GNU GPLv2. The GNUBoy emulation core is described as mostly unchanged aside from bug fixes. The latest listed release is v1.2.2-preview-1, and v1.2.2 is in development. The README records one CPU instruction failure in a cited Blargg test ROM run.
Who it suits
SDL2-GNUBoy suits people seeking a free Game Boy or Game Boy Color emulator, especially those comfortable building from source on Mac or Linux. The project also identifies its codebase as potentially useful to people learning C, SDL, or emulator development.
What it does well
- Supports Game Boy and Game Boy Color.
- Accepts keyboard and gamepad input, including rumble.
- Offers fullscreen mode and integer scaling.
- Licensed under GNU GPLv2.
- Link cable emulation is listed for *nix.
What to know first
- Packaged releases are currently only for Windows.
- Mac and Linux users must build from source.
- Building requires SDL2; Linux also requires GCC.
- README records one CPU instruction failure in a test ROM run.
Limits
Windows build stability may vary between commits. The README records failure of one CPU instruction in the cited Blargg test ROM run.
Getting started
- Open the SDL2-GNUBoy GitHub website
- Use the Windows packaged release if you are on Windows
- Install SDL2 for a source build
- Install GCC as well for Linux
- Follow the platform-specific Mac, Linux, or Windows cross-compilation instructions
- Use the included Linux Makefile when building on Linux
Verdict
SDL2-GNUBoy supports both Game Boy systems and a range of controls and display options. Mac and Linux users need to build it themselves, and the project notes a test-ROM failure.
Questions
What systems does SDL2-GNUBoy emulate?
It supports Game Boy and Game Boy Color systems.
Which platforms are supported?
The project targets Windows, macOS, and Linux, with builds compiled for x86 and ARM as well as WSL.
Is SDL2-GNUBoy free?
Yes. It has a free plan and is licensed under GNU GPLv2.
How can Mac and Linux users install it?
Packaged releases are currently only for Windows. Mac and Linux users can build from source using SDL2; Linux builds also require GCC.
Does it support controllers and link cables?
It supports keyboard and gamepad input, including joystick and rumble. Link cable emulation is listed for *nix systems.
Facts from SDL2-GNUBoy's own pages
- Build requirement
- Building requires SDL2; the README gives platform-specific build instructions for Mac, Linux, and Windows cross-compilation. · github.com, 7 Oct 2026
- Build requirements
- Building on Linux requires GCC and SDL2, and the project provides a Linux Makefile. · github.com, 8 Oct 2026
- Build stability
- The README cautions that the stability of the Windows builds provided for each commit may vary. · github.com, 8 Oct 2026
- Controls
- It supports keyboard controls and gamepads, including joystick support and rumble. · github.com, 8 Oct 2026
- Developer
- The README names Alex Oberhofer as a developer. · github.com, 8 Oct 2026
- Development status
- The repository says v1.2.2 is in development, and its latest listed release is v1.2.2-preview-1. · github.com, 7 Oct 2026
- Display
- Features include fullscreen mode, hardware rendering, scaling, and integer scaling. · github.com, 8 Oct 2026
- Display and audio
- The README lists SDL2 video and sound, fullscreen mode, and integer scaling among implemented features or release improvements. · github.com, 7 Oct 2026
- Downloads
- The README says packaged releases are currently available only for Windows and directs Linux and Mac users to build from source. · github.com, 8 Oct 2026
- Emulation
- The emulator supports Game Boy and Game Boy Color, and the project says its GNUBoy emulation core is mainly unmodified apart from bug fixes. · github.com, 7 Oct 2026
- Game Boy support
- The v1.2.2 release notes list Game Boy and Game Boy Color BIOS support. · github.com, 8 Oct 2026
- Integrations
- The README says non-zlib zip-file handling is on the to-do list. · github.com, 7 Oct 2026
- Intended audience
- The README says the codebase may help people learning C, SDL, or emulator development. · github.com, 8 Oct 2026
- Known limitation
- The README says the emulator fails one CPU instruction in the cited Blargg test ROM run. · github.com, 8 Oct 2026
- License
- The project describes itself as free software and says it is licensed under GNU GPLv2. · github.com, 8 Oct 2026
- Link cable
- The v1.2.2 release notes list link cable emulation for *nix. · github.com, 7 Oct 2026
- Mac builds
- The README says Mac builds use Clang by default and have been tested on Intel and M1 Macs. · github.com, 8 Oct 2026
- Maker
- The project lists Alex Oberhofer as its developer; his GitHub profile describes him as a software engineer in Asheville, North Carolina. · github.com, 7 Oct 2026
- Purpose
- SDL2-GNUBoy is a multiplatform emulator for Game Boy and Game Boy Color. · github.com, 8 Oct 2026
- Release status
- The v1.2.1 release description calls it probably the last release of this port for a while. · github.com, 8 Oct 2026
- SDL2 port
- The fork focuses on porting GNUBoy to SDL 2, including its input, video, and sound implementations. · github.com, 8 Oct 2026
- Supported builds
- The project says it has been compiled and tested on Windows, Mac, and Linux for x86 and ARM, as well as WSL. · github.com, 7 Oct 2026
Where SDL2-GNUBoy stands on Freedom251
- Game Boy Emulators#16 of 23