Metadata-Version: 2.1
Name: CHIPy8
Version: 0.0.5
Summary: CHIP8 interpreter
Home-page: https://github.com/jtl125/CHIPy8
Author: Jaime Travesedo
Author-email: jaimetravesedo125@gmail.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/jtl125/CHIPy8/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 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
```

### Future development

- Parallelize the cpu and counter threads for a more accurate emulation
- 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](https://tobiasvl.github.io/blog/write-a-chip-8-emulator) by Tobias V. Langhoff as well as inspiration from [Yet Another (Super) Chip 8 Emulator](https://tobiasvl.github.io/blog/write-a-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

