This project implements the Chip-8 virtual machine according to the technical reference written by Cowgod.
- Open a console window.
- run
git clone https://github.com/pyreking/chip-8.git
to clone this repository. - run
cd chip-8/emulator
to go to the project directory. - run
python chip8.py
to run the emulator.
- Click
File
on the file menu and then clickOpen
to load a rom. - Choose a rom from the
chip-8/roms
folder in the file browser and then click theOpen
button.
- Click
Settings
on the file menu and then clickPreferences
to change the default controls. - Click on the key that you want to remap and then press any button to set the new key binding.
Key | Chip-8 Key |
---|---|
1 | 1 |
2 | 2 |
3 | 3 |
4 | C |
Q | 4 |
W | 5 |
E | 6 |
R | D |
A | 7 |
S | 8 |
D | 9 |
F | E |
Z | A |
X | 0 |
C | B |
V | F |
Option | Key Combination |
---|---|
Open | Ctrl+P |
Load State | Ctrl+S |
Save State | Ctrl+L |
Exit | Ctrl+W |
Pause/Unpause | Ctrl+P |
Rewind | Ctrl+J |
Fast Forward | Ctrl+K |
Preferences | Ctrl+B |
CHIP-8 technical specification by Cowgod.
How to Create Your Very Own Chip-8 Emulator by Eric Grandt.