User Experience on mobile might not be great yet, but I'm working on it.

Your first time on this page? Allow me to give some explanations.

Awesome Game Boy Development

A curated list of Game Boy development resources such as tools, docs, emulators, related projects and open-source ROMs.

Here you can see meta information about this topic like the time we last updated this page, the original creator of the awesome list and a link to the original GitHub repository.

Last Update: Nov. 29, 2021, 3 p.m.

Thank you gbdev & contributors
View Topic on GitHub:
gbdev/awesome-gbdev

Search for resources by name or description.
Simply type in what you are looking for and the results will be filtered on the fly.

Further filter the resources on this page by type (repository/other resource), number of stars on GitHub and time of last commit in months.

Introduction

Community

Documentation

A GB, GBC and GBA emulator with GB Camera support.

151
9
119d
GPL-2.0

emulator (on a Terasic DE1-SoC Board) developed as final project for the CSEE4840 Embedded Systems Design course at Columbia University.

Opcodes

Game Boy Color

Hardware

Game Boy -related custom hardware by gekkio

159
15
9m
CC-BY-4.0

Your go to dev board for Gameboy accessories development, powered by ESP8266.

14
3
1y 47d
MIT

A device that emulates the Gameboy Printer and lets you retrieve images using WIFI

32
5
1y 49d
n/a

Reverse-engineered schematics for DMG-CPU-B

258
18
1y 0d
CC-BY-SA-4.0

Peripherals

Cartridges

Custom cartridges

Eagle library, schematic, and board files for a Homebrew Gameboy Cartridge PCB.

93
14
1y 9m
n/a

Board layout for an eeprom powered GB cartridge

55
9
6m
Unlicense

Open-source Gameboy Flash Cartridge using an Xilinx CPLD as MBC

58
13
10m
n/a

Gameboy CPLD implementation of MBC5/MBC1 Hybrid

26
3
2y 5m
n/a

Misc

Emulator Development

Testing

A suite of Game Boy tests, used for hardware research and emulator testing

20
6
87d
MIT

Game Boy emulator test ROMs

32
3
11m
MIT

Size-optimized ports of Artemio's 240p Test Suite to 8-bit consoles

80
4
53d
GPL-2.0

MBC3 RTC test for Game Boy flash carts and emulators

15
3
12m
Unlicense

😀 The Acid2 test, now for the original Game Boy! 😀

67
1
1y 7m
MIT

Assemblers

Rednex Game Boy Development System - An assembly toolchain for the Nintendo Game Boy & Game Boy Color

856
120
29d
MIT

Powerful macro (cross) assembler package for several CPUs

34
6
68d
GPL-3.0

WLA DX - Yet Another GB-Z80/Z80/6502/65C02/65CE02/6510/65816/6800/6801/6809/8008/8080/HUC6280/SPC-700/SuperFX Multi Platform Cross Assembler Package

432
71
44d
GPL-2.0

Compilers

Experimental/Proof of Concepts

A high-level assembly language for writing homebrew software and games on retro console platforms.

318
20
95d
n/a

👾 A Forth-based Game Boy development kit

86
6
1y 49d
MIT

A JavaScript based Gameboy Assembler

125
7
3y 6m
MIT

Assembler for Gameboy games

110
5
40d
n/a

LLVM port to the GBZ80 CPU

34
1
3y 42d
n/a

Experimental Go binding for GBDK(GameBoy Development Kit). You can develop GameBoy software using Go!

17
2
1y 23d
MIT

Emulators

Game Boy and Game Boy Color emulator written in C

885
119
27d
MIT

A Game Boy research project and emulator written in Rust

696
33
7m
GPL-3.0

mGBA Game Boy Advance Emulator

3.11K
459
29d
MPL-2.0

Gameboy emulator implemented in C, that also runs in the browser

301
29
41d
MIT
382
83
4m
n/a

A repository of gate-level simulators and tools for the original Game Boy.

917
19
35d
n/a

DMG/GBC/GBA emulator and experimental NDS emulator.

317
25
37d
GPL-2.0

Engines

Game Boy / Color engine with lots of features

451
27
28d
MIT

Development tools

A small set of sources and tools for the Gameboy Development Kit by Michael Hope

11
1
8y 117d
MIT

Game Boy ROM disassembler with RGBDS compatible output

149
14
9m
MIT

A small command line tool for estimating usage of Game Boy ROMs from map file output

10
4
115d
Unlicense

Gameboy decompiler

49
13
7y 10m
GPL-3.0

Set of tools for text manipulation and translation of Game Boy ROMs

7
2
3y 12m
n/a

Graphics utilities

Gameboy Tile Data Generator

69
21
5y 17d
n/a

Allows files created by Harry Mulder's Game Boy Map Builder and Game Boy Tile Designer to be converted in to different file formats for use in Game Boy game development (e.g.: with GBDK)

14
2
5y 7m
MIT

Convert graphics for GameBoy Color development and adjust palette on real hardware to achieve best results.

20
3
9m
GPL-3.0

A simple command line image file to game boy .c array converter

17
7
6y 4m
GPL-2.0

Gameboy tile conversion and map editor tool

24
6
4m
MIT

A simple GameBoy tile editor written in C using ncurses

23
5
6m
MIT

TPP1 specification

14
3
6m
n/a

C library of useful Game Boy operations

10
1
114d
n/a

Tilemap GB - Console App - AND - GIMP plugin for importing & exporting Game Boy game tilemaps and tilesets (as bitmap images or .GBM/.GBR files. Related tools: GBTD, GBMB, GBDK, Zal0-ZGB)

33
2
4m
GPL-3.0

Tilemap Helper : A GIMP plugin to help with creating tile maps and tile sets for games

15
2
1y 19d
GPL-3.0

A tilemap editor for Game Boy, Color, Advance, DS, and SNES projects. Written in C++ with FLTK.

153
12
29d
LGPL-3.0

Flexible and composable tile graphics converter supporting Super Nintendo, Game Boy, Game Boy Color, Game Boy Advance, Mega Drive and PC Engine formats.

74
9
7m
MIT

Hardware and ROM utilities

Gameboy ROM for cartridge dumping

21
2
3y 4m
n/a

Extracts photos from Game Boy Camera saves.

33
4
1y 72d
MIT

👃 Crack open your old Game Boy and peek at the LCD data bus.

132
6
4y 112d
CC-BY-SA-4.0

super swap & dump multi new 2015

1
2
5y 4m
n/a

Gameboy LinkUp serial cable networking project

6
1
8y 7m
n/a

Music drivers and trackers

Game Boy sound driver

45
3
2y 8d
MIT

A music player library for Game Boy.

201
18
4m
MIT

MML to Game Boy parser and driver

30
4
2y 4m
MIT

fork/continuation of http://jiggawatt.org/muzak/xpmck/ Release 32 with bugfixes and new features

17
5
5y 7m
n/a

A system-wide refactor (modernization) of the GameBoy Tracker (aka the Paragon 5) replayer created by Stephane Hockenhull.

0
1
84d
n/a

The music composition suite for the Nintendo Game Boy

120
11
44d
n/a

Simple Game Boy sound effect driver natively compatible with GBDK-2020.

1
0
62d
MIT

ASM

Sources

Game Boy assembly projects

13
2
4y 9m
Unlicense

An assembly tutorial for Game Boy showing how the scroll registers can be exploited to create some nice and interesting effects.

0
0
7m
Unlicense

Timings

Boilerplates and libraries

Basic hello-world example for GameBoy using rgbds

32
6
6y 10m
n/a
30
0
3y 9m
n/a

Gameboy boilerplate to get started quickly

25
5
1y 4m
MIT

A library with some standard functions for Game Boy games written in ASM

93
13
10m
Unlicense

A very powerful Variable-Width Font engine for the Game Boy & Game Boy Color.

20
1
4m
MIT

A minimal, customizable, ready-to-compile boilerplate for Game Boy RGBDS projects.

40
3
91d
MIT

A customizable and ready-to-compile bundle for Game Boy RGBDS projects. Contains your bread and butter, guaranteed 100% kitchen sink-free.

21
5
91d
MIT

A template project the Gameboy DMG/Color

0
0
3y 6m
MIT

Syntax highlighting packages

A collection of syntax highlighting files for Game Boy assembly

5
3
6m
n/a

My dotfiles

7
3
60d
n/a

Z80 Assembly support for Visual Studio Code

22
6
11m
MIT

Visual Studio Code language extension for RGBDS GBZ80 Assembly

46
6
5m
MIT

rgbds assembly mode for GNU Emacs

3
3
2y 11m
GPL-3.0

C

Homebrews

ASM

Tuff - An original game for the Nintendo GameBoy

299
11
3y 35d
n/a

a gameboy (and SMS) port of 2048

86
7
6y 9m
Zlib

Game Boy homebrew game featuring Pong and lasers

13
2
6y 7m
n/a

A puzzle game for GB and GBC.

24
3
3y 9m
n/a

The open-source city-building game for Game Boy Color.

316
11
1y 18d
n/a

Gameboy platformer written in assembly

16
3
2y 81d
GPL-3.0

A version of Snake for Game Boy

15
2
8m
n/a

GB303 wavetable-based TB-303 style synthesizer for the Nintendo Gameboy.

85
10
3y 11m
n/a

IGJam 2017 game

3
1
4y 10m
n/a

Flappy Bird clone made for the Game Boy.

79
13
1y 97d
n/a
4
1
4y 26d
n/a

Block dropping puzzle game for Game Boy

11
3
2y 91d
CC0-1.0

A Gameboy game, My Ludum Dare 38 entry

26
3
4m
n/a

A RPG for the Game Boy Color -- WARNING: code base is very broken, I do not recommend re-using any code from here

52
5
2y 10m
Apache-2.0

Gameboy development examples and tools

21
2
2y 11m
Unlicense

Pokémon Red/Blue overhauled with full GBC support. Made by FroggestSpirit, Drenn, and myself.

88
30
7m
n/a

ToyToy - GBC ( 8 bit 8080-like assembly)

9
1
3y 10m
GPL-3.0

StefaN - GBC ( 8 bit 8080-like assembly)

3
1
4y 7m
GPL-3.0

Galaxia - GBC ( 8 bit 8080-like assembly)

3
1
3y 9m
GPL-3.0

DES encryption on Game Boy

12
2
3y 8m
n/a

Action/Adventure game being built for that old grey Gameboy sitting in your attic.

4
1
1y 9m
GPL-2.0

minesweeper for the GameBoy (Color compatible), written in assembly

6
1
3y 11m
GPL-3.0

Libbet and the Magic Floor - a puzzle game for Game Boy

26
2
32d
Zlib

Game Boy Wave Form Visualizer

17
1
9m
n/a

A Gameboy DMG game written in z80 asm for LudumDare

0
0
3y 6m
MIT

C

Flappy Bird clone for the Game Boy.

20
3
6y 8m
MIT

Yet another flappybird for gameboy

9
2
4y 6m
n/a
3
1
3y 10m
n/a

Puzzle game created in 48 hours for Ludum Dare

8
1
3y 11m
MIT

a Snake clone for Game Boy

12
2
2y 4m
GPL-3.0

A sample game for Gameboy created with gbdk, gbdk-lib-extension and GB Lemon tracker LP1.297a.

25
2
5y 7m
MIT

Our entry for the gbjam 2016

22
5
44d
n/a

Snake game for Nintendo Gameboy written in C

25
4
4y 7m
n/a

Minesweeper for the Nintendo Gameboy

24
3
3y 6m
n/a

Game Boy game made for the BitBitJam3 during a week

5
1
5y 5m
n/a

Bubble Factory for Game Boy

22
4
7m
n/a

Atari 2600 Boxing clone for the Game Boy (Color)

2
1
4y 51d
n/a

This is a repository for really old programming experiments of mine

11
4
4y 29d
Apache-2.0

An arcade platformer homebrew game for the Game Boy, Game Boy Color and Super Game Boy

41
5
2y 22d
MIT

Post Bot game for classic gameboy

7
3
1y 59d
MIT

A new game for Game Boy made with GDSK.

9
2
5y 6m
GPL-3.0

A gameboy game written in C using GBDK based on the modern classic Chrome offline game

50
5
1y 5m
n/a

Game Boy port of Google Chrome's Dino browser game

13
1
1y 9m
MIT

A fan-made demake of Evoland on GameBoy

25
4
2y 7m
n/a

A puzzle game for the Game Boy Color (CGB). Build pets in all shapes and sizes, keep the board clear.

16
1
5m
n/a

Infinity GBC

5
0
7m
n/a

GB Studio

Demos

Back to Color, a GBC demo for the GBDev 2014 compo.

22
5
1y 64d
n/a

Beach (GameBoy Color demo)

12
1
2y 102d
n/a

A Cute Demo for the GameBoy Color

28
3
1y 5m
GPL-3.0

🖨 Port of a famous C64 BASIC one-liner to the Game Boy.

16
2
3y 4m
MIT

Game Boy demo for Skrolli Party 2017.

22
1
3y 8m
n/a

Matrix digital rain effect for the Game Boy

20
1
4m
n/a
70
5
3y 9m
MIT

A new version of GBVideoPlayer with higher resolution, 3-bit stereo PCM audio and video compression

43
6
2y 29d
MIT

Reverse Engineering

Game Disassemblies

Disassembly of Pokémon Red/Blue

2.87K
532
27d
n/a

Disassembly of Pokémon Crystal

1.52K
476
27d
n/a

Disassembly of Pokemon Yellow

426
139
28d
n/a

Disassembly of Pokémon Gold/Silver

254
61
27d
n/a

Disassembly of Pokémon Pinball

87
26
53d
n/a

Disassembly of Pokémon TCG

141
44
32d
n/a

Disassembly of the Pokémon Gold and Silver 1997 Space World demo

254
40
53d
n/a

Disassembly of Legend of Zelda: Links Awakening DX

320
42
37d
n/a

Disassembly of Oracle of Ages and Seasons

93
20
64d
n/a

Disassembly of FX Hammer by Aleksi Eeben

4
1
3y 4m
GPL-3.0

Harvest Moon 3 GBC partial disassembly

14
1
3y 7m
n/a

Retrieving images

Code to emulate a gameboy printer via the gameboy link cable

195
22
43d
GPL-3.0

A device that emulates the Gameboy Printer and lets you retrieve images using WIFI

32
5
1y 49d
n/a

A GameBoy printer emulator which provides the received data over a wifi-connection.

29
5
109d
n/a

Game Boy Printer interface shield for D1 mini/mini Pro ESP8266 boards.

10
2
91d
n/a

Sniff packet Communications Between Real Gameboy And Real Gameboy Printer

3
0
103d
GPL-3.0

Changing the camera's behavior

Post processing

Project by Raphaël BOICHOT for Game Boy Printer emulator with e-paper feature and 100% games support !

30
0
52d
GPL-3.0

Gameboy Printer Web

19
3
26d
MIT

Related projects

Official ArduinoBoy Repository for serial MIDI communication to the Nintendo Gameboy.

193
36
1y 14d
GPL-2.0

Game Boy Classic fully functional FPGA implementation from scratch

11
12
4y 4m
GPL-2.0

Implementation Nintendo's GameBoy console on an FPGA

82
12
5y 82d
MIT

A LUA driven AI that plays classic gameboy color games using experimentation.

42
6
6y 11m
AGPL-3.0

A Game Boy Sound System player for macOS, written in Swift

37
5
4y 5m
MIT

mGB - Nintendo Gameboy MIDI control for Arduinoboy

142
23
1y 91d
GPL-2.0
24
2
4y 7m
n/a

Arduino based Game Boy cartridge reader and writer. It can dump ROM and RAM to SD card.

103
10
1y 7m
n/a

Implementation of a brainfuck interpreter written for the Game Boy.

15
3
4y 10m
n/a

Brainf*ck Interpreter for GameBoy

2
1
3y 4m
MIT

Patches to add save state support to Game Boy games when playing on the original hardware

53
5
48d
MIT

A CPU and peripherals implementing the Gameboy (TM) instruction set and functionality

8
2
8y 7m
n/a

Library for working with the LSDj save file format

62
6
1y 3d
MIT

LSDj Patcher

94
9
60d
n/a

Messing around with some video effects on the gameboy.

4
1
3y 8m
n/a

A basic operating system for the Game Boy. Because I can.

16
3
2y 67d
n/a

Gameboy link cable breakout PCB

48
3
3y 6m
n/a

Interface for Nintendo® Game Boy® Cartridges

22
10
2y 6m
n/a

A Pi emulating a GameBoy sounds cheap. What about an FPGA?

327
45
10m
n/a

Lo-Fi portable video recorder using a GameBoy Camera cartridge.

58
5
4m
n/a

Read ROM, Read RAM or Write RAM from/to a Gameboy Cartridge. (License CC-BY)

38
9
5y 4m
n/a

A device for reading game ROMs, backing up & restoring saves and flashing re-writable flash carts for GB, GBC and GBA carts from your PC via USB. Jump on our Discord server (http://discord.gg/X2wS8eh). License CC-BY-NC-SA

57
26
5m
n/a

Directories

Salvaged websites, articles, contributions, text and docs

15
1
69d
n/a

Websites