CHIP-8 Interpreter

A basic CHIP-8 interpreter that can run roms without any extensions i.e. Super CHIP-8.

No roms? No problem! Upon running this emulator, you will be presented with roms from chip8Archive -- a repo full of CHIP-8 roms all licenced under Creative Commons 0. This list will only contain roms that can be run by this interpreter.

Input Mapping

Original	Remapped
1 2 3 C 4 5 6 D 7 8 9 E A 0 B F	1 2 3 4 Q W E R A S D F Z X C V

Playing!

Because the SDL2 C library is dynamically linked via the sdl2 crate, you will need to build this project. If the SDL2 dynamic library isn't automatically generated, you can get it from here: SDL2 Releases.

Clone this repo and run cargo build --release in the project's root directory. Once built, you can run the executable in the target/release folder. Be sure to verify that the SDL2 library is in the same directory as the executable or it will not work!

Resources

• mattmikolay's CHIP-8 Technical References
• Cowgod's Techinical Referece
• Overview on how emulators work

Main dependencies

• sdl2
• imgui
• glow
• serde
• serde_json
• reqwest