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:

• Wikipedia
• Cowgod's Chip-8 Technical Reference v1.0

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.

Keybinds

repository under dev...