Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cookerlyk/Chip8

Chip-8 Interpreter written in C
https://github.com/cookerlyk/Chip8

emulator interpreter sdl2 system

Last synced: about 1 month ago
JSON representation

Chip-8 Interpreter written in C

Awesome Lists containing this project

README

        

# Chip8
A Chip-8 Interpreter written in C.

Currently, the interpreter is in a playable state. The only missing core features are the system buzzer and more accurate timing for the execution of the system.

Some information about Chip-8 can be found [here](https://en.wikipedia.org/wiki/CHIP-8)

### Screenshots:
chip8_pong

chip8_space_invaders

## Building and Running:

To build the project run:

```
location/of/project make
```
Running from the command line:

```
./chip8 path/to/rom
```
Running from the command line with logging enabled:

```
./chip8 path/to/rom log
```
### Compatibility:
Verified compatible with Linux and Mac OS.

### Dependencies:
GNU C compiler

Command line tools if you are on Mac OS

[SDL2](https://www.libsdl.org/download-2.0.php) installed on your machine

A copy of a Chip-8 Rom

## Keyboard Layout:

### Chip8 Keypad:
| | | | |
|---|---|---|---|
| 1 | 2 | 3 | C |
| 4 | 5 | 6 | D |
| 7 | 8 | 9 | E |
| A | 0 | B | F |

### Emulator Keyboard Mapping:
| | | | |
|---|---|---|---|
| 1 | 2 | 3 | 4 |
| Q | W | E | R |
| A | S | D | F |
| Z | X | C | V |

'esc' Key : Close the Emulator

'Spacebar' : Pause / Resume the Emulator

'F5 Key' : Reset the emulator