gr8 - a Chip-8 emulator

A small Chip-8 emulator written in Go.

Installing

via Go

go install github.com/aricodes-oss/gr8@latest

from source

First, clone the repository and cd into it. Then,

go install .

Alternatively, you can use go run to run directly from source:

go run main.go /path/to/rom.ch8

Running

Simply invoke the command with the path to a valid ROM file:

gr8 /path/to/rom.ch8

For convenience I have included the 8 roms from Timendus' chip8-test-suite in the roms/ directory in this repository.

For more options, see the usage page:

Usage:
  gr8 [flags]

Flags:
  -h, --help        help for gr8
  -s, --scale int   screen scaling factor (default 16)