Introduction

This is a CHIP-8 Virtual Machine built in Zig.

Resources

These were the most useful CHIP-8 references used during development:

• Mastering Chip-8
• Cowgod's Chip-8 Reference

Requirements

You need to have SDL2 installed, including development headers.

On macOS:

brew install sdl2

If necessary, ensure your library path includes SDL2:

export LIBRARY_PATH="$LIBRARY_PATH:/opt/homebrew/lib"

On Ubuntu/Linux:

sudo apt update
sudo apt install libsdl2-dev pkg-config

Make sure you also have Zig installed.

Usage

To use this project, follow these steps:

1. Clone the repository to your local machine:

git clone <repository_url>
cd <repository_name>

2. Run the program with the path to your game file:

zig build run -- /path/to/game

Debug Logging

To enable debug logging and save the output to a file (debug.log), use the following command:

zig build run -- /path/to/game

Games

You can find public-domain CHIP-8 games here.

License

This project is released under an open license for educational and personal use.