Skip to content

nyancient/koro8

Repository files navigation

koro8

A CHIP-8 emulator with a Korone-based sound chip.

Usage

  1. Make sure you have Java installed, at version 11. If not, get it from adoptium.net.

  2. Download the JAR from the latest release.

  3. Get some roms to run. The default key map is QWER to 123C, ASDF to 456D, ZXCV to 789E, and 1234 to A0BF. Most roms use 2, 4, 6 and 8 for directional input, which maps to W, A, D and X respectively.

    Breakout is a great choice for experiencing the cutting-edge doggo sound chip of koro8. Using the default key map, the A and D keys control the paddle.

  4. Run koro8 with the path to one of your downloaded roms as argument: java -jar koro8-0.1.2-min.jar /path/to/some/rom.ch8. You can also fine-tune various parts of koro8's appearance and behaviour.

See (and, more importantly, listen to) koro8 in action:

koro8.mp4