EMULATOR DATABASE
NESd
NESd is an open-source, cross-platform Nintendo Entertainment System (NES / Famicom) emulator implemented in Dart with Flutter. It runs native desktop builds, mobile, and a browser-playable build using WebAssembly/Flutter Web; official releases, a Flatpak, and a self-hostable web image are provided by the project.
Download Tutorials & guidesSign in to download. Files are hosted by the emulator project.

About NESd
NESd is a personal/emulation-development project aiming to implement NES hardware in Dart and expose a modern, cross-platform frontend via Flutter. The author documents the project development and design decisions in blog posts and the project repository.
Users who want a modern Flutter-based NES implementation to run in desktop, mobile, or browser environments; developers interested in a Dart emulator codebase they can inspect or extend.
The people behind NESd / history
The project began in 2024 and has an active public repository with frequent releases. The author published development notes describing the initial commit and design rationale. The upstream repository offers packaged releases, a Flatpak repository, and a browser-playable build. The codebase is maintained openly on GitHub; activity and releases indicate ongoing development rather than an archived project. Compatibility and accuracy are typical of a single-author indie emulator: it aims to run many NES games but does not claim the exhaustive compatibility or cycle-accuracy of long-established NES emulators. The project provides multiple distribution options including prebuilt releases, a Flatpak, and a self-hostable Docker/ghcr image for the web build.
Screenshots

Tutorials & guides
NESd setup guide
Setup note: This setup guide covers acquiring a release build, running the browser build, or building NESd from source for desktop/mobile using the Flutter toolchain. It focuses on practical, verified steps — follow the official README if you need alternate targets or platform-specific notes.
- 1) Get a release (recommended): Visit the project's GitHub Releases page and download the artifact that matches your platform (Windows, macOS, Linux, Android). Releases are published as tagged builds in the repository's Releases section.
- 2) Install via Flatpak on Linux (optional): The author publishes a Flatpak repository. Add the flatpak repo URL provided in the project README, then install the Flatpak ID (dev.jpj.NESd). Use flatpak install <repo> dev.jpj.NESd and run with flatpak run dev.jpj.NESd.
- 3) Play in a browser or self-host the web build: The project provides a browser-playable build (hosted at the project's docs/play path) and a self-hostable container image. To test quickly, open the project's play URL in a modern browser. To self-host, obtain the project's published container image (the repository registry image) and run it according to the container's instructions; the repository mentions a ghcr container for the web build.
- 4) Build from source (desktop/mobile) — prerequisites: Install Git and the Flutter SDK for your target platforms. Ensure Flutter is set up for the target (desktop support enabled, Android SDK for Android builds, Xcode for macOS/iOS when applicable). Clone the repository, then run flutter pub get in the project root to fetch Dart dependencies.
- 5) Build from source — common build commands: From the repository root: for desktop: flutter build linux / macos / windows (choose the platform). For Android: flutter build apk --release. For web: flutter build web and then serve the build directory with a static server or container image as documented.
- 6) Loading ROMs and BIOS: NESd does not include commercial ROMs, firmware, or BIOS files. Use the emulator UI to open your own legally-obtained NES ROM images (common .nes iNES format). If the project requires optional data files, consult the README or docs for precise file paths and formats.
- 7) Practical notes and troubleshooting: If you encounter platform-specific issues, confirm your Flutter toolchain is up to date and that desktop support is enabled in Flutter. Use the project's GitHub Issues page to search for existing reports; file a new issue with reproduction steps if needed. For web playback, use a modern Chromium-based or Firefox browser with WASM support.
Software reminder: Do not upload or use copyrighted ROMs unless you legally own them. NESd's releases do not include commercial game ROMs or proprietary firmware.
Additional information
What NESd supports
- Nintendo Entertainment System / Famicom (NES)
- Windows (native Flutter build)
- macOS (native Flutter build)
- Linux (native Flutter build and Flatpak)
- Web (Flutter Web / browser play)
- Android (Flutter mobile build)
READMEs & documentation
- NESd GitHub repository (README, releases, Flatpak notes)
- Project website / docs (play demo and documentation)
NESd official project README
<p align="center">
<img src="packages/nesd/assets/logo.png" width="50%" />
</p>
<p align="center">
<a href="https://github.com/jpjonte/NESd/actions/workflows/ci.yaml"><img src="https://img.shields.io/github/actions/workflow/status/jpjonte/NESd/ci.yaml" alt="CI status" /></a>
<a href="https://nesd.jpj.dev/"><img src="https://img.shields.io/endpoint?url=https%3A%2F%2Fnesd.jpj.dev%2Fcoverage%2Fmain.json" alt="Coverage" /></a>
<a href="https://github.com/jpjonte/NESd/releases/latest"><img src="https://img.shields.io/github/v/release/jpjonte/NESd" alt="Release" /></a>
<a href="LICENSE"><img src="https://img.shields.io/github/license/jpjonte/NESd" alt="License" /></a>
</p>
A cycle-accurate NES emulator written in Dart and Flutter.
Runs on macOS, Windows, Linux, Android, and on the web.
**[▶ Play it in your browser](https://nesd.jpj.dev/play/)**, [Download a build](#installation) or visit [nesd.jpj.dev](https://nesd.jpj.dev).
<p align="center">
<a href="https://play.google.com/store/apps/details?id=dev.jpj.nesd"><img src="docs/google-play-badge.svg" alt="Get it on Google Play" height="60" /></a>
</p>
<p align="center">
<img src="docs/Battletoads.png" width="49%" />
<img src="docs/Castlevania%20III.png" width="49%" />
</p>
## Installation
### Downloads
Grab the file for your platform from the [latest release](https://github.com/jpjonte/NESd/releases/latest):
| Platform | File |
|------------------------------|-------------------------------------------------|
| macOS (Intel + Apple Silicon)| `nesd.<version>.macos-universal.dmg` |
| Windows | `nesd.<version>.windows-x64.zip` |
| Linux (Debian, Ubuntu, …) | `nesd.<version>.linux-<arch>.deb` |
| Linux (Fedora, RHEL, …) | `nesd.<version>.linux-<arch>.rpm` |
| Linux (portable) | `nesd.<version>.<appimage-arch>.AppImage` |
| Android | `nesd.<version>.android.apk` |
| Web (self-hosted) | `nesd.<version>.web.zip` |
`<arch>` is `x64` or `arm64`; `<appimage-arch>` is `x86_64` or `aarch64`.
Nightly builds of `main` live in the
[nightly release](https://github.com/jpjonte/NESd/releases/tag/nightly).
### Web
Play at [https://nesd.jpj.dev/play/](https://nesd.jpj.dev/play/). It can be installed to the
home screen and works offline after the first visit. A self-hostable Docker image is
also available (see [Self-hosting](#self-hosting) below).
### Android
Download and install the APK above, or get it in the Play Store:
<a href="https://play.google.com/store/apps/details?id=dev.jpj.nesd"><img src="docs/google-play-badge.svg" alt="Get it on Google Play" height="60" /></a>
### Linux (Flatpak)
Add my Flatpak repo (https://jpjonte.github.io/flatpak/jpj.flatpakrepo) and install NESd
(`dev.jpj.NESd`) from there.
Nightly builds (`dev.jpj.NESd.dev`) live in the same repo and can be installed next to the stable
release.
### First launch
NESd's desktop builds are not signed, so your OS will complain the first time you open the app. It only happens once.
- **macOS**: right-click the app and choose *Open*. If macOS insists the app is damaged, clear the quarantine flag in the Terminal: `xattr -dr com.apple.quarantine /Applications/NESd.app`
- **Windows**: SmartScreen shows a blue warning. Choose *More info* → *Run anyway*.
## Getting started
NESd does not come with any games. It plays `.nes` ROM files you supply yourself. Open one with **Open ROM** and it is added to your library.
### Default keyboard controls
| Action | Key |
|---------------------|----------------------------|
| D-pad | Arrow keys |
| A / B | <kbd>Z</kbd> / <kbd>X</kbd>|
| Start / Select | <kbd>Enter</kbd> / <kbd>Shift</kbd> |
| Pause | <kbd>Space</kbd> |
| Fast-forward | <kbd>Tab</kbd> |
| Rewind | <kbd>Backspace</kbd> |
| Open menu | <kbd>Esc</kbd> |
| Load save state 1–9 | <kbd>1</kbd> … <kbd>9</kbd>|
| Save to state 1–9 | <kbd>Shift</kbd> + <kbd>1</kbd> … <kbd>9</kbd> |
All controls can be changed under **Settings → Controls**, including gamepads and the on-screen touch controls.
## Features
- Cycle-accurate CPU, PPU and APU emulation
- Runs on macOS, Linux, Windows, Android and the web
- Support for NTSC and PAL games
- Battery backed (SRAM) saves
- Save states, with thumbnails
- Rewind
- Fast-forward at 2x, 3x, 4x or unlimited, with audio
- Game Genie cheats
- Video filters (CRT and Smoothing) that can be stacked
- Expansion audio for MMC5, Namco 163 and Sunsoft 5B games
- Customizable controls with multiple bindings per action
- Gamepad support
- Customizable touch screen controls
- Turbo A and B for both controllers, with an adjustable fire rate
- Load ROMs from file or ZIP archive, with a searchable file picker
- Debug overlay and debug tools: Display, Tile Viewer, Cartridge Info, APU Debug, Debugger and Execution Log
- A log viewer with search, copy and file export
## Screenshots
### Desktop
<img src="docs/list.png" style="width: 100%;" />
<p align="center">
<img src="docs/Micro%20Machines.png" style="width: 49%" /> <img src="docs/Marble%20Madness.png" style="width: 49%" />
</p>
<p align="center">
<img src="docs/Recca.png" style="width: 49%" /> <img src="docs/filters.png" style="width: 49%" />
</p>
<img src="docs/rewind.png" style="width: 100%;" />
<img src="docs/controls.png" style="width: 100%;" />
<img src="docs/save_states.png" style="width: 100%;" />
<img src="docs/debugging.png" style="width: 100%;" />
### Android
<img src="docs/android_wide.png" style="width: 100%;" />
<p align="center">
<img src="docs/android_tall.png" style="width: 49%" />
</p>
## Supported games and mappers
<!-- game-counts:start -->
NESd supports 3,681 games.
<details>
<summary>Supported mappers</summary>
- 0: NROM (346 games)
- 1: MMC1 (734 games)
- 2: UNROM (303 games)
- 3: CNROM (192 games)
- 4: MMC3 (796 games)
- 5: MMC5 (31 games)
- 7: AxROM (59 games)
- 9: MMC2 (9 games)
- 11: Color Dreams (51 games)
- 16: Bandai FCG (16 games)
- 19: Namco 163 (31 games)
- 21: Konami VRC4 (3 games)
- 22: Konami VRC2 (2 games)
- 23: Konami VRC2 / VRC4 (17 games)
- 25: Konami VRC2 / VRC4 (8 games)
- 30: UNROM 512 (39 games)
- 34: BNROM / NINA-001 (8 games)
- 45: GA23C (151 games)
- 66: GxROM (17 games)
- 69: Sunsoft FME-7 (13 games)
- 70: Bandai discrete (4 games)
- 71: BR909x (30 games)
- 74: Waixing MMC3 (4 games)
- 79: NINA-003-006 (48 games)
- 87: J87 (16 games)
- 118: TxSROM (8 games)
- 119: TQROM (4 games)
- 146: Sachen 3015 (0 games)
- 152: Bandai discrete (5 games)
- 163: Nanjing FC-001 (66 games)
- 176: 8025 (344 games)
- 185: CNROM with CHR-ROM protection (11 games)
- 192: Waixing MMC3 (4 games)
- 206: Namco 108 (63 games)
- 241: BxROM with WRAM (13 games)
- 256: VT03 OneBus (235 games)
</details>
<!-- game-counts:end -->
## Accuracy
<!-- test-roms:start -->
121 of 126 test ROMs run in CI and pass.
<details>
<summary>Test ROM results</summary>
The ROMs live in `roms/test/`, the tests that run them in `packages/nesd/test/test_roms/`.
*Passing* counts the ROMs of a suite that run in CI and pass, out of the ROMs the suite ships.
| Area | Suite | Author | Passing | Notes |
|------|-------|--------|---------|-------|
| CPU | `instr_test-v5` | blargg | 1 / 1 | `all_instrs`, all 16 sub-tests, official and unofficial opcodes |
| CPU | `instr_timing` | blargg | 1 / 1 | Combined ROM, both sub-tests |
| CPU | `branch_timing_tests` | blargg | 3 / 3 | |
| CPU | `instr_misc` | blargg | 4 / 4 | |
| CPU | `cpu_timing_test6` | blargg | 1 / 1 | Official and unofficial opcodes |
| CPU | `blargg_nes_cpu_test5` | blargg | 1 / 1 | `cpu`, official and unofficial opcodes |
| CPU | `nestest` | kevtris | 1 / 1 | Official and unofficial opcodes |
| CPU | `cpu_interrupts_v2` | blargg | 5 / 5 | |
| CPU | `cpu_reset` | blargg | 2 / 2 | |
| CPU | `cpu_dummy_reads` | blargg | 1 / 1 | |
| CPU | `cpu_dummy_writes` | bisqwit | 2 / 2 | |
| CPU | `cpu_exec_space` | bisqwit | 2 / 2 | |
| CPU | `sprdma_and_dmc_dma` | blargg | 2 / 2 | |
| CPU | `dmc_dma_during_read4` | blargg | 4 / 5 | `double_2007_read` needs the back-to-back `$2007` read quirk |
| PPU | `ppu_vbl_nmi` | blargg | 10 / 10 | |
| PPU | `vbl_nmi_timing` | blargg | 7 / 7 | Older release of `ppu_vbl_nmi` |
| PPU | `ppu_open_bus` | blargg | 1 / 1 | |
| PPU | `ppu_read_buffer` | bisqwit | 1 / 1 | 79 sub-tests |
| PPU | `oam_read` | blargg | 1 / 1 | |
| PPU | `oam_stress` | blargg | 1 / 1 | |
| PPU | `blargg_ppu_tests_2005.09.15b` | blargg | 4 / 5 | `power_up_palette` compares against one console's power-up palette |
| PPU | `sprite_hit_tests_2005.10.05` | blargg | 11 / 11 | |
| PPU | `sprite_overflow_tests` | blargg | 5 / 5 | |
| PPU | `scanline` | Quietust | 1 / 1 | Framebuffer golden |
| PPU | `full_palette` | blargg | 1 / 1 | Framebuffer golden |
| PPU | `spritecans-2011` | tepples | 1 / 1 | Framebuffer golden |
| APU | `apu_test` | blargg | 8 / 8 | |
| APU | `apu_reset` | blargg | 6 / 6 | |
| APU | `blargg_apu_2005.07.30` | blargg | 11 / 11 | Older release of `apu_test` |
| APU | `pal_apu_tests` | blargg | 10 / 10 | Run as a PAL console |
| Mapper | `mmc3_test` | blargg | 5 / 6 | `6-MMC6` targets the MMC6 IRQ revision |
| Mapper | `mmc3_test_2` | blargg | 5 / 6 | Newer build of the `mmc3_test` ROMs, `6-MMC3_alt` targets the alternate IRQ revision |
| Mapper | `mmc5test_v2` | AWJ | 1 / 1 | Framebuffer golden |
| Mapper | `m22chrbankingtest` | lidnariq | 1 / 1 | Framebuffer golden, VRC2a CHR bank shift |
| All | `AccuracyCoin` | 100thCoin | 0 / 1 | 144 / 144 tests pass |
</details>
<!-- test-roms:end -->
## Self-hosting
NESd's web version is a static Flutter web app that can be self-hosted.
### Docker
docker run -d -p 8080:80 ghcr.io/jpjonte/nesd:latest
Then open http://localhost:8080.
`8080` is an example port, feel free to change it.
| Tags | |
|-----------|---------------------------------|
| `latest` | latest release |
| `x.y.z` | specific version, e.g. `0.17.0` |
| `nightly` | latest `main` build |
#### Docker Compose
services:
nesd:
image: ghcr.io/jpjonte/nesd:latest
ports:
- "8080:80"
restart: unless-stopped
### Static files
Any static file server works.
- Download the web build (`nesd.<version>.web.zip`) from the [latest release](https://github.com/jpjonte/NESd/releases/latest)
- or `nesd.nightly.web.zip` from the [nightly release](https://github.com/jpjonte/NESd/releases/tag/nightly)
- or build it from source (`flutter build web --wasm --no-web-resources-cdn` followed by `dart run tool/generate_service_worker.dart` in `packages/nesd`).
Serve the directory as-is.
`.mjs` files must be served as JavaScript (`Content-Type: application/javascript`), otherwise browsers reject the WebAssembly runtime's module, and you get a blank page.
Serve `index.html`, `flutter_bootstrap.js` and `sw.js` uncached.
### Link to a ROM
Add a `rom` parameter to start with a ROM: `https://nesd.jpj.dev/play/?rom=https://example.com/game.nes`.
You can load `.nes`, `.zip` and `.7z` files up to 16 MB.
Add `&slot=<0-9>` to load a save state slot.
Select *Save ROM to Browser* in the in-game menu to store the ROM.
## Contributing
Contributions are very welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for the development setup and how to report bugs (please include the log).
## Acknowledgements
Thank you to the following projects and people for their amazing work:
- The [Nesdev Wiki](https://wiki.nesdev.com/w/index.php/Nesdev_Wiki) for the invaluable documentation
- The [Nesdev Forums](https://forums.nesdev.com/) for the in-depth discussions on hardware behaviors
- SourMesen for the excellent [Mesen](https://github.com/SourMesen/Mesen2/) emulator
- [Modern Vintage Gamer](https://www.youtube.com/@ModernVintageGamer) for the inspiration to write my own emulator
- NewRisingSun for the [NES 2.0 XML Database](https://forums.nesdev.org/viewtopic.php?t=19940) of known ROMs
- blargg, bisqwit, kevtris, Quietust, tepples, AWJ and 100thCoin for the [test ROMs](#accuracy)
- [Andrea Bizzotto](https://codewithandrea.com/) for his excellent Flutter tips and tricks
## License
NESd is released under the [MIT License](LICENSE).
Nintendo Entertainment System and NES are trademarks of Nintendo. NESd is not affiliated with or endorsed by Nintendo, and ships no game ROMs or copyrighted Nintendo material.
Google Play and the Google Play logo are trademarks of Google LLC.
Download original READMERelease log
Selected releases and changes, with coverage from our weekly emulation roundup.
Sources & further reading
FROM THE COMMUNITY
Player reviews
Starting site scores are provisional editorial scores. Established mainstream projects receive a higher starting score; other imported entries begin at a neutral 6/10 pending individual review. Member scores change the average after approval.
Your take on NESd
Spam has been overwhelming. To help us approve your review, sign up and introduce yourself in the Introductions forum so we know you’re not a bot.
Sign in with your Retro Replay account to rate this project and share your experience.
Sign in to review
Retro Replay Retro Gaming History, Reviews & Emulation