A CHIP8 interpreter

Currently only compatible with games written in the original CHIP8 instruction set

pacman -S git make

Clone the repo and navigate to the directory:

git clone https://github.com/rondelfino/cilly.git
cd cilly

Default compilation uses gcc, and is in debug 64-bit mode:

make

Compile in release mode:

make release=1 

Compile in 32-bit mode:

make arch=32

If you want to use clang:

make CC=clang

./bin/[OS]/[build-mode]/cilly [clock-speed-in-Hz] [path/to/rom]

Or:

make run [clock-speed-in-hz] [path/to/rom]

make help to list available commands.

• Wayland/Win32 or SDL
• Quirks
• Makefile: add option to change packaged executable destination
• Accurate COSMAC-VIP support (opcode timings)
• SCHIP 1.1 support
• XO-CHIP support
  • These platforms will automatically set the respective quirks
• Flags to change change/set quirks manually
• Debugger
• GUI for rom loading, setting clock, manually setting quirks, and choosing platform

• Benchmark Program
• https://github.com/mattmikolay/chip-8/wiki/Mastering-CHIP%E2%80%908#chip-8-instructions
• https://johnearnest.github.io/Octo/docs/SuperChip.html
• https://chip-8.github.io/links/#testing
• https://github.com/JohnEarnest/Octo
• https://github.com/tobiasvl/awesome-chip-8
• https://chip-8.github.io/extensions/#chip-8