https://github.com/estebanborai/chip-8

🕹 CHIP-8 Interpreter
https://github.com/estebanborai/chip-8

chip8 cpu emulator rust sdl2

Last synced: 20 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 (about 3 years ago)
• Default Branch: main
• Last Pushed: 2024-08-17T14:31:04.000Z (4 months ago)
• Last Synced: 2024-11-30T12:40:37.109Z (26 days 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)