chip8/README.md
2021-08-09 21:54:43 +02:00

1.1 KiB

Chip-8

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

Screenshot of executing bin/chip8 pong.ch8

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