/chip8swemu-sdl2

Multiplatform CHIP-8 and Super-CHIP emulator

Primary LanguageCMIT LicenseMIT

chip8swemu-sdl2

Multiplatform CHIP-8 and Super-CHIP emulator.

Features

chip8swemu-sdl2 is a port of chip8swemu for the desktop based on SDL2 and Dear ImGui.

  • Frontend compatible with Windows and Linux.
  • Configurable CPU clock rate, 840Hz by default.
  • Configurable color palette, black and white by default.
  • Compatibility modes for games that require special settings.
  • ROM files can be passed as an argument or dropped to the window.
  • Native file selection dialog (only available on Windows).

Releases

Building

How to build on Linux (Ubuntu)

  1. Clone this repository, including the submodules: git clone --recurse-submodules https://github.com/AlfonsoJLuna/chip8swemu-sdl2
  2. Install SDL2 development libraries: sudo apt-get install libsdl2-dev
  3. Open a terminal in the root folder of the repository and type: make

How to build on Windows

  1. Clone this repository, including the submodules: git clone --recurse-submodules https://github.com/AlfonsoJLuna/chip8swemu-sdl2
  2. Download and install the mingw-w64 toolchain. Be sure you check Add to PATH during installation.
  3. Download SDL 2.0.22 libraries for MinGW and extract them to chip8swemu-sdl2/libraries/SDL2-2.0.22/...
  4. Open a terminal in the root folder of the repository and type: mingw32-make
  5. Copy the SDL2.dll file from chip8swemu-sdl2/libraries/SDL2-2.0.22/x86_64-w64-mingw32/bin/ to chip8swemu-sdl2/build/