The last time Hackerfall tried to access this page, it returned a not found error. A cached version of the page is below, or click here to continue anyway

GitHub - prophittcorey/iC8: An interpreted Chip-8 emulator written in C

iC8: An interpreted Chip-8 emulator written in C

The emulator is complete and is able to run all Chip-8 games and demos. The data folder contains a collection of common Chip-8 games that are freely available. See data/roms/ for the game credits.


This readme assumes you have the following installed:

  1. make
  2. gcc or clang

iC8 was developed on OSX and tested on Linux. The make file does not consider Windows environments and compilation on Windows would have to be done manually. The make file can be modified to specify your system's compiler preference as well as SDL2 library and include paths.


The Makefile has an init task that installs all required libraries. You can run the task via:

You can globally install and uninstall via the Makefile as well:


The emulator is meant to be used via the command line. You can run a game via the command line by executing ic8 with a single argument (a path to a Chip-8 game).

Example Usage:


The Chip-8 system uses an odd keypad. The layout is as follows:


Each game uses some of the keys and there is no real pattern to the key layouts so each game usually requires some fiddling around to figure out the keys.


An interpreted Chip-8 emulator.
Copyright (C) 2015, Corey Prophitt.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <>.

Continue reading on