Skip to content

Nintendo Entertainment System emulator written in Golang

License

Notifications You must be signed in to change notification settings

retroenv/nesgoemu

Repository files navigation

nesgoemu - Emulator for NES ROMs

Build status go.dev reference Go Report Card codecov

nesgoemu allows you to emulate ROMs for the Nintendo Entertainment System (NES).

Features

  • Offers the GUI in SDL or OpenGL mode
  • Can be used headless without a GUI
  • Supports outputting of CPU traces
  • Supports undocumented 6502 CPU opcodes

Installation

Your system needs to have a recent Golang version installed.

Check GUI installation to set up the GUI dependencies.

Install the latest stable version by running:

go install github.com/retroenv/nesgoemu@latest

The latest development version can be installed using:

git clone https://github.com/retroenv/nesgoemu.git
cd nesgoemu
go build .
# use the dev version:
./nesgoemu  

Usage

Emulate a ROM:

nesgoemu example.nes

Options

usage: nesgoemu [options] <file to emulate>

  -a string
    	listening address for the debug server to use (default "127.0.0.1:8080")
  -c	console mode, disable GUI
  -d	start built-in webserver for debug mode
  -e int
    	entrypoint to start the CPU (default -1)
  -s int
    	stop execution at address (default -1)
  -t	print CPU tracing

About

Nintendo Entertainment System emulator written in Golang

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published