README.md

CHIP-8

A CHIP-8 emulator written in Go.

Install

This package depends on:

• github.com/go-gl/glfw
• github.com/ravener/go-gl

You can use the go install command to easily fetch the code and automatically build it alongside the dependencies and add it to your $GOPATH/bin

go install github.com/ravener/chip8

Usage

chip8 <file.rom>

Controls:

Keypad             Keyboard
+-+-+-+-+          +-+-+-+-+
|1|2|3|C|          |1|2|3|4|
+-+-+-+-+          +-+-+-+-+
|4|5|6|D|          |Q|W|E|R|
+-+-+-+-+    =>    +-+-+-+-+
|7|8|9|E|          |A|S|D|F|
+-+-+-+-+          +-+-+-+-+
|A|0|B|F|          |Z|X|C|V|
+-+-+-+-+          +-+-+-+-+

• ESC to close the window.
• Space to pause the emulator.
• F11 to take a screenshot in the current directory.

Resources

• Writing a CHIP-8 interpreter - Ravener (my own blog post on this)
• CHIP-8 Instruction Set
• CHIP-8 Technical Reference

TODO

• Fix timing. (Currently I cheated by relying on V-Sync)
• Audio output.

License

MIT License