Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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.
- Host: GitHub
- URL: https://github.com/hacktix/gb-8
- Owner: Hacktix
- License: mit
- Created: 2021-01-08T09:51:52.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2021-09-19T11:37:21.000Z (about 3 years ago)
- Last Synced: 2024-05-21T11:28:41.207Z (6 months ago)
- Topics: chip8, chip8-emulator, gameboy, gameboy-color, homebrew
- Language: Assembly
- Homepage:
- Size: 207 KB
- Stars: 53
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
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)