Skip to content

Latest commit

 

History

History
47 lines (33 loc) · 1.09 KB

README.md

File metadata and controls

47 lines (33 loc) · 1.09 KB

chip8

This is my implementation of a CHIP-8 emulator. It was a fun bite-sized project I finished in a day to introduce me to emulators.

I've tried the emulator with some games and it seems to behave correctly. It passes the chip8-test-suite by Timendus and I've tried it with the Tetris rom as well as Breakout.

Audio has not been implemented. Neither does it implement the drawing quirk of the original chip8 being limited in the amount of sprite draws.

Installing

To install simply run the commands

$ git clone https://github.com/Quaqqer/chip8.git
$ cd chip8
$ cargo install --path .

and to run it run the commands

$ chip8 <path/to/rom>

If you wish to run it without installing simply run

$ git clone https://github.com/Quaqqer/chip8.git
$ cd chip8
$ cargo run <path/to/rom>

It has also been packaged for Nix users, but if you use Nix I hope you know how to install it yourself with the provided flake.