This is an emulator for the interpreted programming language Chip-8 written in Java.
for the latest release
Java 1.8 is required to run this program.
- Load and play ROMs
- Reconfigure the controls
- Change the background and sprite color
- Adjust the speed of emulation
- Save and load states
To create a standalone distribution as a zip or tar file, run:
./gradlew distZipor
./gradlew distTarThe distribution is placed under build/distributions.
To run the program from the distribution, extract the zip or tar file, and run the launch script for your system in the bin folder by typing:
./chip8in the command-line interface.
The emulator expects a US keyboard layout and has the following standard key assignments:
| Chip-8 keys | Keyboard keys |
|---|---|
| 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 |
To reconfigure the key assignments, click on the config button in the interface to
open the configuration window, change the configuration to your liking and close the window again.
The configuration will be saved under ../config/controls.dat upon closing the window.
To reset the configuration simply, click the reset button in the configuration window.
This emulator allows to load and save the states, by clicking on the corresponding buttons in the interface or using the following buttons:
| Key | Action |
|---|---|
| F5 | Save state |
| F6 | Load state |
This Emulator features a simple debug-mode and can be controlled with the following keys:
| Debug key | Action |
|---|---|
| F1 | Opens/Closes the debug-window |
| F2 | Activates/Deactivates step-by-step-mode |
| F3 | Executes the next step (one CPU-cycle) |
| F4 | Resets the CPU |
The sources used to create this emulator: