Skip to content
/ GB-8 Public

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

License

Notifications You must be signed in to change notification settings

Hacktix/GB-8

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GB-8

GitHub GitHub Release Date GitHub last commit GitHub repo size

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 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

Breakout