https://github.com/gargakshit/chip-8

Yet another Chip-8 interpreter, but this time with a beautiful interface 💻
https://github.com/gargakshit/chip-8

chip-8 cmake cpp dear-imgui emulator glfw interpreter opengl

Last synced: 1 day ago
JSON representation

Yet another Chip-8 interpreter, but this time with a beautiful interface 💻

• Host: GitHub
• URL: https://github.com/gargakshit/chip-8
• Owner: gargakshit
• License: bsd-3-clause
• Created: 2021-10-12T14:30:37.000Z (over 3 years ago)
• Default Branch: develop
• Last Pushed: 2022-01-06T14:12:41.000Z (about 3 years ago)
• Last Synced: 2025-01-15T02:58:18.608Z (4 days ago)
• Topics: chip-8, cmake, cpp, dear-imgui, emulator, glfw, interpreter, opengl
• Language: C++
• Homepage:
• Size: 632 KB
• Stars: 38
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Chip-8 interpreter in C++

Yet another [Chip-8](https://en.wikipedia.org/wiki/Chip-8) interpreter, this

time written in C++ using [GLFW](https://github.com/glfw/glfw) and OpenGL as its

graphics library. It uses [Dear ImGui](https://github.com/ocornut/imgui) to

draw the GUI.

### Why C++?

Because I wanted to get my hands dirty with modern C++. Last time I did C++ was

C++98 2 years ago for school.

### Screenies

![Screenshot of the interface](./screenshots/s1.png)

_CPU Interface_

https://user-images.githubusercontent.com/15605299/137485154-4aefa57f-bbb2-440e-b5be-78fd15abe903.mp4

_Screen recording of the snake game running with the chip-8 interpreter_

### Building

In theory, it should run anywhere where Dear ImGui and C++ runs and OpenGL is

available. But I only tested it on Windows.

#### Windows

You will need `cmake`, `llvm`, `make` and `git`.

- ```$ git clone https://github.com/gargakshit/chip-8 --recursive```

  Use `--recursive` as the repo contains GLFW and Dear ImGui as submodules

- ```$ cmake -Bbuild -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER="clang++" -G "MinGW Makefiles" .```

  This will produce `MinGW Makefiles` with `clang++` as the `C++` compiler.

  You can optionally add the flag `-DCMAKE_BUILD_TYPE=Release` to generate

  `MinGW Makefiles` for the release build. The release build is optimized.

- ```$ cmake --build build```

  This will build the binary. If everything is successful, the interpreter

  binary will be produced with `build/chip8.exe` as the path. At this point,

  you could run your favorite `Chip-8` "ROMs" by dragging them and dropping it

  onto the binary in the file explorer, or by using a terminal and running

  `build/chip8 path/to/my/program.ch8`. I have included some programs

  in the `programs/` directory to play with (shout out to the original program

  authors)

You can also build with VS and MSVC toolchains, but I have not tested them

personally

### Is this any good?

Yes.