How do I install fogleman/nes on Windows?

First, ensure Go and PortAudio are installed, then run 'go get github.com/fogleman/nes'. The binary will be in your GOPATH/bin, but PortAudio setup might require additional steps like using a package manager or compiling from source.

Does fogleman/nes support all NES games?

No, it supports about 85% of games due to implemented mappers like NROM, MMC1, and others. Check the mapper list in the README for specific compatibility, as some less common games won't work.

fogleman/nes vs FCEUX: which should I use?

fogleman/nes is better for developers interested in Go code and cross-platform emulation with a clean codebase, while FCEUX is more mature with broader game support and features like save states and debugging tools. Choose based on your need for learning vs. gaming convenience.

How can I change the joystick buttons in fogleman/nes?

Currently, you can't—joystick mappings are hard-coded. You can use keyboard controls as an alternative, or modify the source code to adjust mappings, but there's no built-in configuration interface.

What systems does fogleman/nes run on?

It runs on Linux, macOS, and Windows, leveraging Go's cross-compilation and dependencies like OpenGL and PortAudio. However, audio setup varies by platform, with specific instructions for Ubuntu and Mac in the README.

Is the sound emulation accurate in fogleman/nes?

The APU emulation has minor imperfections, as noted in the known issues, but it's generally good for most games. For precise audio reproduction, you might notice slight inaccuracies compared to more polished emulators.

Open-Awesome

nes

MITGo

A Nintendo Entertainment System (NES) emulator written in Go with OpenGL graphics and audio support.

GitHub

5.6k stars534 forks0 contributors

What is nes?

fogleman/nes is a Nintendo Entertainment System (NES) emulator implemented in Go. It allows users to play classic NES games on modern computers by emulating the console's hardware components, including the CPU, PPU (Picture Processing Unit), and APU (Audio Processing Unit). The project focuses on accuracy and performance while providing a graphical interface for browsing and selecting ROMs.

Target Audience

Developers and hobbyists interested in retro gaming emulation, particularly those with experience in Go who want to study or contribute to emulator development. It also targets users seeking a cross-platform NES emulator written in a modern, compiled language.

Value Proposition

Developers choose this emulator for its clean, modular Go codebase, which emphasizes accuracy in hardware emulation. Its unique selling points include cross-platform support via OpenGL and GLFW for graphics, PortAudio for sound, and an integrated ROM browser with automatic thumbnail downloads from an online database.

Overview

NES emulator written in Go.

Use Cases

Best For

Playing classic NES games on modern computers with support for approximately 85% of games via implemented mappers.
Studying emulator development in Go, as it provides a modular codebase focused on NES hardware accuracy.
Cross-platform retro gaming emulation using OpenGL for graphics and PortAudio for audio on systems like Linux, macOS, and Windows.
Browsing and selecting NES ROMs through a graphical menu interface that automatically fetches game thumbnails.
Experimenting with NES hardware emulation components, including CPU, PPU, and APU, for educational purposes.
Using joystick or keyboard input for NES gameplay with configurable controls and turbo button support.

Not Ideal For

Users requiring 100% NES game compatibility, as only about 85% of games are supported due to limited mapper implementation.
Those seeking plug-and-play emulation without manual dependency installations, like PortAudio setup on certain systems.
Players wanting fully customizable joystick controls, since button mappings are hard-coded and not configurable.
Enthusiasts needing frame-perfect emulation accuracy, given known minor PPU timing issues and imperfect APU emulation.

Pros & Cons

Pros

Cross-Platform Accessibility

Runs on Linux, macOS, and Windows using Go's portability with OpenGL/GLFW for graphics and PortAudio for sound, as shown in the installation and dependency sections.

Integrated ROM Browser

Includes a graphical menu that automatically downloads game thumbnails from an online database, enhancing user experience for browsing and selecting ROMs, as detailed in the usage section.

Clean Educational Codebase

Written in Go with a modular focus on NES hardware accuracy, making it valuable for developers learning emulator internals, supported by documentation links in the README.

Performance and Hardware Focus

Emphasizes accurate CPU, PPU, and APU emulation in a compiled language for better performance, aligning with the project's philosophy stated in the summary.

Cons

Limited Game Support

Only implements six mappers covering about 85% of NES games, meaning many titles won't work, as admitted in the mappers section.

Audio Setup Complexity

Requires manual PortAudio installation with development headers on some systems, adding a setup hurdle compared to more integrated emulators, as noted in the dependencies.

Inflexible Joystick Controls

Joystick button mappings are hard-coded and not user-configurable, limiting customization for different controllers, as mentioned in the controls section.

Frequently Asked Questions

Related Projects

croc

Easily and securely send things from one computer to another :crocodile: :package:

Stars34,744

Forks1,367

Last commit10 days ago

restic

Fast, secure, efficient backup program

Stars33,234

Forks1,743

Last commit23 days ago

gor

GoReplay is an open-source tool for capturing and replaying live HTTP traffic into a test environment in order to continuously test your system with real data. It can be used to increase confidence in code deployments, configuration changes and infrastructure changes.

Stars19,287

Forks87

Last commit2 months ago

JuiceFS

JuiceFS is a distributed POSIX file system built on top of Redis and S3.

Stars13,480

Forks1,193

Last commit1 day ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

nes