awesome-gbdev
A curated list of Game Boy development resources such as tools, docs, emulators, related projects and open-source ROMs.
https://github.com/gbdev/awesome-gbdev
Last synced: 16 days ago
JSON representation
-
About
-
Acknowledgements
-
Sponsors
-
-
Community
-
Documentation
-
Cartridges
- AntonioND's docs - Corrected schematics and infos on cartridge header data.
- Gekkio's Game Boy cartridge types - An overview on existing cartridge types.
- DMG-BEAN-02
- MBC1
- no MBC
- MBC1
- MBC2
- MMM01
- Game Boy Cartridges Schematics - Schematics for MBC2 and MBC3 types.
- Cartridges PCB photos
- MBC1+RAM+Battery cartridge Schematic - First schematics by Jeff Frohwein.
- MBC1 and MBC2 cartridges circuits - and explanation on how these MBC bank switch and control RAM.
- Game Boy cartridge PCB photos
- Emulating a GameBoy Cartridge - Emulating the functionality of a Game Boy cartridge with the development board STM32F4.
- Wolf - Game Boy cartridge with co-processor.
- Reiner Ziegler's Game Boy page - Commercial and homemade programmable cartridges and programming systems. Tutorials, wiring and schematics provided.
- Introduction to Game Boy Hacking - Workshop introducing basic assembly, debugging and reverse engineering.
- GBSOUND.txt - A document detailing the Game Boy sound engine.
- gbdev FAQs - Must read by Jeff Frohwein.
- Game Boy Bootrom - Commented dump of the DMG bootrom.
- Differences between the Z80 and the gameboy's processor
- Gameboy 2BPP Graphics Format - Information on how the Game Boy interprets VRAM tile data to color pixels.
- GB Flash Cartridges for Sale - A List of available, ready-made Game Boy Flash Cartridges.
- Game Boy Cartridges Schematics - Schematics for MBC2 and MBC3 types.
- MBC1+RAM+Battery cartridge Schematic - First schematics by Jeff Frohwein.
- MBC1 and MBC2 cartridges circuits - and explanation on how these MBC bank switch and control RAM.
- Wolf - Game Boy cartridge with co-processor.
- Homebrew-Gameboy-Cartridge - Eagle library, schematic, and board files for a cartridge PCB using an Atmel AT49F040 as ROM.
- Homebrew Gameboy Color Cartridge - Board layout for an EEPROM powered cartridge.
- Nekocart - Open-source flash cartridge using an Xilinx CPLD as MBC5 ([Post](https://hackaday.io/project/41160-nekocart-cpld-gameboy-cartridge)).
- Reiner Ziegler's Game Boy page - Commercial and homemade programmable cartridges and programming systems. Tutorials, wiring and schematics provided.
- Gameboy-MBC5-MBC1-Hybrid - CPLD implementation of a MBC5/MBC1 Hybrid cartridge.
- Introduction to Game Boy Hacking - Workshop introducing basic assembly, debugging and reverse engineering.
- gbdev FAQs - Must read by Jeff Frohwein.
- Differences between the Z80 and the gameboy's processor
-
Game Boy Color
- Bootstrap ROM
- Unused Palettes
- Colorization palettes in the BIOS
- Boot ROM Disassembly
- GBC Hicolour notes - A technical note regarding Hicolour mode trick for Game Boy Color and its realization in the GBC game “Crystalis”.
- Colorization palettes in the BIOS
-
Hardware
- DMG Schematics - Hardware schematics.
- The Game Boy Project - Provides a study on the hardware and detailed constructional information for the implementation of three 8-bit bidirectional parallel ports.
- fruttenboel - Page with loads of information on the hardware, custom boards to interface with the console and other related projects.
- Game Boy hardware database - Data and photos of various types of Game Boy consoles.
- The Game Boy Project - Provides a study on the hardware and detailed constructional information for the implementation of three 8-bit bidirectional parallel ports.
- Related custom hardware - by Gekkio.
- ESP8266 GB Dev Board - Dev board for Game Boy accessories development, powered by ESP8266.
- ESP8266 GB Printer - A device that emulates the GB Printer and lets you retrieve images using WiFi.
- dmg-schematics - Schematics and annotated overlay for the DMG-CPU B chip, extracted from die photos, made with KiCad. Also contains Electric VLSI library with layouts for some of the cells and memories.
-
Peripherals
- Dan Docs - Obscure Game Boy hardware documentation.
- Edge of Emulation - plus/tree/master/src/docs/technical) in the GBE- emulator documentation.
- Mobile Adapter GB - Internet connectivity and DLC on the Game Boy Color.
- The Game Boy Printer - An in-depth technical document about the printer hardware, the communication protocol and the usual routine that games used for implementing the print feature.
- Pocket Sonar - A blue cart with built-in sonar hardware.
- Zok Zok Heroes - Zok Zok Heroes' Full Changer, a motion-activated accessory.
- Infrared Madness - Infrared communication on the Game Boy Color.
- Game Boy 4-Player Adapter - DMG-07.
- Barcode Boy - The first Game Boy card-scanner.
- Barcode Taisen Bardigun - A late 90s DMG-GBC barcode reader.
- DMG-07 Technical Documentation
- Creating photo realistic images with neural networks and a Gameboy Camera
- Ben Heck Reverse Engineers Game Boy Printer
- Mobile Game Boy Adapter
- GB KISS LINK MODEM
- Game Boy Camera RE - Documentation about GB Camera and tools used to reverse engineer it by using Arduino.
- Creating photo realistic images with neural networks and a Gameboy Camera
- Arduino Game Boy Printer Emulator - Emulating a Game Boy Printer via the Game Boy Link cable with an Arduino.
- GB KISS LINK MODEM
-
- **Pan Docs** - The single, most comprehensive technical reference to Game Boy available to the public. Corrected, updated and maintained by the community.
- The Cycle-Accurate Game Boy Docs - A precise documentation by AntonioND to make a cycle-accurate Game Boy emulator.
- Complete Technical Reference - by Gekkio.
- Game Boy Architecture: A Practical Analysis - by Rodrigo Copetti.
- Game Boy Project Report - Report of an hardware [emulator](https://github.com/kitsuneh/SVGameBoy) (on a Terasic DE1-SoC Board) developed as final project for the CSEE4840 Embedded Systems Design course at Columbia University.
- gb-opcodes - Opcodes table
- RGBDS opcodes reference - A reference of all instructions, including short descriptions, cycle and byte counts, and explanations of flag modifications.
- Game Boy Architecture: A Practical Analysis - by Rodrigo Copetti.
- Game Boy Project Report - Report of an hardware [emulator](https://github.com/kitsuneh/SVGameBoy) (on a Terasic DE1-SoC Board) developed as final project for the CSEE4840 Embedded Systems Design course at Columbia University.
-
-
Emulator Development
-
Cartridges
- Reverse Engineering fine details of Game Boy hardware - 43 minutes talk by Gekkio given at Disobey 2018 ([errata](https://gekkio.fi/blog/2018-02-05-errata-for-reverse-engineering-fine-details-of-game-boy-hardware.html)).
- Emulation of Nintendo Game Boy - Overview of the Game Boy hardware with the perspective of building an emulator.
- DMG-01 - An educational Gameboy Emulator in Rust and a companion book explaining its development. *[Oh Boy! Creating a Game Boy Emulator in Rust](https://media.ccc.de/v/rustfest-rome-3-gameboy-emulator)- is a talk given at Rust Fest 18 about this.
- Writing a Game Boy emulator, Cinoop
- 0dmg - Learning Rust by building a partial Game Boy emulator.
- RealBoy Emulator - A series of posts about the design and implementation of the RealBoy Emulator.
- Codeslinger - Another series of posts documenting the building of an emulator.
- Why did I spend 1.5 months creating a Gameboy emulator? - Blog post.
- binjgb rewind - Implementing a *rewind- feature.
- binjgb on the web - Porting of the binjgb emulator to Web Assembly. [(Part 2)](https://binji.github.io/2017/02/27/binjgb-on-the-web-part-2.html)
- binjgb debugging hangs - Investigations on emulations quirks.
- Decoding Gameboy Z80 opcodes - How to algorithmically decode Game Boy instructions (as opposed to writing one huge switch-case statement).
- Porting a GO Game Boy emulator to WebAssembly
- About swotGB - Notes about the development of a Game Boy emulator in JavaScript.
- Codeslinger - Another series of posts documenting the building of an emulator.
- Why did I spend 1.5 months creating a Gameboy emulator? - Blog post.
- Decoding Gameboy Z80 opcodes - How to algorithmically decode Game Boy instructions (as opposed to writing one huge switch-case statement).
- Game Boy Doctor - A command line tool for comparing logs from your emulator to those from a known-correct one. Useful for line-by-line debugging of Blargg's test ROMs.
-
Testing
- Blargg's test roms
- Gekkio's test roms
- GB Accuracy Tests
- 144p Test Suite - Port of Artemio Urbina's 240p Test Suite to the Game Boy.
- SameSuite
- Mealybug Tearoom Tests
- MBC3 RTC test ROM
- dmg-acid2 - acid2](https://github.com/mattcurrie/cgb-acid2) - Basic PPU rendering tests.
-
-
Game Boy Camera
-
Changing the camera's behavior
-
Post processing
- Game Boy Printer Web - Gallery app for to the Game Boy camera: import pictures from exports or cartridge dumps and choose color palettes.
-
Retrieving images
- WiFi GBP Emulator - A GameBoy printer emulator which provides the received data over a WiFi connection.
- Game Boy WiFi Printer - D1 Mini Shield - Game Boy Printer interface shield for D1 mini/mini Pro ESP8266 boards.
- Game Boy Printer Sniffer - Sniff packet communications between a Game Boy and the Printer.
-
-
Homebrews
-
ASM
- Snake
- Death Planet
- Quartet - Puzzle game for the Game Boy (Color) and Super Game Boy.
- Dangan
- exeman
- Tuff
- 2048-gb
- Lazerpong
- Geometrix
- µCity
- Carazu
- Snake-gb
- GB303 - GB303 wavetable-based TB-303 style synthesizer for the Nintendo Game Boy.
- Sushi
- Flappy-boy-asm
- kupman
- Adjustris
- exeman
- Aevilia
- GBSlides - A simple Game Boy Powerpoint-like slides viewer.
- Pokered-gbc - Pokémon Red remade with full GBC support.
- ToyToy
- StefaN - Fourway Breakout clone.
- Galaxia
- desgb - DES encryption.
- superhappyfunbubbletime
- minesweepGB
- Libbet and the Magic Floor
- waveform-gb - Program visualizing the wave form used by the wave channel. The wave form can be edited freely and playback of the wave is updated immediately.
- vectroid.gb - Developed with gbasm.
- PlantBoy
-
C
- Homebrew Hub - A community-led attempt to collect, archive and preserve every unlicensed and homebrew game released for Game Boy. Entries are playable online.
- Novascape
- oranges
- loderunner
- Hives
- GB raycaster, Vision-8 - and some other projects.
- Burly Bear vs. The Mean Foxes - color-burly-bear.html) port)
- Black Castle - Side scrolling platformer for the Game Boy ([itch.io](https://user0x7f.itch.io/black-castle)).
- Genesis - Shmup for the Game Boy ([itch.io](https://user0x7f.itch.io/genesis)).
- Indestructo Tank!
- Super JetPak DX
- Powa! - Side scrolling platformer for the Game Boy (Color) ([ZGB engine](https://github.com/Zal0/ZGB/)).
- Cavern - ([ZGB engine](https://github.com/Zal0/ZGB/)).
- Mona and the Witch's Hat Deluxe - ([ZGB engine](https://github.com/Zal0/ZGB/)).
- The Bouncing Ball
- DMG Deals Damage
- FlappyBoy
- flappybird-gameboy
- fbgb
- Squishy the Turtle
- Quadratino
- Doctor How
- Super Princess' 2092 Exodus - ([ZGB engine](https://github.com/Zal0/ZGB/)).
- GBsnake
- gb-mines
- oranges
- red hot princess carnage
- Bubble Factory - *Vanilla- SDCC (no gbdk).
- GBC Atari Boxing - Atari 2600 Boxing clone for the Game Boy (Color).
- Tobu Tobu Girl Deluxe - An arcade platformer for the Game Boy (Color).
- Burly Bear vs. The Mean Foxes - color-burly-bear.html) port)
- PostBot
- Guns & Riders
- Dino's Offline Adventure - A clone of the Google Chrome offline game.
- dino-gb - Another clone of the Chrome game.
- Evoland.gb - A port of the first level of Evoland.
- Petris - A puzzle game of shapely pets for the Game Boy Color ([itch.io](https://bbbbbr.itch.io/petris)).
- Infinity - RPG developed by Affinix Software primarily between the years 1999 and 2001. The game never found a publisher and was eventually canceled. Got recently released with the full source, development tools and workflows.
-
Demos
- Back to Color
- beach-gbc
- CUTE DEMO
- `10 PRINT` Game Boy
- Roboto Demo
- matrix-rain-gb - A Matrix digital rain effect in assembler.
- GBVideoPlayer - A technical demo demonstrating how the Game Boy LCD controller can be hacked to make a Game Boy Color play a full motion video in color, together with music.
- GBVideoPlayer2 - The second iteration of the above demo, which increases the resolution, adds *stereo- PCM audio, and introduces video compression*.
-
GB Studio
- Soul Void - Interactive horror fiction.
- Deadeus
- SUPER IMPOSTOR BROS.
-
-
Introduction
Programming Languages
Categories
Sub Categories
Keywords
gameboy
40
game-boy
14
reverse-engineering
11
disassembly
10
pokemon
8
gbz80
8
assembly
7
assembly-language
6
gameboy-color
6
gameboy-emulator
6
gbdk
6
gameboy-advance
4
emulator
4
rgbds
4
gbdev
4
homebrew
4
game-boy-color
3
gameboy-camera
3
game
3
sdcc
2
tilemap
2
demoscene
2
arduino
2
cartridge
2
graphics
2
tilesets
2
demo
2
gb
2
game-tools
2
gimp
2
gba
2
gimp-plugin
2
tilemap-editor
2
game-development
2
game-boy-advance
2
rust
2
sm83
2
retrogaming
1
dmg
1
dumper
1
harvest-moon
1
des
1
dino
1
chrome-dinosaur-game
1
extracts-photos
1
chrome-dino-game
1
gameboy-printer-emulator
1
libpng
1
gameboy-printer
1
Z80
1