https://github.com/willdurand/chipolata
🌠A CHIP-8 interpreter written in Rust.
https://github.com/willdurand/chipolata
chip-8 chip8 emudev interpreter rustlang wasm
Last synced: about 1 year ago
JSON representation
🌠A CHIP-8 interpreter written in Rust.
- Host: GitHub
- URL: https://github.com/willdurand/chipolata
- Owner: willdurand
- License: mit
- Created: 2021-01-10T22:40:54.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-21T10:49:27.000Z (over 1 year ago)
- Last Synced: 2025-03-24T23:26:35.627Z (about 1 year ago)
- Topics: chip-8, chip8, emudev, interpreter, rustlang, wasm
- Language: Rust
- Homepage: https://williamdurand.fr/chipolata/
- Size: 2.33 MB
- Stars: 8
- Watchers: 2
- Forks: 3
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# chipolata
This project is a [CHIP-8](https://en.wikipedia.org/wiki/CHIP-8) interpreter
written in Rust. It can be compiled and run as a "desktop" program (cross
platform) or web application. The "desktop" program provides a simple yet useful
console debugger too.
## Usage
### Desktop
The "desktop" program should be run from the command line interface (console):
```
$ chipolata
chipolata 1.0.0
USAGE:
chipolata [FLAGS] [OPTIONS]
FLAGS:
-d, --debug Enable debug mode (debugger)
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
--speed [default: 8]
ARGS:
The path to a ROM
```
### Web App
See: https://williamdurand.fr/chipolata/
## Development
```
$ make bootstrap
```
### Desktop
You can build and run the "desktop" app with the following command:
```
$ make cli-dev rom=
```
Type o in the display window to start the debugger (in the console).
### Web App
You can build and run the web app in development mode with the following
command:
```
$ make dev
```
## Links
- https://en.wikipedia.org/wiki/CHIP-8
- http://www.multigesture.net/articles/how-to-write-an-emulator-chip-8-interpreter/
- http://www.multigesture.net/wp-content/uploads/mirror/goldroad/chip8_instruction_set.shtml
- http://devernay.free.fr/hacks/chip8/C8TECH10.HTM
- https://tobiasvl.github.io/blog/write-a-chip-8-emulator/
## License
chipolata is released under the MIT License. See the bundled
[LICENSE](./LICENSE.md) file for details.