Skip to content

jbfenton/chipmul8

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

chipmul8

CHIP-8 is an interpreted programming 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

This project aims to replicate the CHIP-8 interpreter using Python, in the hopes that we can play Pong as it ran on the CHIP-8 virtual machine in the 1970's.

Installation

  1. Download / clone the repo

  2. Navigate to the chipmul8 directory

  3. Run setup.py:

    $ python setup.py install

Execution

  1. Run the 'chipmul8' command while providing a path to a chip8 rom:

    $ chipmul8 /path/to/rom/pong.c8

    chipmul8 GUI

  2. The '--invert_colors' switch can also be provided to invert the color palette of the display

    $ chipmul8 /path/to/rom/pong.c8 --invert_colors

    chipmul8 GUI

References

The primary reference for this project was Cowgod's Chip-8 Technical Reference v1.0 This technical reference is incredibly detailed, the emulator would not have taken shape without it.

For testing corax89's test roms were hugely helpful.

About

CHIP-8 Emulator

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages