Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hacktix/gb-8

A simple Chip-8 interpreter for the Nintendo Gameboy Color.
https://github.com/hacktix/gb-8

chip8 chip8-emulator gameboy gameboy-color homebrew

Last synced: about 3 hours ago
JSON representation

A simple Chip-8 interpreter for the Nintendo Gameboy Color.

Awesome Lists containing this project

README

        

# GB-8
![GitHub](https://img.shields.io/github/license/Hacktix/GB-8?style=for-the-badge)
![GitHub Release Date](https://img.shields.io/github/release-date/Hacktix/GB-8?label=Latest%20Release&style=for-the-badge)
![GitHub last commit](https://img.shields.io/github/last-commit/Hacktix/GB-8?style=for-the-badge)
![GitHub repo size](https://img.shields.io/github/repo-size/Hacktix/GB-8?style=for-the-badge)

## What's this?

GB-8 is a CHIP-8 interpreter for the Gameboy Color. It comes pre-loaded with a whole bunch of CHIP-8 ROMs and is easily expandable and modular. And thanks to the small size of CHIP-8 ROMs, it even fits onto a 32KB cartridge!

## How do I use it?

Simply download the newest version from the [Releases Section](https://github.com/Hacktix/GB-8/releases) and load it up on hardware or on your favorite Gameboy emulator. You'll be shown a menu which you can navigate using the D-Pad. Once you've selected the game you want to play, press A or Start in order to start the emulator. If you want to quit out of the game, pressing the buttons A, B, Start and Select all at the same time exits the emulator.

Controls for the games themselves are mapped on a per-game basis, most should be quite intuitive though.

## Which ROMs are there?

The current Release build comes packaged with the following ROMs:

* Airplane (Game)
* AstroDodge (Game)
* Blinky (Game)
* Breakout (Game)
* Cave (Game)
* Kaleidoscope (Demo)
* Particle (Demo)
* Pong (Game)
* Sierpinski (Demo)
* Trip8 (Demo)
* Fall (Demo)

If you clone the repository you can add your own CHIP-8 ROMs and assemble a new GB ROM, all you need to do is to change the `src/roms.asm` file to your needs. A description of the file format can be found at the top of the file.

## What does it look like?

Except for the menu parts of the emulator, it's simply just a common CHIP-8 display. For convenience, the emulator scales the screen up by a factor of 2, so that things are visible without having to squint at them.

But it's probably best to see for yourself:

![Pong](./img/pong.gif)

![Breakout](./img/breakout.gif)