rgbds - Rednex Game Boy Development System
RGBDS(7) Miscellaneous Information Manual RGBDS(7)
NAME
rgbds — Rednex Game Boy Development System
EXAMPLES
To get a working ROM image from a single assembly source file:
$ rgbasm
−o game.o game.asm
$ rgblink −o game.gb game.o
$ rgbfix −v −p 0 game.gb
Or in a single command line, without creating an intermediate object file:
$ (rgbasm -o - - | rgblink -o - - | rgbfix -v -p 0) < game.asm > game.gb
SEE ALSO
rgbasm(1), rgbasm(5), rgblink(1), rgblink(5), rgbfix(1), rgbgfx(1), gbz80(7), rgbds(5)
HISTORY
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.
2010-09-25: Sørensen continues development of ASMotor: https://github.com/asmotor/asmotor to this day.
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: https://github.com/rednex/rgbds organization.
2018-01-26: The codebase is relicensed under the MIT license.
2020-09-15: The repository is moved to the gbdev: https://github.com/gbdev/rgbds organization.
2022-05-17: The rgbds.gbdev.io: https://rgbds.gbdev.io website for RGBDS documentation and downloads is published.
2025-10-31: RGBDS reaches version 1.0.0 and starts adhering to semantic versioning: https://semver.org/ ("semver"). GNU October 31, 2025 RGBDS(7)