Skip to main content

CHIP8 interpreter

Project description

CHIPy8

CHIPy8 is a simple python interpreter for CHIP8. It currently lacks most functions from interpreters such as interactive file loading, save states, debugging mode, etc.

To install simply type on the terminal

pip install chipy8

And load and run any .ch8 file with the command

chipy8 file/to/rom.ch8

Alternatively you can download the binary located on the releases tab (only working for GNU/Linux at the moment). To execute first you must give it permission by typing

chmod +x CHIPy8

And then execute either by double-clicking or through the command line. When launched this way you will be greeted by a black screen, drag and drop any .ch8, .chip8 or .c8 romfile to load and run it.

Future development

  • Add simple toolbar for file loading and reseting.
  • Add customization options as well as the ability to save option presets.
  • Support for SUPER-CHIP and XO-CHIP
  • Implement a debugging mode.

Thanks

The interpreter was done following the guide to making a CHIP-8 emulator by Tobias V. Langhoff as well as inspiration from Yet Another (Super) Chip 8 Emulator project by Craig Thomas

Notes

The key mapping to the emulator is

    PAD             KEYBOARD  
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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

CHIPy8-0.1.2.tar.gz (14.8 kB view hashes)

Uploaded Source

Built Distribution

CHIPy8-0.1.2-py3-none-any.whl (15.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page