Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

NES Emulator + 6502 Studio

github.com

  • Linux
  • Web
  • Self-hosted
6.4 Club score Visit github.com

What NES Emulator + 6502 Studio is

NES Emulator + 6502 Studio is a free, GPL v3 C++ NES emulator compiled to WebAssembly, with NES Studio providing a browser-based debugger. NES Studio supports stepping, running, breakpoints, live disassembly, memory editing, CPU and PPU state views, pattern, nametable and OAM viewers, plus full-screen Play mode. The 6502 core implements all 151 official opcodes and documented illegal opcodes; the project reports passing nestest and blargg instr_test and matching the nestest golden log cycle for cycle. The PPU handles backgrounds, sprites, DMA, scrolling, and four mirroring modes. WebAudio supplies two pulse channels, triangle, and noise. Supported mappers are NROM, MMC1, UxROM, CNROM, and MMC3. A C-ABI library provides deterministic stepping, while a Python package offers a Gymnasium-style Super Mario Bros environment. Live-agent streaming uses a Python server.

Who it suits

This project suits browser users, emulator developers, and people scripting or training agents. Its headless library, Python environment, and live-agent workflow also support development and research.

Good to know, and what to watch

  • Runs in a web browser through WebAssembly
  • Includes a detailed browser debugger
  • Supports five listed cartridge mappers
  • Provides deterministic C-ABI stepping
  • Includes a Gymnasium-style Python environment
  • PPU renders one scanline at a time
  • One listed PPU timing ROM does not pass
  • Live-agent streaming requires a Python server
  • Native builds require C++17 and CMake

The verdict

NES Emulator + 6502 Studio combines an NES emulator with extensive browser debugging and agent-oriented interfaces. Its documented PPU timing limitation and native build requirements are important for deeper emulator work.

What the maker publishes

Agent and Python tools
The project provides a C-ABI shared library, a Python package with a Gymnasium-style Super Mario Bros environment, and an optional Gymnasium adapter for stable-baselines3. source
Agent integration
NES Studio can replay .nesmovie recordings and can show live agent play through a Python streaming server; the live-agent button is hidden in production builds unless a backend URL is configured. source
Build requirements
The README recommends Docker, or lists a C++17 compiler, CMake 3.14 or newer, and GoogleTest for a native build. source
Cartridge support
The emulator supports NROM, MMC1, UxROM, CNROM and MMC3 mappers. source
CPU
The 6502 core implements all 151 official opcodes and documented illegal opcodes, passes nestest and blargg instr_test, and matches the nestest golden log cycle for cycle. source
CPU
The 6502 core implements all 151 official opcodes and documented illegal opcodes, and the README says it passes nestest and blargg instruction tests. source
Debugger
NES Studio includes stepping, running, breakpoints, live disassembly, a memory editor, CPU and PPU state, pattern, nametable and OAM viewers, and full-screen Play mode. source
Debugger
NES Studio includes stepping, running, breakpoints, live disassembly, a memory editor, CPU and PPU state displays, pattern, nametable and OAM viewers, and full-screen Play mode. source
Game compatibility
The project reports Super Mario Bros. 1-1 as fully playable and Super Mario Bros. 3 as booting with its attract demo playing. source
Game compatibility
The README describes Super Mario Bros. as fully playable through level 1-1 and Super Mario Bros. 3 as booting with its attract demo playing. source
Graphics and sound
The PPU supports backgrounds, sprites, DMA, scrolling and four mirroring modes; the APU provides two pulse channels, triangle and noise through WebAudio. source
Graphics and sound
The PPU supports backgrounds, sprites, OAM and DMA, scrolling, sprite-0 hit, and four mirroring modes; the APU has pulse, triangle, and noise channels wired to WebAudio. source
Headless and deterministic use
A C-ABI shared library exposes independent NES instances with deterministic stepping, and the project includes a Python package with a Gymnasium-style Super Mario Bros environment. source
Intended users
The project describes its headless library, Python environment and live-agent workflow as suitable for scripting, training agents, development and research. source
Known limitation
The PPU renders one scanline at a time, so the blargg ppu_vbl_nmi timing ROM does not pass; the project says dot-based PPU timing is a future accuracy task. source
Known limitation
The PPU renders a whole scanline at a time, so the ppu_vbl_nmi dot-timing conformance ROM is not yet passing. source
License
The project is licensed under GPL v3. source
License
The repository states that the software is licensed under GPL v3. source
Live agent feature
Live agent streaming requires a Python server on the user's machine, and the Spawn Agent button is hidden in production builds unless a backend URL is configured. source
Maker
The GitHub profile identifies the maker as Maxwell Knight, a fullstack engineer based in Israel. source
Mapper support
The emulator supports NROM, MMC1, UxROM, CNROM, and MMC3 with scanline IRQ. source
Purpose
NES Emulator + 6502 Studio is a C++ NES emulator compiled to WebAssembly with a browser debugger called NES Studio. source
Purpose
NES Emulator + 6502 Studio is a C++ Nintendo Entertainment System emulator compiled to WebAssembly with a browser debugger called NES Studio. source
Security and support
The opened project page provides no security or compliance claims and no dedicated support terms. source

Checked against the maker's pages on 9 Oct 2026.