chip-r 🎱

"[...] maybe the games don’t have to be more complex, they need to be simple and pleasing. That’s where the sweet spot is!" - Allan Alcorn

• A simple (with hidden bugs 👀) CHIP-8 emulator built with rust.
• Tested on macos, but since it uses sdl2 it can be compiled to multiple targets.

Usage

• Compile core: cd core && cargo build
• Compile and run the emulator: cd frontend && cargo run <path-to-rom>

Controls

Controls in CHIP-8 implementations are based on a 4x4 keyboard. In chip-r, these are the controls:

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

Resources

• I've built this to learn about emulation development and learn more about rust. Here's the guide that helped me through this journey: https://github.com/aquova/chip8-book
• CHIP-8 op codes cheatsheet: http://devernay.free.fr/hacks/chip8/C8TECH10.HTM
• Some CHIP-8 ROMs are available here: https://www.zophar.net/pdroms/chip8/chip-8-games-pack.html