Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/estebanborai/chip-8
🕹 CHIP-8 Interpreter
https://github.com/estebanborai/chip-8
chip8 cpu emulator rust sdl2
Last synced: 21 days ago
JSON representation
🕹 CHIP-8 Interpreter
- Host: GitHub
- URL: https://github.com/estebanborai/chip-8
- Owner: EstebanBorai
- Created: 2021-11-24T02:00:25.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-17T14:31:04.000Z (3 months ago)
- Last Synced: 2024-10-02T09:21:54.594Z (about 1 month ago)
- Topics: chip8, cpu, emulator, rust, sdl2
- Language: Rust
- Homepage: http://devernay.free.fr/hacks/chip8/C8TECH10.HTM
- Size: 133 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Support: support/1-chip8-logo.ch8
Awesome Lists containing this project
README
## Running it Locally
```bash
cargo run ./roms/IBM.ch8
```
## Prerequisites
You may need to setup some libraries in order to run this project locally.
### macOS
- SDL2: Install it with brew using `brew install SDL2`
Then either extend the `LIBRARY_PATH` environment variable to include
Homebrew's installed libraries by adding:
```bash
export LIBRARY_PATH="$LIBRARY_PATH:$(brew --prefix)/lib"
```
To your `~/.zshenv` or `~/.bash_profile` or specify the environment variable
when running `cargo run`.
```bash
LIBRARY_PATH="$LIBRARY_PATH:$(brew --prefix)/lib" cargo run roms/INVADERS
```
> Alternative option could be: `LIBRARY_PATH="$LIBRARY_PATH:/opt/homebrew/lib" cargo run -- ./roms/INVADERS`
### Linux
> Feel free to open a PR providing Linux system setup
### Windows
> Feel free to open a PR providing Windows system setup
## References
- [Cowgod's Chip-8 Technical Reference v1.0](http://devernay.free.fr/hacks/chip8/C8TECH10.HTM#0.0)
- [Wikipedia Chip-8 Page](https://en.wikipedia.org/wiki/CHIP-8)