gbcxx

A simple Nintendo Game Boy emulator (currently only for Linux), written in C++.

Screenshots

Tetris	The Legend of Zelda: Link's Awakening	Kirby's Dream Land 2

Running

Currently, no prebuilt binaries are provided. If you wish to build the emulator yourself, scroll down for instructions.

Usage: gbcxx <path-to-rom>

Some things are still unimplemented, so you can safely ignore the error logs or suppress them with the --quiet flag.

Controls

• D-Pad: Up Down Left Right
• Start: Return
• Select: Backspace
• A: X
• B: Z

Building

Building requires a C++23 compatible Clang or GNU compiler, CMake >= 3.21 and Ninja.

Install build dependencies:

sudo apt install cmake ninja-build

Clone the repository:

git clone --recurse-submodules [email protected]:elias-ka/gbcxx.git

Configure project:

cmake --preset release

Build:

cd build/gbcxx-release && ninja