nes

Summary

This is an NES emulator written in Go.

Screenshots

The link below contains hundreds of screenshots that were generated automatically by loading a ROM, emulating for a few seconds and then saving the screen.

http://www.michaelfogleman.com/static/nes/

Usage

go get github.com/fogleman/nes
nes <rom_file.nes>

The go get command will automatically fetch the dependencies listed below, compile the binary and place it in your $GOPATH/bin directory.

Dependencies

github.com/go-gl/gl/v2.1/gl
github.com/go-gl/glfw/v3.1/glfw
code.google.com/p/portaudio-go/portaudio

Controls

Joysticks are supported, although the button mapping is currently hard-coded. Keyboard controls are indicated below.

Mappers

The following mappers have been implemented:

• NROM (0)
• MMC1 (1)
• UNROM (2)
• MMC3 (4)

These mappers cover about 75% of all NES games. I hope to implement more mappers soon. To see what games should work, consult this list:

NES Mapper List

Known Issues

• the APU DMC channel is not yet implemented
• there are some minor issues with PPU timing, but most games work OK anyway
• some games just show a black screen, not sure why yet