How nixxou/zaxnes works
Zaxnes is a desktop and handheld NES emulator whose distinctive result is an interactive 3D rendering of NES frames, with optional widescreen gameplay. The user launches the app, selects a ROM, and plays; the emulator core produces frames that the 3D engine converts for rendering and the app presents alongside audio and controls. Profiles, save states, movies, shaders, and RetroAchievements extend that loop. The graph combines README-described capabilities with sampled source and index references; links for unsampled subsystems are documented rather than inferred from their names.
Main entry points: mod.rs Emulation host · application.rs Application loop · nes_core.rs NES core · ui Menus and UI
Components 20
Application and input
- Application loop
rust/crates/zax-app/src/application.rs - Menus and UI
rust/crates/zax-app/src/ui - Input routing
rust/crates/zax-app/src/input/routing.rs - ROM library
rust/crates/zax-app/src/emulation/game_catalog.rs
NES emulation
- Emulation host
rust/crates/zax-app/src/emulation/host/mod.rs - NES core
rust/crates/zax-nes/src/nes_core.rs - Cartridges and mappers
rust/crates/zax-nes/src/cartridges/mod.rs - Widescreen hacks
rust/crates/zax-nes/src/wide.rs - Audio output
rust/crates/zax-app/src/audio/stream.rs
3D scene and display
- 3D profiles
rust/crates/zax-profiles/src/catalogue/profile_catalogue.rs - 3D conversion
rust/crates/zax-engine3d/src/engine.rs - Graphics renderer
rust/crates/zax-render/src/renderer.rs - Shader support
rust/crates/zax-app/src/ui/shader_panel.rs
Player features
- Settings and saves
rust/crates/zax-app/src/persistence - Movie recording
rust/crates/zax-nes/src/movie.rs - Profile scripting
rust/crates/zax-app/src/scene_script_bridge.rs - Editor MCP
rust/crates/zax-app/src/mcp/server.rs - RetroAchievements
rust/crates/zax-app/src/achievements/mod.rs
External services
- RetroAchievements service
Other components
- Player
Connections 23
- Player → Application loop: launches
- Player → Menus and UI: operates
README.md - Menus and UI → Application loop: plugs into
rust/crates/zax-app/src/application.rs - Application loop → Emulation host: runs
rust/crates/zax-app/src/application.rs - Player → ROM library: selects ROM
README.md - Emulation host → ROM library: uses catalog
rust/crates/zax-app/src/emulation/host/mod.rs - Input routing → NES core: encodes controls
rust/crates/zax-app/src/input/routing.rs - Emulation host → NES core: runs frames
README.md - NES core → Cartridges and mappers: dispatches mapper
rust/crates/zax-nes/src/cartridges/mod.rs - NES core → Widescreen hacks: applies hacks
README.md - Emulation host → 3D conversion: converts frames
rust/crates/zax-engine3d/src/engine.rs - 3D profiles → 3D conversion: defines scene
README.md - Application loop → Graphics renderer: draws scene
rust/crates/zax-app/src/application.rs - Application loop → Audio output: pumps audio
rust/crates/zax-app/src/application.rs - Application loop → Input routing: samples input
rust/crates/zax-app/src/application.rs - Emulation host → Settings and saves: uses save states
README.md - Emulation host → Movie recording: records and replays
README.md - Application loop → Shader support: requests shaders
rust/crates/zax-app/src/application.rs - Emulation host → Profile scripting: bridges scripts
rust/crates/zax-app/src/application.rs - Editor MCP → Profile scripting: exposes harness
README.md - Emulation host → RetroAchievements: updates progress
rust/crates/zax-app/src/emulation/host/mod.rs - RetroAchievements → RetroAchievements service: requests service
README.md - Player → 3D profiles: imports profiles
README.md