Ruschip - A CHIP-8 Emulator written in Rust

Features

• Supports multiple CHIP-8 variants
• Supports most—if not all—of the quirks, and they can be toggled
• Supports customization of display colors
• Supports the loading of custom CHIP-8 fonts

Emulator Specifications

• Runs @ 1680 instructions per second
• The CHIP-8 call stack doesn't have a maximum size limit

Usage

checkout ruschip --help for usage information

Compilation

You might want to use the pre-built binaries provided here

Prerequisites

• rust compiler (rustc) and cargo
• git or Github cli (gh)

1. Clone this repository

gh repo clone SegmentationViolator/Ruschip

OR

git clone https://github.com/SegmentationViolator/Ruschip.git

2. Install dependencies, compile the binary and install it

cargo install --path Ruschip

For pasting it all at once

git clone https://github.com/SegmentationViolator/Ruschip.git
cargo install --path Ruschip

Issues

Known issues:

• The sound and delay timers might be a bit inconsistent as they depend on the frame rate being 60 fps (which might not always be the case)

References

Cowgod's Chip-8 Technical Reference v1.0
Octo - Mastering SuperChip
CHIP-8 extensions and compatibility