Chip-8 Emulator

A chip-8 emulator made in golang with the sdl2 graphics libary

Tested with:

• BC-Test Rom By BestCoder
• IBM-Logo Rom
• chip8-test-rom By corax89
• Pong
• Breakout (1997 version)

Installation

Make sure to have go and sdl2 installed, refer to here for sdl-2 library instructions.

Clone repo

git clone https://github.com/shivkar2n/CHIP-8-Emulator.git

Build and run emulator

In repo directory,

cd src && go build -o ../build
cd ../build
./Chip8-Emulator ../roms/Pong.ch8

References

I followed this writeup, as well as this chip-8 reference guide, credits go to their respective authors.

Docker

To run with docker rename .env.example to .env. Only tested with unix based systems that use X11 display-server, audio is not yet supported

xhost + # Allow connections from any host
docker-compose up -d
xhost - # Change permissions to default