chip-8

A simple Rust implementation of a Chip-8 emulator.

It uses EasyCurses, which is built on pancurses, for display, keyboard input, and sound, so any platform that EasyCurses/pancurses run on, this should as well.

Building

cargo build

Running

Usage: chip-8 [options] ROM

Options:
    -d, --debug         display debug info
    -h, --help          display this help message

ROMs

Searching for "chip-8 roms" yields many links to various ROMs that should run on this emulator. I used this test ROM, which exercises the various features of the Chip-8. I also tested with PONG, PONG2, and INVADERS.

Here are two sites with public domain ROMs:

Zophar's Domain
dmatlack/chip8

Reference Documents

Wikipedia: Chip-8
Cowgod's Chip-8 Technical Reference
An Easy Programming System, Byte Magazine, December, 1978
Mastering Chip-8
How to write a Chip-8 Interpreter
Writing a CHIP-8 emulator with Rust and WebAssembly
Introduction to Chip-8

Inspirational Projects