Skip to content

SegmentationViolator/Ruschip

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 @ 1680 instructions per second
  • The CHIP-8 call stack doesn't have a maximum size limit
  • Follows the specifications mentioned in this

Usage

checkout ruschip --help for usage information

Compilation

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

Requirement

  • 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
  1. 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)