CHIP-8

Cross-platform Chip-8 interpreter written in C and OpenGL.

Key Features • Installation • How To Use • Credits • License •

Key Features

• Cross-platform - utilizes GLFW to handle native window management
  • Windows
  • Linux
  • Mac
• Adjustable frame rate
• Custom resolution
• Modifiable color scheme

---

Installation

• Required modules - to clone and build this aplication the following must be installed:
  • OpenGL V4.0+
  • Git
  • CMake
• Building - From the command line run the following commands:

# Clone the repository, and enter the directory
git clone https://github.com/grez96/CHIP-8.git
cd CHIP-8

# Create the build directory (out of source build) and enter it
mkdir build
cd build

# Run CMake build system
cmake ..

• Compilation - platform dependent
  • Linux and Mac systems (Windows as well if MiniGW is installed) can simply run make to create an executable
  • Windows systems will have to open the .sln file produced by CMake with Visual Studios and compile/run from there

---

How To Use

• Main-menu - Command Line Interface
  • ROMs are numbered from 1-7, simply specify the number that corresponds to the desired ROM and press enter
  • 0 to exit
• CHIP-8 - ROM Interpreter
  • ESC to exit any time
  • Windowing features such as minimizing, maximizing, closing, and resizing work in their native expected way
  • default keybindings:

+-+-+-+-+	+-+-+-+-+
|1|2|3|C|	|1|2|3|4|
+-+-+-+-+	+-+-+-+-+
|4|5|6|D|	|Q|W|E|R|
+-+-+-+-+	+-+-+-+-+
|7|8|9|E|	|A|S|D|F|
+-+-+-+-+	+-+-+-+-+
|A|0|B|F|	|Z|X|C|V|
+-+-+-+-+	+-+-+-+-+

---

Credits

• Developed and maintained by Gleb Reznicov
• Contributors:
  • Opcode debugging and remaining implementations done by mobius1musaasum
  • Mac OSX debugging done by Xin Song Felix Zhang
• The following open source software/packages were used:
  • OpenGL
  • GLFW
  • GLAD
  • math_3d
• Chip-8 documentation:
  • Cowgod's Chip-8 Technical Reference
  • CHIP-8 - Wikipedia
• ROMs provided by dmatlack's ROM compilation

---

License

MIT