Skip to content

Latest commit

 

History

History
71 lines (44 loc) · 1.2 KB

README.md

File metadata and controls

71 lines (44 loc) · 1.2 KB

Chip-8 Emulator

Run the emulator in your browser here.

Controls

The controls follow a standard mapping and are mapped to the following keys:

1 2 3 4
q w e r
a s d f
z x c v

It's up to the specific games for what action each key performs.

Installation Instructions

There are two options for running the emulator: SDL (gui) or WASM (in the browser).

SDL

First, clone this repo to your computer.

Then navigate to the desktop folder.

cd desktop/

Next, run:

cargo run <path_to_chip-8_rom>

WASM

First, clone this repo to your computer.

Then navigate to the web folder.

cd web/

Next, run a web server using your preferred method. For example:

python3 -m http.server

Finally, browse to the website's address that is being served by the web server in your browser.

Usage

Click Browse... to upload a Chip-8 ROM from your computer.

Have fun!

Credits

A big thanks to the following resources: