Gameplay from The Legend of Zelda on NES. Image from the Retro Replay media library.

puNES

NES EMULATOR

puNES

puNES is a Qt-based Nintendo Entertainment System (NES) emulator and NSF/NSF2/NSFe music player that runs on Windows and Unix-like systems (Linux, FreeBSD, OpenBSD). It supports many NES mapper chips and Famicom Disk System (FDS) images, and is distributed from an active GitHub repository with binary releases and build artifacts.

Jump to download ↓Jump to setup guide ↓

Gameplay from The Legend of Zelda on NES. Image from the Retro Replay media library.

NESPRIMARY SYSTEM

History documentedPROJECT BEGAN

Open sourcePROJECT MODEL

WHY IT MATTERS

Why puNES?

puNES aims to provide accurate NES/Famicom emulation together with a built-in NSF music player and a modern Qt user interface. It is cross-platform and offers features such as many supported mappers, portable mode, shader support, and both OpenGL and Direct3D rendering backends on Windows.

BEST FOR

Notable strengths

Cross-platform Qt GUI; integrated NSF/NSFe music playback; wide mapper coverage; portable-mode support and prebuilt nightly/AppImage/Windows artifacts; actively maintained on GitHub with frequent commits and releases.

Gameplay from The Legend of Zelda on NES.

The people behind puNES

History and status

puNES has a long development history and in recent years the project was made open-source and hosted on GitHub. The repository contains many commits and a visible changelog; maintainers publish releases and WIP/nightly builds (Linux AppImage, Windows OpenGL/D3D9). The project continues to receive updates and builds in the repository, with release tags present and a documented changelog describing feature and UI work. The GitHub README documents supported mappers and platform notes (including compatibility and portable-mode instructions).

What puNES supports

Nintendo Entertainment System (NES)
Famicom (NTSC/PAL behavior as implemented in core)
Famicom Disk System (FDS) images
NSF / NSF2 / NSFe music file playback

Download and availability

OFFICIAL DOWNLOADS

Get puNES

Official builds and source are available from the project's GitHub repository. Prebuilt releases and 'latest' release artifacts are published on the repository Releases page; the README also links to WIP/nightly AppImage and Windows artifacts maintained from the repo.

Get puNES ↗

DOCUMENTATION

Official documentation

Read the official configuration, compatibility, and troubleshooting material before changing advanced options.

Read official documentation ↗

Broken or missing download? Emulator projects move and official links sometimes change. Please contact Retro Replay so the source can be verified and updated.

puNES setup guide

Setup note: Below are practical setup and build notes derived from the official repository and changelog. This is focused on building from the GitHub source or using official release artifacts; it does not provide or reference commercial game ROMs, firmware, BIOS or other copyrighted content.

1) Get the source or releases: Official project page and releases: clone the GitHub repository (git clone https://github.com/punesemu/puNES) or download release packages from the repository Releases page. The README also points to nightly/AppImage and Windows artifacts for quick testing.
2) Platform and dependency summary: puNES is developed with Qt and uses a CMake-based build in the repository. On Linux you will typically need Qt5 (with SVG support and OpenGL if you want the OpenGL renderer), a C++ compiler (gcc/clang), CMake, and standard development tools. On Windows there are prebuilt installers and also builds for OpenGL or Direct3D9 backends; 32-bit builds are provided for legacy compatibility (notably Windows XP-compatible 32-bit binaries).
3) Build from source (general outline): From a command line: 1) git clone https://github.com/punesemu/puNES && cd puNES 2) create a build directory: mkdir build && cd build 3) run CMake to configure: cmake .. 4) build: cmake –build . –config Release 5) the resulting binary will be in the build output. Use the README and CMakeLists in the repo for options and platform-specific instructions. On systems using Qt5, ensure Qt5 was built with SVG support; the README and ChangeLog explicitly note that Qt5 with SVG (and OpenGL for the OpenGL frontend) is required for certain builds.
4) Using official binaries / AppImage / nightlies: For Linux, try the AppImage artifact linked from the repository README for a quick run. For Windows, choose the OpenGL or D3D9 release artifacts (32-bit or 64-bit) according to your system. The README lists the maintained WIP builds and warns that save states from older major versions may not be compatible with newer builds.
5) Configuration and portable mode: puNES supports a portable mode. Portable mode can be enabled by placing puNES.cfg beside the executable, renaming the executable to include the suffix _p (for example punes.exe -> punes_p.exe), or running the emulator with the –portable command-line option. Command-line options are listed when starting the binary with -h.
6) Optional BIOS/Game Genie file: The ChangeLog documents that a Game Genie ROM (file name gamegenie.rom) is optional for Game Genie support and should be placed in $HOME/.puNES/bios on Linux or in Documents/puNES/bios on Windows if you want to use that feature. The emulator does not include any commercial BIOS/firmware; supply any optional files yourself if you legally own them.
7) NSF/NSFe playback and archive support: puNES contains an integrated NSF/NSFe player and supports NSF/NSF2 formats. The project changelog also notes support for NSF and UNIF files carried inside compressed archives; consult the README for how to open those files in the UI.
8) Troubleshooting and notes: If you encounter issues: confirm you have required Qt features (SVG/OpenGL) for your chosen renderer, check release notes for breaking changes (for example save-state incompatibilities across major versions), and consult the repository Issues page. For packaging on distributions, refer to existing packaging (for example the Gentoo package entry) as a reference for runtime dependencies.

Software reminder: Do not distribute or use commercial game ROMs, copyrighted BIOS/firmware, or proprietary music/ROM images that you do not legally own. Use only content you are licensed to use.