A CHIP-8 emulator with an assembler and a debugger
- Platforms: CHIP-8 (COSMAC VIP), Hires CHIP-8, SUPER-CHIP, and XO-CHIP. Open ROM selects the platform from the file extension or from the program.
- A code editor with an assembler, a disassembler, syntax colors, help on hover, and autocomplete
- Source-level debugging: breakpoints with conditions, logpoints, watchpoints, a trace, and a profiler
- Step back, frame back, and rewind, from a history of the last frames
- Save states
- A C++23 compiler
- CMake 3.21 or newer for the presets (3.14 or newer without them)
- vcpkg, with the
VCPKG_ROOTenvironment variable set - OpenGL 4.5
vcpkg installs all the libraries. vcpkg.json lists them:
- SDL3
- GLAD
- Glaze for the settings file
- Dear ImGui (docking branch)
- ImGuiColorTextEdit (Johan A. Goossens fork)
- imgui_club memory editor
The vcpkg registry does not have the last two libraries. The ports directory holds overlay ports for them.
See BUILDING.md for a user build. See HACKING.md for a developer build.
- docs/assembler.md: the assembly language
- docs/debugging.md: the debugger, the history, and the save states
C8Emu keeps its files in the user data folder. On Windows, this folder is
%APPDATA%\cbrl\C8Emu. The Log shows the folder when C8Emu starts.