RGBDS (Rednex Game Boy Development System) is a free assembler/linker package for the Game Boy and Game Boy Color. It consists of:
- rgbasm (assembler)
- rgblink (linker)
- rgbfix (checksum/header fixer)
- rgbgfx (PNG‐to‐Game Boy graphics converter)
This is a fork of the original RGBDS which aims to make the programs more like other UNIX tools.
This toolchain is maintained on GitHub.
The documentation of this toolchain can be viewed online here. It is generated from the man pages found in this repository. The source code of the website itself is on GitHub as well under the repo rgbds-www.
If you want to contribute or maintain RGBDS, and have questions regarding the code, its
organisation, etc. you can find the maintainers on GBDev or
via mail at rgbds at gbdev dot io.
The installation procedure is available
online for various platforms. Building from source
is possible using make or cmake; follow the link for more detailed instructions.
make
sudo make installcmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
cmake --install buildThe RGBDS source code file structure is as follows:
. ├── .github/ │ ├── scripts/ │ │ └── ... │ └── workflows/ │ └── ... ├── contrib/ │ ├── zsh_compl/ │ │ └── ... │ └── ... ├── include/ │ └── ... ├── man/ │ └── ... ├── src/ │ ├── asm/ │ │ └── ... │ ├── extern/ │ │ └── ... │ ├── fix/ │ │ └── ... │ ├── gfx/ │ │ └── ... │ ├── link/ │ │ └── ... │ ├── CMakeLists.txt │ └── ... ├── test/ │ ├── ... │ └── run-tests.sh ├── .clang-format ├── CMakeLists.txt ├── Dockerfile ├── Makefile └── README.rst
.github/- files and scripts related to the integration of the RGBDS codebase with GitHub.scripts/- scripts used by workflow files.workflows/- CI workflow description files.
contrib/- scripts and other resources which may be useful to users and developers of RGBDS.zsh_complcontains tab completion scripts for use with zsh. Put them somewhere in yourfpath, and they should auto-load.bash_complcontains tab completion scripts for use with bash. Run them withsourcesomewhere in your.bashrc, and they should load every time you open a shell.
include/- header files for the respective source files in src.man/- manual pages.src/- source code of RGBDS.- Note that the code unique to each RGBDS tool is stored in its respective subdirectory
(rgbasm ->
src/asm/, for example).src/extern/contains code imported from external sources.
- Note that the code unique to each RGBDS tool is stored in its respective subdirectory
(rgbasm ->
test/- testing framework used to verify that changes to the code don't break or modify the behavior of RGBDS..clang-format- code style for automated C++ formatting withclang-format.Dockerfile- defines how to build RGBDS with Docker.
- 1996-10-01: Carsten Sørensen (a.k.a. SurfSmurf) releases xAsm, xLink, and RGBFix, a Game Boy SM83 (GBZ80) assembler/linker system for DOS/Win32.
- 1997-07-03: Sørensen releases ASMotor, packaging the three programs together and moving towards making them a general-purpose target-independent system.
- 1999-08-01: Justin Lloyd (a.k.a. Otaku no Zoku) adapts ASMotor to re-focus on SM83 assembly/machine code, and releases this version as RGBDS.
- 2009-06-11: Vegard Nossum adapts the code to be more UNIX-like and releases this version as rgbds-linux.
- 2010-01-12: Anthony J. Bentley forks Nossum's repository. The fork becomes the reference implementation of RGBDS.
- 2015-01-18: stag019 begins implementing rgbgfx, a PNG‐to‐Game Boy graphics converter, for eventual integration into RGBDS.
- 2016-09-05: rgbgfx is integrated into Bentley's repository.
- 2017-02-23: Bentley's repository is moved to the rednex organization.
- 2018-01-26: The codebase is relicensed under the MIT license.
- 2020-09-15: The repository is moved to the gbdev organization.
- 2022-05-17: The rgbds.gbdev.io website for RGBDS documentation and downloads is published.
RGBGFX generates palettes using algorithms found in the paper "Algorithms for the Pagination Problem, a Bin Packing with Overlapping Items" (GitHub, MIT license), by Aristide Grange, Imed Kacem, and Sébastien Martin.