https://github.com/jovialen/chip8

An implementation of the Chip8 interpreter by Joseph Weisbecker in Rust.
https://github.com/jovialen/chip8

chip8 emulator rust

Last synced: 16 days ago
JSON representation

An implementation of the Chip8 interpreter by Joseph Weisbecker in Rust.

• Host: GitHub
• URL: https://github.com/jovialen/chip8
• Owner: jovialen
• License: apache-2.0
• Created: 2022-10-15T20:31:25.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-11-15T08:46:53.000Z (about 2 years ago)
• Last Synced: 2024-11-19T18:00:22.020Z (3 months ago)
• Topics: chip8, emulator, rust
• Language: Rust
• Homepage:
• Size: 135 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Chip8 Emulator

An implementation of the [Chip8](https://en.wikipedia.org/wiki/CHIP-8) interpreter by Joseph Weisbecker in Rust.



  



## Use

To use this project, [the Rust programming language](https://www.rust-lang.org/) must be downloaded and installed on your system.

Either download or clone the repository to your local machine, and then build and run it with [cargo](https://doc.rust-lang.org/cargo/index.html).

```console

foo@bar:~$ ./chip8-emu [OPTIONS]

```

To see all available options, use the help flag.

```console

foo@bar:~$ ./chip8-emu --help

```

## ROMs

This project only contains the emulator, and not any ROMs to run on it. Many interesting Chip8 ROMs can be found [here](https://github.com/kripod/chip8-roms).

## Keypad mapping

**On the original Chip8**

|     |     |     |     |

| --- | --- | --- | --- |

| 1   | 2   | 3   | C   |

| 4   | 5   | 6   | D   |

| 7   | 8   | 9   | E   |

| A   | 0   | B   | F   |

**On keyboard**

|     |     |     |     |

| --- | --- | --- | --- |

| 1   | 2   | 3   | 4   |

| Q   | W   | E   | R   |

| A   | S   | D   | F   |

| Z   | X   | C   | V   |