Everyone's gotta write a CHIP-8 interpreter. And in my case, it's gotta be in Rust ;)
You can run a CHIP-8 ROM on the interpreter by passing it as an argument on the command line:
cargo run -- /path/to/rom
# or
cargo build --release
target/rip8 /path/to/rom
For starters, there are some fun games present in the roms
folder, along with the classic IBM logo program. Personal recommendation - play Tetris :D
The interpreter uses the standard CHIP-8 keypad mapping on a modern keyboard. It also provides the colemak
feature flag (use cargo run --features colemak
) to emulate the CHIP-8 keypad correctly on the Colemak layout.
CHIP-8 | QWERTY | Colemak | ||||||||||||||||||||||||||||||||||||||||||||||||
|
|
|
The tests
directory contains this CHIP-8 test suite, which can be used to verify the correctness of the implementation.
This project is licensed under the MIT License. Do whatever you want with it.