Skip to content

sarahmence/cookie

Repository files navigation

cookie

Open-source Chip-8 emulator

Usage

First, install the app via the Snap Store or by installing the Snap package contained in the Releases tab on the repository homepage. It can also be installed by entering sudo snap install --edge cookie in your terminal.

Run the app via Terminal or your chosen program manager. It will display a file chooser dialog allowing you to select a ROM file. Your ROM must have the file extension c8 or C8 to be able to select it. Three sample ROM files are located in the repository, and more are available online.

Controls

The emulator uses a sixteen-key hex controller. This is accomplished through the 1-4, Q-R, A-F, and Z-V keys on your keyboard. The key mapping is as follows:

Emulator keys:

1 2 3 C	
4 5 6 D	
7 8 9 E
A 0 B F

Keyboard keys:

1 2 3 4
Q W E R
A S D F
Z X C V

Contributing

Contributions to Cookie are welcome, so if you have any ideas, feel free to open a pull request or an issue.

License

Cookie is licensed under the GNU General Public License (version 3).