https://github.com/deciduously/chip8

CHIP-8 Emulator with SDL2 and WebAssembly targets
https://github.com/deciduously/chip8

chip8 rust wasm

Last synced: 4 months ago
JSON representation

CHIP-8 Emulator with SDL2 and WebAssembly targets

• Host: GitHub
• URL: https://github.com/deciduously/chip8
• Owner: deciduously
• License: bsd-3-clause
• Created: 2020-07-08T04:06:37.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-03-04T00:12:26.000Z (over 3 years ago)
• Last Synced: 2026-01-24T18:51:53.200Z (4 months ago)
• Topics: chip8, rust, wasm
• Language: Rust
• Homepage: https://deciduously.github.io/chip8/
• Size: 745 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# chip8

Yet another Rust/WASM Chip8.  Targets SDL2 and/or an HTML5 canvas via WebAssembly.

## Usage

To run the native renderer, use `make` or `make native`.  By default it will run [corax89/chip8-test-rom](https://github.com/corax89/chip8-test-rom).  Use `--rom/-r` directly with `cargo` to pass a game name: `cargo run --features="sdl" -- -r brix`.  Game ROMs are compiled in to the library.

To build the WebAssembly frontend, first run `make deps`.  Use `make dev` and point your browser to `localhost:8080` to use the local development build.  For sorta-kinda "hot reloading", keep that terminal open, and use `make wasm` in another terminal to rebuild the Wasm module on change, the dev server will pick it up.  To deploy the compiled site to `docs/`, run `make deploy`.

The source includes the [Chip8 Games Pack](https://www.zophar.net/pdroms/chip8/chip-8-games-pack.html) as well as the above tester.

## Acknowledgements

* This [awesome blog post](http://www.multigesture.net/articles/how-to-write-an-emulator-chip-8-interpreter/) by [Laurence Muller](http://www.multigesture.net/about/).

* The [Chip8](https://en.wikipedia.org/wiki/CHIP-8) Wikipedia article.

* The [Binary-coded decimal](https://en.wikipedia.org/wiki/Binary-coded_decimal) Wikipedia article.