https://github.com/morinokami/py.chip8
CHIP-8 emulator written in Python
https://github.com/morinokami/py.chip8
Last synced: 4 months ago
JSON representation
CHIP-8 emulator written in Python
- Host: GitHub
- URL: https://github.com/morinokami/py.chip8
- Owner: morinokami
- Created: 2019-08-17T14:06:32.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2021-04-20T18:23:34.000Z (about 4 years ago)
- Last Synced: 2025-03-11T11:14:27.646Z (4 months ago)
- Language: Python
- Size: 316 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# (Yet Another) CHIP-8 Emulator
## Usage
```sh
$ python3 -m venv venv
$ pip install -r requirements.txt
$ make help
usage: make ROM=[rom]
positional arguments:
rom 0. 15PUZZLE, 1. BLINKY, 2. BLITZ, 3. BRIX, 4. CONNECT4, 5.
GUESS, 6. HIDDEN, 7. INVADERS, 8. KALEID, 9. MAZE, 10. MERLIN,
11. MISSILE, 12. PONG, 13. PONG2, 14. PUZZLE, 15. SYZYGY, 16.
TANK, 17. TETRIS, 18. TICTAC, 19. UFO, 20. VBRIX, 21. VERS, 22.
WIPEOFF
optional arguments:
-h, --help show this help message and exit
$ make ROM=7
```
## Key Mapping
```
Keypad Keyboard
+-+-+-+-+ +-+-+-+-+
|1|2|3|C| |4|5|6|7|
+-+-+-+-+ +-+-+-+-+
|4|5|6|D| |R|T|Y|U|
+-+-+-+-+ => +-+-+-+-+
|7|8|9|E| |F|G|H|J|
+-+-+-+-+ +-+-+-+-+
|A|0|B|F| |V|B|N|M|
+-+-+-+-+ +-+-+-+-+
```
## Useful References
* [Cowgod's Chip-8 Technical Reference](http://devernay.free.fr/hacks/chip8/C8TECH10.HTM)
* [How to write an emulator (CHIP-8 interpreter) — Multigesture.net](http://www.multigesture.net/articles/how-to-write-an-emulator-chip-8-interpreter/)
* [CHIP-8 - Wikipedia](https://en.wikipedia.org/wiki/CHIP-8)
* [(Super)CHIP 8 Secrets](https://github.com/AfBu/haxe-chip-8-emulator/wiki/(Super)CHIP-8-Secrets)