Ruschip - A CHIP-8 Emulator written in Rust
Features
- Supports multiple CHIP-8 variants (planned not added)
- 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
- Passes all the tests from Timendus/chip8-test-suite (v4.0)
- Runs @ 720 Hz (12 instructions per frame, 60 frames per second)
- The CHIP-8 call stack doesn't have a maximum size limit
- Follows the standard CHIP-8 specifications; see this and this for more details
Usage
checkout ruschip --help
for usage information
Compilation
You might want to use the pre-built binaries provided here
Requirements
- mold linker
- rust compiler (rustc) and cargo
- git or Github cli (gh)
- Clone this repository
gh repo clone SegmentationViolator/Ruschip
OR
git clone https://github.com/SegmentationViolator/Ruschip.git
- 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: