A Multiplatform Gameboy Emulator. Free Software.

GNUBoy is a cool, old piece of software. This fork focuses on a multiplatform SDL 2 port. Hopefully this codebase can be helpful to someone in the future or someone interested in learning about C, SDL, or emulator development.

Fork or contribute! Based on GNUBoy and licensed under GNU GPLv2

The latest packaged releases are available under the associated workflow. This currently is only for Windows. If you use Linux/MacOS BUILD IT!!!!

Download Versioned Releases: (https://github.com/AlexOberhofer/SDL2-GNUBoy/releases)

Builds: (https://github.com/AlexOberhofer/SDL2-GNUBoy/actions)
Note Builds only provided for windows via mingw64 for each commit
Note The stability of these builds may vary

SDL2 GNUboy pre-compiled binaries will be provided with each release. The source is also provided on the release page and the binaries can be built from the source or from this repository.

For bleeding edge SDL2-GNUBoy - build the master branch. Some stable versions also have branches to build from if need be. Otherwise check the release tab for Windows binaries or build it "the unix way" for *nix / BSD / OSX.

v1.2.2

• GameBoy and GameBoy Color Bios
• SDL video bugfixes
• Restored fullscreen toggle
• Link cable emulation (*nix)

v1.2.1

• Audio Bugfixes (No more popping noise on startup)
• Audio Interface updates
• Optional confirmation window when closing emulator session

v1.2.0

Thanks to Ryzee119 for his contributions!

• Many SDL bug fixes
• Fullscreen / RC file fixes
• Key rebinding now works
• Integer scaling (new integer_scale rc variable)
• Joystick/Gamepad rewrite (new joy_deadzone rc variable)
• Rumble Support (new joy_rumble_strength rc variable)

v1.1.1

• Joystick/Gamepad Support
• New GB classic pallette (Can be changed with rc file)
• Renderer + Keyboard bugfixes

v1.1.0

• Builds for more platforms
• CPU logic fixes
• Packaging + install scripts
• SDL2 hardware rendering + scaling

v1.0

• Supports Linux only

GB	GBC

The emulation core of GNUBoy is mainly unmodified except for a number of bugfixes I have ported into this fork.

A number of cpu buxfixes were ported from here

The emulator currently fails only one CPU instruction via blarggs test rom (Windows executable running in wine on Linux):

Improvements for v1.2.1:

• Now compiles for Apple M1 chip.
• SDL2 audio bugfixes
• Better controller support + rumble (v1.2.0)

Pokemon Pinball (Now with rumble)

SDL2GNUBoy has been compiled and tested on the following platforms:

• Windows (x86/ARM)
• Mac (x86/ARM)
• Linux (x86/ARM)
• WSL

Version 1.2.2 is in development. See the master branch for bleeding edge SDL2-GNUBoy.

(At this point - this is only a subset of what actually has been done here... but below is a sample)

• Multiplatform builds

• SDL2 input implementation

• SDL1.2 rendering ported to SDL2

• SDL1.2 sound ported to SDL2

• Porting: Emscripten?

• Add handler for zip files (non-zlib)

Sample configuration files are provided in the /rc/ directory of this repository.

Setup configuration from sample (From repository root)

$ cp ./rc/gnuboy.rc.sample ./gnuboy.rc

Example commands and color pallettes are also available in the /rc/ directory.

The following bootrom files have been tested, but others may work.

Build scripts are provided for both native unix applications and for cross compiling via mingw-w64 gcc

Build instructions are provided for both below:

See the "Linux section" except for a few differences. The Mac build uses Clang by default. Build has been tested on both Intel and M1 Macintoshes.

Installing SDL2:

$ brew install sdl2

Building Mac Binar:y

$ make osx

This project requires GCC and SDL2 to build for linux. A Makefile has been provided.

Install SDL2 development libraries (Ubuntu):

$ apt-get install libsdl2-dev

Clone github repository:

$ git clone https://github.com/AlexOberhofer/SDL2-GNUBoy.git

Enter project directory:

$ cd sdl2-gnuboy

Build:

$ make linux

Run:

$ ./sdl2gnuboy ./rom

SDL2 GNUboy can be cross compiled for Windows on Linux (or the Windows Linux Subsystem)

This requires mingw64-w64-gcc and the mingw SDL2 libraries.

These can be installed via the AUR or the SDL website (Extract and place contents in /usr/x86_64-w64-mingw32)

Install libraries (from AUR using yay)

$ yay mingw-w64-gcc

Install MinGW-w64-sdl2

$ yay mingw-w64-sdl2

Clone github repository:

$ git clone https://github.com/AlexOberhofer/SDL2-GNUBoy.git

Enter project directory:

$ cd sdl2-gnuboy

Build:

$ make windows

Run

Windows:

• Drag and drop rom over executable

(Wine):

$ wine ./sdl2gnuboy.exe ./rom

Run (cmd):

$ ./sdl2gnuboy.exe ./rom

Controls are as follows:

ESC - QUIT 

W - UP

S - DOWN

A - LEFT 

D - RIGHT 

Q - A

E - B

ENTER - START

X - SELECT

Controls are as follows (Based on Xbox 360 controller layout):

Joy/Pad Up - UP

Joy/Pad Down - DOWN

Joy/Pad Left - LEFT 

Joy/Pad Right - RIGHT 

B - A

A - B

Start - START

Back - SELECT

The GNUBoy core is extremely fast and portable. Porting documentation can be found in the docs folder.

• /lib - Library Code
• /sys - System dependent code
• /src - Core emulator logic
• /include - GNUBoy Header files
• /docs - Various docs + media from GNUBoy

Alex Oberhofer

See CREDITS for full list of contributors.

Thank you to the original GNUBoy developers. Please see the history branch for their versions. Legacy documentation can be found in the docs folder.