chip8py
CHIP-8 interpreter written in Python
Contents
About
CHIP-8 is an interpreted language developed during the 1970s.
chip8py is an interpreter that can run any program originally designed for the CHIP-8 platform.
Installation
The project uses pygame to render the window:
python -m pip install pygame
Clone this repository into a folder:
git clone https://github.com/robertolaru/chip8py.git
Usage
Running python main.py --help will provide the list of arguments the program supports:
usage: main.py [-h] [--cps CPS] [--fps FPS] [-c] [-m] program
positional arguments:
program path to the program to load
optional arguments:
-h, --help show this help message and exit
--cps CPS cycles per second. Default is 500 cps
--fps FPS window rendering framerate. Default is 30 fps
-c, --cpu-view enable visualization of CPU registers, stack, opcodes
-m, --memory-view enable memory visualization. Also enables CPU visualization (like --cpu-view)
To run the program, you need to provide the path to the rom file (program) to load in the interpreter:
python main.py program
Using the keyboard
Originally, user input on CHIP-8 was done through a 16-key hex keyboard.
The interpreter maps the original keys to the leftmost portion of QWERTY keyboards:
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
(original) (interpreter)
License
chip8py is licensed under the MIT license.
24 Dec 28, 2022
1.6k Jan 04, 2023
16 Dec 13, 2021
3 Jan 02, 2023
100 Nov 04, 2022
1 Nov 03, 2021
7 Nov 30, 2022
3 Nov 25, 2021
301 Dec 28, 2022
2.9k Jan 04, 2023
1 Jan 17, 2022
834 Jan 04, 2023
3 Jan 04, 2022
2 Jan 23, 2022
11 Jul 06, 2022
3 Aug 23, 2021
5 Sep 02, 2022
24 Aug 06, 2022
11 Dec 07, 2022
1 Dec 27, 2021