📚 nes - Awesome Go Library for Software Packages
Nintendo Entertainment System (NES) emulator written in Go.
Detailed Description of nes
Summary
This is an NES emulator written in Go.
Screenshots
Title Screens
http://www.michaelfogleman.com/static/nes/
Dependencies
github.com/go-gl/gl/v2.1/gl
github.com/go-gl/glfw/v3.1/glfw
github.com/gordonklaus/portaudio
The portaudio-go dependency requires PortAudio on your system:
To build portaudio-go, you must first have the PortAudio development headers and libraries installed. Some systems provide a package for this; e.g., on Ubuntu you would want to run apt-get install portaudio19-dev. On other systems you might have to install from source.
On Mac, you can use homebrew:
brew install portaudio
Installation
The go get
command will automatically fetch the dependencies listed above,
compile the binary and place it in your $GOPATH/bin
directory.
go get github.com/fogleman/nes
Usage
nes [rom_file|rom_directory]
-
If no arguments are specified, the program will look for rom files in the current working directory.
-
If a directory is specified, the program will look for rom files in that directory.
-
If a file is specified, the program will run that rom.
For 1 & 2, the program will display a menu screen to select which rom to play. The thumbnails are downloaded from an online database keyed by the md5 sum of the rom file.
Controls
Joysticks are supported, although the button mapping is currently hard-coded. Keyboard controls are indicated below.
Nintendo | Emulator |
---|---|
Up, Down, Left, Right | Arrow Keys |
Start | Enter |
Select | Right Shift |
A | Z |
B | X |
A (Turbo) | A |
B (Turbo) | S |
Reset | R |
Mappers
The following mappers have been implemented:
- NROM (0)
- MMC1 (1)
- UNROM (2)
- CNROM (3)
- MMC3 (4)
- AOROM (7)
These mappers cover about 85% of all NES games. I hope to implement more mappers soon. To see what games should work, consult this list:
Known Issues
- there are some minor issues with PPU timing, but most games work OK anyway
- the APU emulation isn't quite perfect, but not far off
Documentation
Interested in writing your own emulator? Curious about the NES internals? Here are some good resources: