Need help with nes?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

fogleman
4.7K Stars 438 Forks MIT License 196 Commits 7 Opened issues

Description

NES emulator written in Go.

Services available

!
?

Need anything else?

Contributors list

# 2,257
C
heightm...
glsl
SQLite
172 commits
# 185,365
Go
C
Shell
google-...
4 commits
# 173,535
OCaml
Go
prometh...
elastic...
2 commits
# 270,312
aws-lam...
mlops
Tensorf...
Artific...
1 commit
# 74,630
C
json-pa...
Shell
ape
1 commit
# 78,141
Python
Shell
Go
uni-app
1 commit
# 30,029
C
Shell
documen...
knowled...
1 commit
# 54,119
python3
Haskell
webcam-...
lambda
1 commit

Summary

This is an NES emulator written in Go.

Screenshots

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]
  1. If no arguments are specified, the program will look for rom files in the current working directory.

  2. If a directory is specified, the program will look for rom files in that directory.

  3. 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.

Menu Screenshot

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:

NES Mapper 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:

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.