NES Emulator + 6502 Studio
github.com
- Linux
- Web
- Self-hosted
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.