aboutsummaryrefslogtreecommitdiff
path: root/projects/chip8emu.md
blob: daceb7237a91b4f1a488eb664b495aae23b6b6f3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
name = CHIP8Emu
description = An Emulator/Interpreter for CHIP-8.
tags = C++
url = /projects/chip8emu
template = project.html
links = [
    href = https://github.com/compromyse/autograd
    label = SOURCE
]
priority = 2
---

<img src="https://github.com/compromyse/CHIP8Emu/assets/71056504/f87e9e73-f880-4d60-a61b-cdb40791211b" class="mx-auto" />

## About The Project

CHIP8Emu is an emulator for the 1977 interpreter CHIP-8 written in C++. It aims to make games designed for the same playable on modern hardware.

## Compilation & Usage

For compilation, you need Clang, CMake, GNUMake, and SDL2. With them installed, run the following.
```sh
mkdir build; cd build
cmake ..
make
```

Replace `[scale]` with your preferred display scaling, `[delay]` with the your preferred delay, and `[ROM]` with the path to the game you intend to play.
```sh
./chip8emu [scale] [delay] [ROM]
```