menuLinkedinGitubEmailYoutubeSoundCloudSkip to content


A CHIP-8 emulator written in python


  • Python

  • pygame

About this project

kanzchip-8 is a python based CHIP-8 emulator I made together with my friend Chris Stewart, cstewart90 on github.

What is CHIP-8?

Snipped from wikipedia: "CHIP-8 is an interpreted prgramming language, developed by Joseph Weisbecker. It was initially used on the COSMAC VIP and Telmac 1800 8-bit microcomputers in the mid-1970s. CHIP-8 programs are run on a CHIP-8 virtual machine. It was made to allow video games to be more easily programmed for these computers."

CHIP-8 has 35 instructions that are all two bytes long. We have implemented the instructions based on Cowgod's Chip-8 technical reference.

How to run kanzchip-8

From the root folder of the repository, run python -m src. To run unit tests run python -m unit-test. To run with debug logs run python -m src -d


kanzchip-8 was developed with Python 3.9 and pygame, run pip install -r requirements.txt to install all modules needed to run the emulator.

Menu bar

The menu bar holds functions to load a ROM file, reset the currently playing ROM, set CPU rate, sound volume as well as setting shift quirks on or off, which affects how the bit-shift instructions are working.

View on Github