Chip-8

A Chip-8 bytecode interpreter written in the ruby programming language.

Installation

⚠️ Heads up! This has only been tested on OSX.

• Install SDL by executing brew install sdl. It is used for handling keyboard events and drawing onto the screen.
• Clone the repository with the git clone command
• Navigate into the cloned folder
• Execute bundle to install required gems

Usage

$ bin/chip8
Usage: chip8 [rom]

Options:
  --debug          Prints every instruction before executing
  --dump-memory    Loads the rom and dumps the memory content

Testing

Minitest is used fot testing. Tests can be run by executing bundle exec rake.

References

• Cowgod's Chip-8 Technical Reference