Rednex Game Boy Development System - An assembly toolchain for the Nintendo Game Boy and Game Boy Color https://rgbds.gbdev.io
  • C++ 67.6%
  • Assembly 17.8%
  • Shell 6.1%
  • Yacc 4.8%
  • CMake 2.6%
  • Other 0.9%
Find a file
2026-07-24 14:46:05 +02:00
.github Fix typo'd APT option in release workflow 2026-07-20 21:53:43 +02:00
cmake Update libpng to 1.6.58 2026-07-20 14:08:09 -04:00
contrib Use set -u too 2026-07-10 23:12:49 -04:00
docs Fix relative links in Markdown docs 2026-07-11 16:19:27 -04:00
include Use _fseeki64/_ftelli64 on Windows since fseek/fell are limited by 32-bit long 2026-07-21 14:38:14 -04:00
man Support the COLUMNS environment variable for help/usage output 2026-07-24 14:46:05 +02:00
src Support the COLUMNS environment variable for help/usage output 2026-07-24 14:46:05 +02:00
test Handle -Wtruncation for link-time jr values 2026-07-21 14:51:58 -04:00
.clang-format
.clang-tidy
.dockerignore
.editorconfig
.git-blame-ignore-revs
.gitattributes Refactor the test harness for external repo tests (#1994) 2026-06-30 16:19:41 +02:00
.gitignore Enable automatic generation of compile_flags.txt for clang-tidy via make tidy (#2008) 2026-07-11 16:11:14 -04:00
CMakeLists.txt Pass -Wno-unused-but-set-variable by default, not just in make develop 2026-05-23 01:40:13 -04:00
CMakePresets.json
Dockerfile Release v1.0.2 2026-07-20 14:08:09 -04:00
LICENSE
Makefile Enable automatic generation of compile_flags.txt for clang-tidy via make tidy (#2008) 2026-07-11 16:11:14 -04:00
README.md Reorganize the readme 2026-07-14 10:34:43 -04:00

RGBDS

RGBDS (Rednex Game Boy Development System) is a free assembler/linker package for the Game Boy and Game Boy Color.

It consists of four tools:

  • RGBASM: assembler
  • RGBLINK: linker
  • RGBFIX: ROM checksum/header fixer
  • RGBGFX: PNG-to-Game Boy graphics converter

Documentation

The full documentation is available online, including the development history and version history, generated from the man pages in this repository.

The documentation website's own source code is available in the rgbds-www repository.

Community

If you have questions about the RGBDS code or its organization, you can contact the maintainers on the GBDev Discord server or other community channels, or via email at rgbds at gbdev dot io.

If you want to help maintain RGBDS, please read the contribution guide.

Installing

The platform-specific installation instructions are available online. To build from source using make or cmake, briefly:

make
sudo make install
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
cmake --install build

Both build systems support a prefix (e.g. to install into a specific directory) and a suffix (e.g. to append the version number or commit ID):

make
sudo make install PREFIX=install_dir/ SUFFIX=-$(git rev-parse --short HEAD)
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DSUFFIX=-$(git rev-parse --short HEAD)
cmake --build build
cmake --install build --prefix install_dir

On Windows, any SUFFIX should include the .exe extension.