package
0.1.1
Repository: https://github.com/retroenv/nesgo.git
Documentation: pkg.go.dev

# README

nesgoemu - Emulator for NES ROMs

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

Features

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

Check the issue tracker for planned features or known bugs.

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/nesgo/cmd/nesgoemu@latest

The latest development version can be installed using:

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

Usage

Emulate a ROM:

nesgoemu example.nes

Options

usage: nesgoemu [options] <file to emulate>

  -e int
    	entrypoint to start the CPU (default -1)
  -t	print CPU tracing