Home

Welcome to the RustyNES Wiki

RustyNES is a cycle-accurate Nintendo Entertainment System emulator written in pure Rust. It targets the Mesen2 / higan / ares accuracy bar — tight, lockstep scheduling at PPU-dot resolution on a master-clock-precise timebase — clearing AccuracyCoin 100.00% (139/139) and matching the Nintendulator golden log on nestest with zero diff.

Precise. Pure. Powerful.

Beyond reference accuracy, RustyNES is a complete, modern emulation platform: 172 mapper families covering the vast majority of the commercial library, the full Famicom Disk System, Vs. System / PlayChoice-10 arcade games in true RGB, GGPO-style rollback netplay, RetroAchievements, a native Libretro core, a scriptable TAStudio piano-roll TAS editor, A/V recording, HD-packs, and a comprehensive debugging suite.

All of this is built on a strict bit-determinism contract. The frontend is pure Rust (winit + wgpu + cpal + egui) with native binaries for Linux, macOS, Windows, Android, iOS, and WebAssembly.

---

Why RustyNES?

RustyNES combines accuracy-first emulation with modern features and the safety guarantees of Rust.

• Reference-grade accuracy — a from-scratch core on a u64 master clock with run-to-timestamp catch-up; region-exact 3:1 NTSC/Dendy and 3.2:1 PAL clock ratios.
• Determinism as a hard contract — same seed, ROM, and input sequence yield a bit-identical framebuffer and audio.
• Modern features — RetroAchievements, rollback netplay, TAStudio, run-ahead, and an Android/iOS app.
• Safe, modular Rust — the chip stack is no_std + alloc with a one-directional workspace graph.

Wiki Navigation

Use the sidebar on the right to navigate through the comprehensive documentation.

• New users should start with Getting-Started and Building-from-Source.
• Developers looking to understand the core engine should explore the Architecture-Overview and the deep-dives into the CPU-2A03, PPU-2C02, and APU-Mixer.
• See how our Mapper-Ecosystem achieves breadth without sacrificing accuracy.
• Check out the Testing-Strategy to see how we maintain the 100% AccuracyCoin bar.