Diesel-Net / kiwi-8

CHIP-8 interpreter for Windows and MacOS

Kiwi8

v1.03

A cross-platform Chip-8 interpreter written in C++ using SDL2, ImGui, and OpenGL.

Compatibility Notes

Downloads

Features

• Windows and MacOS
• Graphical user interface
• Audio
• Color customizer
• CPU frequency selection
• Command line support
• No SCHIP support

Usage

Kiwi8 [filename] [-FMLSV]
-F      Launch in fullscreen
-M      Launch with audio muted
-L      Disable load/store quirk
-S      Disable shift quirk
-V      Disable vertical wrapping

Building on Windows

Microsoft's Visual C++ Build Tools (vcvarsall/cl/nmake) are assumed to be installed and added to PATH.

1. Open the command prompt and navigate to the Kiwi8/Windows directory.
2. Type vcvarsall x86 to load the windows development environment.
3. Type nmake.

Building on MacOS

Apple's Xcode command line tools (clang++/make/install_name_tool) are assumed to be installed and added to PATH.

1. Open the terminal and navigate to the Kiwi8/MacOS directory.
2. Type make.

Resources

• Chip-8 wikipedia
• Emu-Docs
• Cowgod's Chip-8 Technical Reference
• SDL Wiki
• ImGui
• /r/EmuDev

---

I can highly recommend this project to anyone wanting to get their feet wet with emulator programming, video-game programming, or even cross-platform development. It has been a great educational excercise involving major aspects of modern day applications such as input handling, user-interface design, 2D graphics rendering, audio generation, code profiling and more.

Enjoy!