Skip to content

prcastro/chip8-emulator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CHIP-8 Emulator

Simple CHIP-8 emulator written in Rust. Includes a bunch of public domain ROMs from Zophar's Domain.

Screenshot of the MAZE game running on the emulator on Windows

Getting started

Windows

Download the .exe file from the relase page on Github and drag a ROM file on top of the executable to play it. Alternatively, run from cmd:

chip8-emulator-x64-win path\to\rom

macOS

Download the macos binary from the relase page on Github and run from a terminal:

./chip8-emulator-aarch64-macos path/to/rom

Controls

The original controls:

1 2 3 C
4 5 6 D
7 8 9 E
A 0 B F

Are translated as:

1 2 3 4
Q W E R
A S D F
Z X C V

Building the project

Make sure you have Rust installed. You should be able to run cargo from the command line. Then run:

cargo install cargo-vcpkg
cargo vcpkg build
cargo run -r path/to/rom

About

Simple CHIP-8 emulator written in Rust

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages