One of thousands of Rust implementations of a CHIP-8 interpreter
chip-8-emulator
chip-8-interpreter
chip8
contributions-welcome
emulator
interpreter
open-source
rust
sdl2
- Rust 100%
| .forgejo/workflows | only run on PR so we dont rerun everything on main | |
| assets | readme | |
| src | clippy \o/ | |
| .gitignore | implement instructions and basic drawing | |
| Cargo.lock | update lockfile | |
| Cargo.toml | bump minor version | |
| LICENSE.md | docs | |
| README.md | release | |
nibble8
an image showing the output of a chip 8 rom, i.e. the letters C8
Yet another Rust crate for a Chip-8 interpreter, using sdl2.
Prerequisites
The Rust toolchain should be installed.
SDL2 development library >= 2.0.5 must also be installed. See here for installation instructions.
Usage
From source
git clone https://github.com/hgrsd/nibble8
cargo run --release <path_to_rom.ch8>
Install binary
cargo install nibble8
nibble8 <path_to_rom.ch8>
Running the test suite
cargo test
Literature
See the following articles on the Chip 8 instruction set.
- https://tobiasvl.github.io/blog/write-a-chip-8-emulator/
- http://devernay.free.fr/hacks/chip8/C8TECH10.HTM
Contributions
Very welcome! Feel free to open a PR or to open a new issue.