chip-8-emulator

CHIP-8 emulator and debugger written in C++.

Chip-8 is a simple, interpreted, programming language which was first used on some do-it-yourself computer systems in the late 1970s and early 1980s.

You can find more about CHIP-8 here:

TODO

The project is not fully implemented, here are some stuff I still need to add:

Keyboard input handling
Add timers & sounds
GUI debugger & visualizer
Windows + Linux bash scripts to compile

(Planned) Features

CHIP-8 virtual machine
CHIP-8 interpreter
CHIP-8 GUI debugger

Screenshots

Building and running

Linux

Install the packages:
- Arch based distros: sudo pacman -S git make cmake sfml
- Other distros: Idk, google it

If you have them correctly installed, it should work out of the box, so run this in your terminal:

git clone https://github.com/roby2014/chip-8-emulator
cd chip-8-emulator
mkdir build && cd build && cmake .. && make

Running:
- mv ../assets/imgui.ini .
- ./chip8

Windows (Visual Studio)

Download git, CMake latest version, SFML 2.5.1 (Visual C++ 15 (2017) - 32-bit) and Visual Studio 2022.

git clone https://github.com/roby2014/chip-8-emulator
cd chip-8-emulator
cmake -A Win32 -B build -DSFML_DIR="C:\CPP_TOOLS\SFML\lib\cmake\SFML"
cmake --build build --config Release #or open the VS solution and build it

In case you want to build via VS solution, you will need to change SFML_DIR value inside CMakeSettings.json

Running:
- Move assets/imgui.ini to your exe folder
- Now either double click the exe file or run by command line:
```
cd C:\Coding\chip-8-emulator\build\Release\
chip8.exe C:\Coding\chip-8-emulator\roms\chip8.ch8
```

More ROMS

I have included some ROMs by default inside roms/ folder, but in case you wanna try more/other games, you can download from this repository.

roby2014/chip-8-emulator