Related projects / Syntax highlighting packages

• visual-sm83 - A visual transistor level simulation of the Game Boy CPU core in JavaScript, running in a browser.

ASM / Music drivers and trackers

• gb asm tutorial - Step by step tutorial, building several ROMs to accompany its explanations.

ASM / Sources

• dev'rs ASM section - A lot of working demos and sources.

Related projects / Syntax highlighting packages

• sm83-render (⭐1) - A 3D model of the Game Boy CPU layout in Blender.

Game Disassemblies / Syntax highlighting packages

• The Jungle Book (⭐4)

C / Syntax highlighting packages

• Larold's Retro Gameyard - A collection of detailed GBDK-2020 based tutorials.

Tools / Music drivers and trackers

• DevSoundX (⭐12) - Sound driver embeddable in homebrews which supports pulse width manipulation, arpeggios, and multiple waveforms.

Compilers / Experimental/Proof of Concepts

• Rust-GB (⭐251) - A compiler and library that enable the development of GB ROMs using Rust.

ASM / Timings

• Mode3 Sprite Timing

Tools / Graphics utilities

• GB-convert (⭐0) - Game Boy tile conversion and map editor tool (converts to assembly).

ASM / Syntax highlighting packages

• exeman (⭐0)

C / Syntax highlighting packages

• Just another simple tutorial

Emulator Development / Misc

• Emulation of Nintendo Game Boy (⭐5.1k) - Overview of the Game Boy hardware with the perspective of building an emulator.

Hardware / Opcodes

• fruttenboel - Page with loads of information on the hardware, custom boards to interface with the console and other related projects.

Compilers / Experimental/Proof of Concepts

• RGBDS-Live - In-browser coding environment to try out RGBDS.

C / Syntax highlighting packages

• Super JetPak DX

Tools / Development tools

• opcode_count (⭐2) - Generates statistics on which CPU instructions are run the most often using Python and Emulicious

Tools / Development tools

• GBExtended - C library extending gbdk.

C / Syntax highlighting packages

• loderunner

Game Boy Color / Opcodes

• 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”.

Emulator Development / Misc

• Game Boy Doctor (⭐260) - 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.

Tools / Development tools

• evscript (⭐16) - A scripting language for the Game Boy, useful for enemy AI, dialogue, animations, and coroutines.

• evunit (⭐21) - A unit testing program for assembly code.

Hardware / Opcodes

• dmg-schematics (⭐34) - 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.

Emulators / Experimental/Proof of Concepts

• Gambatte (⭐7) - Cross-platform and accurate emulator.

Tools / Music drivers and trackers

• GBSoundSystem (⭐18) - A modernized audio driver for GameBoy Tracker (aka the Paragon 5 music player).

Cartridges / Opcodes

• GB Flash Cartridges for Sale - A List of available, ready-made Game Boy Flash Cartridges.

Documentation

• Game Boy Architecture: A Practical Analysis - by Rodrigo Copetti.

Documentation / Opcodes

• RGBDS opcodes reference - A reference of all instructions, including short descriptions, cycle and byte counts, and explanations of flag modifications.

Homebrews / Syntax highlighting packages

• Homebrew Hub - A community-led attempt to collect, archive and preserve every unlicensed and homebrew game released for Game Boy. Entries are playable online.

Reverse Engineering / Syntax highlighting packages

• DMA hijacking - A simple technique that allows you to run custom code in most GB/SGB/CGB games, provided you have an ACE exploit.

Tools / Music drivers and trackers

• CBT-FX (⭐32) - A GBDK-2020 sound effect driver compatible with FX-Hammer sound effects.

C / Syntax highlighting packages

• Game Boy home of Flavor - Some full games and sources.

ASM / Sources

• DeadCScroll (⭐25) - A detailed tutorial on how to make the screen wobble, among other "raster effects"

C / Syntax highlighting packages

• Novascape

• Burly Bear vs. The Mean Foxes (GBC port)

ASM / Syntax highlighting packages

• Death Planet

• Quartet - Puzzle game for the Game Boy (Color) and Super Game Boy.

• Dangan

C / Syntax highlighting packages

• Super Princess' 2092 Exodus (⭐30) - (ZGB engine (⭐774)).

• Tobu Tobu Girl Deluxe (⭐86) - An arcade platformer for the Game Boy (Color).

• Black Castle - Side scrolling platformer for the Game Boy (itch.io).

• Genesis - Shmup for the Game Boy (itch.io).

• Indestructo Tank!

• Powa! - Side scrolling platformer for the Game Boy (Color) (ZGB engine (⭐774)).

• Cavern - (ZGB engine (⭐774)).

• Mona and the Witch's Hat Deluxe - (ZGB engine (⭐774)).

• The Bouncing Ball

• DMG Deals Damage

GB Studio / Syntax highlighting packages

• Soul Void - Interactive horror fiction.

• Deadeus

• SUPER IMPOSTOR BROS.

ASM / Music drivers and trackers

• OAM DMA tutorial - Example of how to use OAM DMA in assembly.

ASM / Boilerplates and libraries

• gb-template (⭐4) - A template with basic functions such as joypad input, DMA transfers, and map/tile data loading.

ASM / Syntax highlighting packages

• PlantBoy (⭐1)

Compilers / Misc

• GBDK (⭐2.1k) - Maintained and modernized GBDK (Game Boy Development Kit) powered by an updated version of the SDCC toolchain. Provides a C compiler, assembler, linker and a set of libraries.
  • API docs: Getting Started
  • Examples (⭐203)
  • Documentation, links and tools

Game Disassemblies / Syntax highlighting packages

• Tetris (⭐29) - Complete Tetris disassembly.

Related projects / Syntax highlighting packages

• GB Studio - Drag and drop game creator with simple, no knowledge required, visual scripting.
  • Resources to get started
  • Dedicated Discord
  • Lets Build a Platformer Game! - A course designed to teach anyone how to create a platformer game using GB Studio 4+.

Compilers / Misc

• Turbo Rascal Syntax Error - Complete suite (IDE, compiler, programming language, resource editor) intended for developing games/demos for 8 / 16-bit line of computers, including the Game Boy and Game Boy Color.

ASM / Music drivers and trackers

• Assembly tutorial by David Pello - Good document to learn to produce working asm code for gb. Brief explanations of many important topics. Many examples with commented source code.

C / Syntax highlighting packages

• 8-Bit Wonderland (⭐38) - Well-written introductory document about how the Game Boy works and how to start developing working code for it.

• Infinity (⭐26) - 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.

Retrieving images / Syntax highlighting packages

• Arduino Gameboy Printer Emulator (⭐352) - Emulate a gameboy printer via the gameboy link cable.

• ESP8266 Game Boy Printer (⭐49) - A device that emulates the Gameboy Printer and lets you retrieve images using WiFi powered by an ESP8266.

• WiFi GBP Emulator (⭐74) - A GameBoy printer emulator which provides the received data over a WiFi connection.

• Game Boy WiFi Printer - D1 Mini Shield (⭐23) - Game Boy Printer interface shield for D1 mini/mini Pro ESP8266 boards.

• Game Boy Printer Sniffer (⭐9) - Sniff packet communications between a Game Boy and the Printer.

Changing the camera's behavior / Syntax highlighting packages

• Game Boy Camera Canon EF Lens Mount

• Game Boy Camera to Canon Lens mount - based on the above.

• game-boy-camera-frame-replacer (⭐41) - Manipulate the ROM of a camera to include custom frames

Post processing / Syntax highlighting packages

• Game Boy Printer Paper Simulation (⭐83) - Generate as-if-printed images of digital printed images.

• Game Boy Printer Web (⭐69) - Gallery app for to the Game Boy camera: import pictures from exports or cartridge dumps and choose color palettes.

Community

• Chat channels

Assemblers / Misc

• RGBDS (⭐1.6k) - Assembler and linker package. Documentation.

Tools / Graphics utilities

• Superfamiconv (⭐179) - Flexible and composable tile graphics converter supporting Super Nintendo, Game Boy, Game Boy Color, Game Boy Advance, Mega Drive and PC Engine formats.

Emulator Development / Misc

• DMG-01 - An educational Gameboy Emulator in Rust and a companion book explaining its development. *Oh Boy! Creating a Game Boy Emulator in Rust- is a talk given at Rust Fest 18 about this.

Demos / Syntax highlighting packages

• GBVideoPlayer2 (⭐124) - The second iteration of the above demo, which increases the resolution, adds stereo- PCM audio, and introduces video compression.

Tools / Music drivers and trackers

• hUGETracker (⭐335) - A music tracker based on OpenMPT, focused on ease of use, compact output, and embeddability in homebrew games.

ASM / Boilerplates and libraries

• gb-vwf (⭐56) - Library to print variable-width text, comes with a demo.

ASM / Boilerplates and libraries

• gb-boilerplate (⭐75) - A template for starting Game Boy projects, providing a Makefile for infrastructure.

• gb-starter-kit (⭐67) - An expansion on the above, including base library code as well to get started faster.

Emulators / Experimental/Proof of Concepts

• Emulicious - Provides accurate emulation and includes powerful tools such as a profiler and source-level debugging for ASM and C via a VS Code debug adapter.

Tools / Engines

• Retr0 GB - An engine for creating games (expands GBDK).

Tools / Development tools

• gbdk-lib-extension (⭐13) - A small set of sources and tools for the Game Boy Development Kit by Michael Hope.

• mgbdis (⭐298) - Game Boy ROM disassembler with RGBDS compatible output.

• ROM Header Utility - An online tool to inspect and modify a ROM's header data, including the logo.

• romusage (⭐56) - Command line tool for estimating usage (free space) of Game Boy ROMs from a .map, .noi or ihx file. Works with GBDK-2020 and RGBDS.

• awake (⭐76) - Game Boy decompiler.

• Game Boy Text Tools (⭐11) - Set of tools for text manipulation and translation of Game Boy ROMs written in Node.js.

Tools / Graphics utilities

• Harry Mulder's GB Development - Some sources and home of Game Boy Tile Designer (GBTD) and Game Boy Map Builder (GBMB) tools.

• Tilemap Studio (⭐484) - A tilemap editor for Game Boy, Color, Advance, and SNES projects. Written in C++ with FLTK.

Tools / Hardware and ROM utilities

• cart-dumper (⭐44) - Game Boy Cartridge Dumper ROM.

• gbcamextract (⭐53) - Extracts photos from Game Boy Camera saves.

• Game Boy LCD sniffing (⭐180) - Sniff your Game Boy's LCD using a logic analyzer.

• swapdump (⭐3) - Diagnostic utility for Game Boy flashcarts.

• Gameboy-LinkUp (⭐0) - Game Boy LinkUp serial cable networking project.

C / Syntax highlighting packages

• Petris (⭐34) - A puzzle game of shapely pets for the Game Boy Color (itch.io).

Testing / Misc

• dmg-acid2 (⭐229) and cgb-acid2 (⭐83) - Basic PPU rendering tests.

ASM / Syntax highlighting packages

• sublime-rgbds - A Sublime Text 3 package for RGBDS, including syntax highlighting and some completion snippets.

Compilers / Experimental/Proof of Concepts

• gbdk-go (⭐24) - A compiler translates Go programs to C code. The output C code is built into GB ROM by GBDK.

Assemblers / Misc

• ASMotor (⭐88) - Assembler engine and development system targeting Game Boy, among other CPUs. Written by the original RGBDS author. Documentation (⭐88).

Documentation

• Pan Docs - The single, most comprehensive technical reference to Game Boy available to the public. Corrected, updated and maintained by the community.

ASM / Music drivers and trackers

• GameBoy programming tutorial: Hello World! - Step by step tutorial.

Tools / Music drivers and trackers

• Carillon Player - Music Engine.

• GBT PLAYER (⭐299) - A music player library and converter kit.

• mmlgb (⭐43) - A MML parser and GBDK sound driver for the Nintendo Game Boy.

• XPMCK (⭐27) - An MML based music compiler with support for Game Boy & Game Boy Color.

Testing / Misc

• MBC3 RTC test ROM (⭐38)

Documentation

• Game Boy Project Report - Report of an hardware emulator (⭐8) (on a Terasic DE1-SoC Board) developed as final project for the CSEE4840 Embedded Systems Design course at Columbia University.

Cartridges / Opcodes

• MBC1 and MBC2 cartridges circuits - and explanation on how these MBC bank switch and control RAM.

Emulator Development / Misc

• Reverse Engineering fine details of Game Boy hardware - 43 minutes talk by Gekkio given at Disobey 2018 (errata).

• binjgb debugging hangs - Investigations on emulations quirks.

ASM / Syntax highlighting packages

• rgbds-vscode (⭐76) - Visual Studio Code language extension for RGBDS GBZ80 Assembly.

• kupman (⭐5) and some other projects.

C / Syntax highlighting packages

• GBDK Programming Video Tutorials - A series of video tutorials introducing beginners to programming with GBDK.

• GB raycaster, Vision-8 (⭐15) - and some other projects.

• Dino's Offline Adventure (⭐59) - A clone of the Google Chrome offline game.

• dino-gb (⭐26) - Another clone of the Chrome game.

Websites / Syntax highlighting packages

• pdroms.de - Game Boy releases.

Introduction

• The Game Boy, a hardware autopsy

• The Ultimate Game Boy Talk

Documentation

• Complete Technical Reference - by Gekkio.

Peripherals / Opcodes

• Edge of Emulation, a series of articles about emulating and investigating Game Boy accessories. Also available as technical documents (⭐572) in the GBE- emulator documentation.
  • Mobile Adapter GB - Internet connectivity and DLC on the Game Boy Color.
  • The Game Boy Printer
  • 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.

Cartridges / Opcodes

• Gekkio's cartridge analysis:
  • DMG-BEAN-02;
  • MBC1;
  • no MBC.

• Pinout, registers descriptions and VHDL code of some cartridge types on Tauwasser's wiki:
  • MBC1
  • MBC2
  • MMM01

Emulator Development / Misc

• binjgb rewind - Implementing a *rewind- feature.

• About swotGB - Notes about the development of a Game Boy emulator in JavaScript.

Assemblers / Misc

• wla-dx (⭐587) - Yet Another GB-Z80/Z80/... Multi Platform Cross Assembler Package. Documentation.

Emulators / Experimental/Proof of Concepts

• Binjgb (⭐596) - 5Kloc emulator that passes most of the tests. *Rewind- feature. Runs in the browser using WebAssembly.

• gbe-plus (⭐572) - A recently rewritten emulator that has a large effort in preserving the functions of obscure accessories (such as IR link, Mobile Network GB, Barcode Boy, GB Printer, local and online GB Serial Link Cable, ... )

ASM / Syntax highlighting packages

• gbz80-highlight (⭐10) - Notepad+- and gedit syntax highlighting files for RGBDS assembly.

C / Syntax highlighting packages

• Bubble Factory (⭐27) - *Vanilla- SDCC (no gbdk).

Emulators / Experimental/Proof of Concepts

• BGB - Powerful emulator and debugger. Provides an accurate hardware emulation.

Community

• Forum

Cartridges / Misc

• Introduction to Game Boy Hacking - Workshop introducing basic assembly, debugging and reverse engineering.

• GBSOUND.txt (⭐54) - 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.

Websites / Syntax highlighting packages

• devrs.com/gb - Old home of the scene: examples, sources, complete documentation, guides, tutorials and various tools.

ASM / Music drivers and trackers

• Game Boy Assembly Programming for the Modern Game Developer (⭐166) - An e-book about making Game Boy games in Assembly.

ASM / Boilerplates and libraries

• GingerBread (⭐138) - A software library for making your own Game Boy games. It is made to be used alongside the book Game Boy Assembly Programming for the Modern Game Developer (⭐166) which also doubles as documentation.

Emulators / Experimental/Proof of Concepts

• MetroBoy (⭐1.2k) - A playable, circuit-level simulation of an entire Game Boy.

Related projects / Syntax highlighting packages

• Programming Game Boy Chinese cartridges with an STM32F4

• Dumping the Super Game Boy Boot ROM

Cartridges / Custom cartridges

• Gameboy-MBC5-MBC1-Hybrid (⭐54) - CPLD implementation of a MBC5/MBC1 Hybrid cartridge.

Related projects / Syntax highlighting packages

• GBCartRead (⭐68) - Read ROM, Read RAM or Write RAM from/to a GameBoy Cartridge.

• GBxCart-RW (⭐103) - A device for reading game ROMs, save games and restoring saves for GB, GBC and GBA carts from your PC via USB.

Emulator Development / Misc

• 0dmg - Learning Rust by building a partial Game Boy emulator.

Related projects / Syntax highlighting packages

• Work Master OS - Russian multi tasking operating system.

• GBCamcorder (⭐95) - Lo-Fi portable video recorder using a GameBoy Camera cartridge.

Tools / Graphics utilities

• Tilemap GB (⭐67) - GIMP image editor plug-in for importing & exporting GBMB and GBTD tilemaps and tilesets (as bitmap images or .GBM/.GBR files).

• Tilemap Helper (⭐28) - GIMP image editor plug-in for optimizing tile maps and tile sets.

Documentation / Opcodes

• gb-opcodes - Opcodes table

C / Syntax highlighting packages

• Evoland.gb (⭐43) - A port of the first level of Evoland.

Cartridges / Custom cartridges

• Nekocart (⭐130) - Open-source flash cartridge using an Xilinx CPLD as MBC5 (Post).

• Reiner Ziegler's Game Boy page - Commercial and homemade programmable cartridges and programming systems. Tutorials, wiring and schematics provided.

Testing / Misc

• Mealybug Tearoom Tests (⭐65)

Compilers / Experimental/Proof of Concepts

• gbasm-rs - An opinionated Rust based compiler for Game Boy z80 assembly code.

ASM / Syntax highlighting packages

• vectroid.gb - Developed with gbasm.

Related projects / Syntax highlighting packages

• Game Boy Link Cable Breakout Board (⭐104)

• GBCartFlasher firmware (⭐24)

• VerilogBoy (⭐511) - Game Boy compatible console Verilog RTL implementation.

Game Boy Color / Opcodes

• Bootstrap ROM

• Colorization palettes in the BIOS

Peripherals / Opcodes

• Game Boy Camera RE (⭐92) - Documentation about GB Camera and tools used to reverse engineer it by using Arduino.

• Arduino Game Boy Printer Emulator (⭐352) - Emulating a Game Boy Printer via the Game Boy Link cable with an Arduino.

Cartridges / Custom cartridges

• Homebrew-Gameboy-Cartridge (⭐139) - Eagle library, schematic, and board files for a cartridge PCB using an Atmel AT49F040 as ROM.

Emulator Development / Misc

• Decoding Gameboy Z80 opcodes - How to algorithmically decode Game Boy instructions (as opposed to writing one huge switch-case statement).

ASM / Syntax highlighting packages

• waveform-gb (⭐20) - 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.

ASM / Syntax highlighting packages

• rgbds-mode (⭐5) - Emacs major mode for RGBDS assembly.

Demos / Syntax highlighting packages

• GBVideoPlayer (⭐100) - 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.

Cartridges / Opcodes

• GB Rom List - Navigable table of every game released with details on their cartridges.

Cartridges / Custom cartridges

• Homebrew Gameboy Color Cartridge (⭐75) - Board layout for an EEPROM powered cartridge.

Tools / Graphics utilities

• libstdgb (⭐12) - A C library of useful Game Boy operations (SDCC).

ASM / Music drivers and trackers

• DMGreport (⭐62) - Game programming tutorials in assembly.

ASM / Sources

• EmmaEwert's experiments (⭐25) - A collection of prototype programs, mostly just toying around. Among others, a daylight effect, transparency and a weather effect.

ASM / Syntax highlighting packages

• Vim syntax file for the Game Boy assembler RGBASM - Vim syntax highlighting for RGBDS assembly.

• Vim syntax file for RGBDS (⭐11) - Another Vim syntax highlighting file for RGBDS assembly.

• Z80 Assembly support for Visual Studio Code (⭐36)

• minesweepGB (⭐13)

• Libbet and the Magic Floor (⭐39)

Reverse Engineering / Syntax highlighting packages

• Reverse engineering Kirby's Dreamland 2

• pokemontools (⭐347) - a python module that provides various reverse engineering components for various Pokémon games.

• Reverse Engineering a Gameboy ROM with radare2 - A walkthrough to reverse engineer a Game Boy ROM challenge using radare2.

• Disassembling Link's Awakening - A series of blog posts about disassembling Link's Awakening DX.

• Reverse Engineering the GameBoy Tetris (⭐27)

Related projects / Syntax highlighting packages

• gbos (⭐28) - A basic operating system for the Game Boy.

Tools / Graphics utilities

• Game Boy Tile Data Generator (⭐92) - HTML5 / JS web application that will convert bitmap images to hexadecimal data appropriate for use in tile based graphical applications, specifically GB.

Tools / Graphics utilities

• tpp1 (⭐24) - Definition and specification of a custom GB/GBC memory/hardware mapper, as a functional superset of MBC.

Game Boy Color / Opcodes

• Unused Palettes

Peripherals / Opcodes

• Dan Docs - Obscure Game Boy hardware documentation.

• DMG-07 Technical Documentation

Tools / Graphics utilities

• vtGBte (⭐36) - A minimalistic ncurses tile editor.

Compilers / Experimental/Proof of Concepts

• llvm-gbz80 (⭐37) / clang-gbz80 (⭐24) - Clang/LLVM port to the GBZ80 CPU (similar to the deprecated euclio/llvm-gbz80 (⭐9)).

Emulator Development / Misc

• binjgb on the web - Porting of the binjgb emulator to Web Assembly. (Part 2)

Emulator Development / Misc

• List of open source emulators

Emulators / Experimental/Proof of Concepts

• mGBA (⭐6.8k) - Modern cross platform GBA emulator which also runs GB/GBC games.

Demos / Syntax highlighting packages

• matrix-rain-gb (⭐32) - A Matrix digital rain effect in assembler.

Hardware / Opcodes

• The Game Boy Project - Provides a study on the hardware and detailed constructional information for the implementation of three 8-bit bidirectional parallel ports.

Peripherals / Opcodes

• Creating photo realistic images with neural networks and a Gameboy Camera

Emulator Development / Misc

• Building a Game Boy emulator in JavaScript - Step by step tutorial.

• Writing a Game Boy emulator, Cinoop

• 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.

• Porting a GO Game Boy emulator to WebAssembly

Testing / Misc

• Blargg's test roms

• Gekkio's test roms

• SameSuite (⭐43)

• GB Accuracy Tests

• 144p Test Suite (⭐277) - Port of Artemio Urbina's 240p Test Suite to the Game Boy.

Emulators / Experimental/Proof of Concepts

• Mooneye GB (⭐957) - Research project and emulator in Rust.

C / Syntax highlighting packages

• flappybird-gameboy (⭐15)

• fbgb (⭐3)

Hardware / Opcodes

• Related custom hardware (⭐359) - by Gekkio.

• ESP8266 GB Dev Board (⭐28) - Dev board for Game Boy accessories development, powered by ESP8266.

• ESP8266 GB Printer (⭐49) - A device that emulates the GB Printer and lets you retrieve images using WiFi.

Peripherals / Opcodes

• Ben Heck Reverse Engineers Game Boy Printer (Errata: the used thermal paper is expired, 4 colors are actually printable).

Cartridges / Opcodes

• MBC1+RAM+Battery cartridge Schematic - First schematics by Jeff Frohwein.

Emulators / Experimental/Proof of Concepts

• SameBoy (⭐2k) - Accurate emulator with a wide range of powerful debugging features.

Related projects / Syntax highlighting packages

• liblsdj (⭐104) - Utility library for interacting with the LSDj save format (.sav), song files (.lsdsng) and more.

• lsdpatch (⭐201) - Tool for modifying samples, fonts and palettes on LSDj ROM images.

Directories / Syntax highlighting packages

• The Game Boy Archive - Salvage (⭐38) - Historical archive of software, old articles, FAQs and various documents.

Compilers / Experimental/Proof of Concepts

• Wiz (⭐427) - A high-level assembly language for writing homebrew on retro console platforms (Game Boy, NES, Atari 2600, and more).

• gbforth (⭐147) - A Forth-based Game Boy development kit.

• gbasm (⭐132) - A JavaScript based compiler for Game Boy z80 assembly code.

• tniASM - Macro Assembler.

• Assembler (⭐119) - Assembler written in Swift.

Tools / Engines

• ZGB (⭐774) - A little engine for creating games for the original Game Boy (expands gbdk, more info here).

Tools / Graphics utilities

• GBTiles (⭐16) - Converts .GBR files created with Harry Mulder's Tile Designer (GBTD) and .GBM files created with Harry Mulder's Map Builder (GBMB) to different formats for use with the Game Boy and GBDK.

• bmp2cgb (⭐28) - Graphics converter for Game Boy Color development providing real time palette adjustments.

• png2gb (⭐21) - CLI tool to convert image file to game boy .c array.

• brewtool - A collection of primitive editor/converter tools for making assets used with homebrew ROM development.

Documentation

• The Cycle-Accurate Game Boy Docs (⭐206) - A precise documentation by AntonioND to make a cycle-accurate Game Boy emulator.

Related projects / Syntax highlighting packages

• gameboy-brainfuck (⭐16) - Brainf*ck interpreter.

• gbfk (⭐2) - Brainf*ck interpreter, with input.

ASM / Music drivers and trackers

• hardware.inc (⭐151) - Standard include file containing Game Boy hardware definitions for use in RGBDS projects.

ASM / Syntax highlighting packages

• Tuff (⭐312)

• 2048-gb (⭐116)

• Snake

• Lazerpong (⭐14)

• Geometrix (⭐30)

• µCity (⭐467)

• Carazu (⭐18)

• Snake-gb (⭐20)

• GB303 (⭐137) - GB303 wavetable-based TB-303 style synthesizer for the Nintendo Game Boy.

• Sushi (⭐5)

• Flappy-boy-asm (⭐94)

• Adjustris (⭐15)

• Aevilia (⭐56)

• GBSlides (⭐32) - A simple Game Boy Powerpoint-like slides viewer.

• Pokered-gbc (⭐171) - Pokémon Red remade with full GBC support.

• ToyToy (⭐10)

• StefaN (⭐4) - Fourway Breakout clone.

• Galaxia (⭐4)

• desgb (⭐14) - DES encryption.

• superhappyfunbubbletime (⭐5)

C / Syntax highlighting packages

• FlappyBoy (⭐20)

• Squishy the Turtle (⭐8)

• Quadratino (⭐12)

• Doctor How (⭐28)

• GBsnake (⭐32)

• gb-mines (⭐36)

• oranges

• red hot princess carnage (⭐6)

• Hives

• GBC Atari Boxing (⭐3) - Atari 2600 Boxing clone for the Game Boy (Color).

• PostBot (⭐7)

• Guns & Riders (⭐14)

Demos / Syntax highlighting packages

• Back to Color (⭐28)

• beach-gbc (⭐14)

• CUTE DEMO (⭐39)

• 10 PRINT Game Boy

• Roboto Demo (⭐27)

Game Disassemblies / Syntax highlighting packages

• Pokémon Yellow (⭐805)

• Pokémon Gold and Silver (⭐641)

• pokegold-spaceworld (⭐374) - Pokémon Gold and Silver 1997 Space World demo.

• Link's Awakening DX (⭐877)

• Oracle of Ages (⭐186)

• FX Hammer (⭐9)

• Harvest Moon 3 (⭐19)

ASM / Boilerplates and libraries

• rgbds-template (⭐43) - Basic hello-world example for Game Boy using RGBDS.

• Game Boy Assembly Language Primer - Simple template code with memory defines, copy routines and IBM font tilemap.

• bootstrap.gb (⭐32) - An example Game Boy project.

• Gameboy Boilerplate (⭐31) - Boilerplate project to move quicker into the actual assembly code for your game.

C / Syntax highlighting packages

• Simplified GBDK examples (⭐203)

Related projects / Syntax highlighting packages

• Game Boy video effects (⭐5) - Some little experiments using the STAT interrupt to do funny video manipulations.

Related projects / Syntax highlighting packages

• Sniffing Game Boy serial traffic with an STM32F4

• Virtual Game Boy Printer with an STM32F4

• Printing on the Game Boy Printer using an STM32F4

• Pokemon Pocket Computer: - What is it and how to use it to make cheat codes.

• Booting the Game Boy with a custom logo - Bypassing the Nintendo logo check.

• Making a Game Boy game in 2017: A "Sheep It Up!" Post-Mortem (part 1, part 2)

• Nintendo's fake logos - Every cartridge has to show the authentic logo to be considered valid and be run, but obviously some companies managed to exploit the check system.

Websites / Syntax highlighting packages

• Handheld Underground - Unlicensed games, blog posts about Game Boy, home of the hhugboy emulator.

Related projects / Syntax highlighting packages

• Digitized Speech in Game Boy Games

ASM / Music drivers and trackers

• assemblydigest (⭐78) - Exploring Game Boy programming techniques:
  • Making an Empty Game Boy ROM (in Wiz)
  • Making Art for the Game Boy

Directories / Syntax highlighting packages

• Archive of related files

• The Game Boy Archive - A library of Game Boy related software, hardware and literature. Aimed to mirror and preserve old and fragmented contributions from the last three decades.

Hardware / Opcodes

• DMG Schematics - Hardware schematics.

• Game Boy hardware database - Data and photos of various types of Game Boy consoles.

Cartridges / Custom cartridges

• Wolf - Game Boy cartridge with co-processor.

Related projects / Syntax highlighting packages

• mGB (⭐258) - A Game Boy cartridge program that enables the Game Boy to act as a full MIDI supported sound module.

• GBVisualizer (⭐28) - Demonstrating the use of two undocumented Game Boy Color registers, nicknamed PCM12 (FF76) and PCM34 (FF77), which can be used to read the current PCM amplitude of the 4 APU channels.

• gbcpu (⭐9) - A CPU and peripherals implementing the Game Boy instruction set and functionality.

ASM / Timings

• Video Timing (⭐9)

ASM / Music drivers and trackers

• Super Game Boy development - Step by step tutorial to implement Super Game Boy features (frame and palettes).

Cartridges / Opcodes

• AntonioND's docs (⭐206) - Corrected schematics and infos on cartridge header data.

Related projects / Syntax highlighting packages

• papiGB (⭐16) - Game Boy Classic fully functional FPGA implementation from scratch.

Related projects / Syntax highlighting packages

• ArduinoBoy (⭐357) - Serial communication (MIDI) from an Arduino to the Game Boy for music applications such as LittleSoundDJ, Nanoloop, and mGB.

Related projects / Syntax highlighting packages

• gb-save-states (⭐176) - Patches to add save state support to Game Boy games when playing on the original hardware.

Cartridges / Custom cartridges

• Emulating a GameBoy Cartridge - Emulating the functionality of a Game Boy cartridge with the development board STM32F4.

Peripherals / Opcodes

• Mobile Game Boy Adapter

• GB KISS LINK MODEM

Game Disassemblies / Syntax highlighting packages

• Pokémon Pinball (⭐184)

• Pokémon TCG (⭐303)

C / Syntax highlighting packages

• GBDK Configuring and Programming Tutorial - Configuring GBDK, Using Tiles, Colliding Sprites, GBTD, GBMB, Memory Management and ROM Banking.

Cartridges / Opcodes

• Cartridges PCB photos

Peripherals / Opcodes

• 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.

ASM / Music drivers and trackers

• FlappyBoy: Making a simple Game Boy Game

ASM / Timings

• Nitty Gritty Gameboy Cycle Timing

• GameBoy Color DMA-Transfers v0.0.1

• STAT interrupt timings

Related projects / Syntax highlighting packages

• ArduinoGameBoy (⭐163) - Arduino based Game Boy cartridge reader and writer.

Related projects / Syntax highlighting packages

• Ostrich (⭐43) - A Game Boy Sound System player written in Swift.

ASM / Music drivers and trackers

• Beginner's Guide to Reverse Engineering GB - Some starting tips on disassembling and reverse engineering.

C / Syntax highlighting packages

• GBDK Tutorial - Fairly minimal game demo for getting started with GBDK.

Cartridges / Opcodes

• Gekkio's Game Boy cartridge types - An overview on existing cartridge types.

• Game Boy Cartridges Schematics - Schematics for MBC2 and MBC3 types.

• Game Boy cartridge PCB photos

C / Syntax highlighting packages

• Grooves Game Boy Programming (⭐89) - A complete set of lessons about implementing various game mechanics in a Game Boy game.

• GBDK Sprite - Presents a workflow for getting multiple sprites to display and animate.

• GBDK Color - Extends your knowledge of basic spriting on the Game Boy by adding colors to sprites, backgrounds and the window layer.

• GBDK Joypad - Details the use of the joypad with GBDK.

Game Disassemblies / Syntax highlighting packages

• Pokémon Red/Blue (⭐4.5k)

• Pokémon Crystal (⭐2.3k)

Related projects / Syntax highlighting packages

• Piglet (⭐44) - A LUA-driven AI that plays classic Game Boy color games using experimentation. In active development.

C / Syntax highlighting packages

• How to Write a Simple Side Scrolling Game - Old (but still relevant) tutorial.

Related projects / Syntax highlighting packages

• fpgaboy (⭐99) - Implementation Nintendo's Game Boy console on an FPGA.