$ Go NES Emulator

View on GitHub →

A Nintendo Entertainment System (NES) emulator written in Go. This project brings classic 8-bit gaming to life with accurate CPU emulation, PPU graphics rendering, and support for multiple cartridge mappers.

A WebAssembly version of this emulator is available at /nes. Note that you'll need your own NES ROM files to use the emulator.

Looking for ROMs? You can find them at Vimm's NES Vault.

### features

  • - Ricoh 2A03 CPU - Complete emulation of the NES CPU with official and unofficial opcodes
  • - PPU Graphics - Accurate rendering with sprite rendering, background layers, and scrolling
  • - Mapper Support - Supports 6 major mappers covering ~72% of NES games
  • - SDL2 Display - Smooth 60 FPS gameplay with SDL2 for cross-platform graphics
  • - WASM Build - WebAssembly target for running in browsers

### supported mappers

The emulator supports the most common NES cartridge mappers:

  • Mapper 0 (NROM) - Super Mario Bros., Donkey Kong
  • Mapper 1 (MMC1) - Zelda, Metroid
  • Mapper 2 (UxROM) - Mega Man, Castlevania
  • Mapper 3 (CNROM) - Arkanoid
  • Mapper 4 (MMC3) - Super Mario Bros. 3, Mega Man 3-6
  • Mapper 7 (AxROM) - Battletoads

### controls

Arrow Keys - D-Pad
X - A Button
Z - B Button
Enter - Start
Right Shift - Select
P - Pause/Resume
R - Reset
ESC - Quit

### learn more

Download pre-built binaries, read the documentation, and explore the source code.