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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file CHIPy8-0.1.2.tar.gz.

File metadata

  • Download URL: CHIPy8-0.1.2.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.5

File hashes

Hashes for CHIPy8-0.1.2.tar.gz
Algorithm Hash digest
SHA256 4c9b3f6b7a0995d4aeabb8ba24f830a8d632384a889930df925236a31432111b
MD5 bc4dc37957359c14bdf2d96c9a4c975e
BLAKE2b-256 b2c7a5ccbb7b9a9f2fbabd64dbab2d870615c120e6221535681593f78d683648

See more details on using hashes here.

File details

Details for the file CHIPy8-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: CHIPy8-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 15.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.5

File hashes

Hashes for CHIPy8-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a1e2d3b38532a10973e4cd180c74f408e8e0dad7c778387531427b0565cf1c4f
MD5 65968da940acd374ceecc7d26f59a04e
BLAKE2b-256 4fdec9e23cbd680f6d10fb8beabddee3eeadd9114bd28879efb42fd88168c815

See more details on using hashes here.

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