Skip to content

Ferryistaken/CHIP8-rs

Repository files navigation

View a writeup of this project on my website


CHIP8-rs - A chip 8 emulator written in pure rust

Rust Languages Size Issues License Commits this month

Description

This is a simple chip 8 emulator written in rust, mainly developed for learning.
The goal of this emulator isn't to write a very efficient and memory safe one, we already have those, what I am trying to do is writing an emulator which is easy to understand, so that even an unexperienced coder can understand what's going on.

Getting Started

This program was tested in linux only, but should work in windows just fine

Compile from source

Dependencies

  • rust - to have the std and core components of rust
  • cargo - to compile rust code

Step by step guide

  1. git clone https://github.com/Ferryistaken/CHIP8-rs.git
  2. cd CHIP8-rs
  3. cargo build --release
  4. Move the binary into your path (Ex. mv target/release/CHIP8-rs /usr/bin/)

Executing program

chip8-rs -c 10 -d --rom <path to rom>

Arguments -c and -d are optional, they default to 10 and false, they stand for clock(it's really a delay) and debug mode, which by default is off.

Help

If you have any problems create a new issue.

Contributors

Contributors names and contact info

Alessandro Ferrari - Site

More Pictures

License

This project is licensed under the MIT License - see the LICENSE.txt file for details