Skip to content

Dudssource/stunning-flop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Stunning Flop

Sample chip-8 emulator written in Go.

Video/Keyboard handling is done by using the amazing raylib library.

Running on Windows

In order to run the emulator locally on Windows, we embedded the raylib.dll file inside the root path of this project. That's the only dependency besides go >= 1.22 to run the project (CGO is not needed).

Inside the test-roms folder there are many public Chip-8 Roms available from the internet, to run one of this ROMs just open a command prompt and type:

go run main.go -f test-roms\$ROM_NAME

Using

ESC: Quits the emulator

Keyboard

The chip-8 keyboard mapping was taken from here.

Chip-8 Pinpad            Keyboard
+-+-+-+-+                +-+-+-+-+
|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|
+-+-+-+-+                +-+-+-+-+

Screenshots

Invaders

Invaders

Pong

Pong

References

I wouldn't be able to to this this work without the help of many other emulator developers, so here's the list of references I used:

About

Educational/sample chip-8 emulator written in golang

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages