https://github.com/gheja/gbdk

GameBoy Developer's Kit (GBDK) 2.96a from 2002 tuned so it can be compiled on a modern system (Ubuntu 24.04 LTS, 22.04 LTS, 20.04 LTS).
https://github.com/gheja/gbdk

Last synced: about 17 hours ago
JSON representation

GameBoy Developer's Kit (GBDK) 2.96a from 2002 tuned so it can be compiled on a modern system (Ubuntu 24.04 LTS, 22.04 LTS, 20.04 LTS).

• Host: GitHub
• URL: https://github.com/gheja/gbdk
• Owner: gheja
• Created: 2013-11-18T23:55:37.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2024-10-03T23:52:50.000Z (4 months ago)
• Last Synced: 2025-02-07T12:10:47.522Z (8 days ago)
• Language: C
• Homepage:
• Size: 2.06 MB
• Stars: 84
• Watchers: 6
• Forks: 10
• Open Issues: 5
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• AwesomeCompiler - gbdk

README

        
[![Build Status](https://github.com/gheja/gbdk/actions/workflows/c-cpp.yml/badge.svg)](https://github.com/gheja/gbdk/actions/workflows/c-cpp.yml)

Note: this is the latest official version 2.96a from April 2002. Now there

is an actively developed community driven reboot called

[gbdk-2020](https://github.com/Zal0/gbdk-2020/) with compiled versions

ready to run on Windows, Linux and Mac OS.

GBDK

====

"The GameBoy Developer's Kit (GBDK), is a set of tools that enable to

develop programs for the Nintendo GameBoy system, either in C or in

assembly. GBDK includes a set of libraries for the most common

requirements and generates image files for use with a real GameBoy or

with an emulator like VGB or no$gmb. [...]

GBDK features:

  * An ANSI C compiler.

  * An assembler that generates relocatable code.

  * A peephole optimiser.

  * A linker that produces GameBoy image files.

  * Support for multiple-bank images.

  * Smart linking.

  * A set of libraries, with source code.

  * Example programs in assembly and in C."

From http://gbdk.sourceforge.net

Quick summary

=============

The base version (2.96a) was downloaded from the official site. Although

this is the latest version, it was released quite a while ago (back in

April 2002).

The code can be compiled in an up-to-date 64-bit Linux environment (at

least it is up-to-date here in 2024).

Original sites:

  * http://gbdk.sourceforge.net

  * http://sourceforge.net/projects/gbdk

Building

========

For the build I recommend an Ubuntu 22.04 LTS (an earlier LTS version

should also work, and you don't even need to install it, the Live system

works just fine).

The environment will need a few packages, all of them can be installed

using apt-get:

```

sudo apt-get -y install make gcc g++ bison flex

```

After downloading the source you can use the Makefile to compile the

binaries:

```

cd /path/where/you/extracted

make

```

Installing the compiled binaries can be done via make as well:

```

sudo make install

```

Compiling the examples:

```

cd ./gbdk-lib/examples/gb

make

```

Note: compiling the examples requires you to install the binaries you

just built in the previous steps.