Skip to content

Latest commit

 

History

History
38 lines (30 loc) · 1.06 KB

README.md

File metadata and controls

38 lines (30 loc) · 1.06 KB

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