chip8-odin

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

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

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

You need to have SDL2 installed, including development headers.

brew install sdl2

If necessary, ensure your library path includes SDL2:

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

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

Make sure you also have Odin installed. You can download it from odin-lang.org or install it via package manager.

To use this project, follow these steps:

1. Clone the repository to your local machine:

git clone <repository_url>
cd <repository_name>

2. Build and run the program with the path to your game file:

cd src
odin build . -file -out:../chip8
../chip8 /path/to/game

Or build and run in one step:

cd src
odin run . -- /path/to/game

Debug logging is enabled by default and outputs to debug.log. The logger is configured in the main procedure.

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

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