CHIP-8 Emulator 🕹️

This project attempts to emulate a CHIP-8 system using idiomatic C++. This project follows the specifications from Cowgod. The graphics were created with SDL 2. Tests were created with GoogleTest.

Examples

Getting Started

After cloning the repository, execute the following from the project directory:

mkdir build
cd build
cmake ..
make

Usage:

./main <window scale> <delay in ms> </path/to/rom>

For example:

./main 10 2 ../demo-roms/tetris.ch8

To run the tests execute the following:

cd build
ctest

Credits

https://austinmorlan.com/posts/chip8_emulator/: Learning resource

https://tobiasvl.github.io/blog/write-a-chip-8-emulator/: Learning resource

https://github.com/corax89/chip8-test-rom/blob/master/README.md: opcode_test.ch8

https://github.com/dmatlack/chip8/tree/master/roms: Remaining ROMs (Credits are listed in the repo)