fami-rust

fami-rust is a Family Computer (NES) emulator written in Rust.

Notice: Currently, only the CPU (6502) is functional. The PPU (Picture Processing Unit) and APU (Audio Processing Unit) are still under development.

Supported Platforms

Windows / macOS / Linux

License

MIT License

Build

cargo build

Usage

1. Prepare a ROM image. If you own a NES cartridge, you can dump it using a dumper (e.g., FC DUMPER).
2. Alternatively, use Homebrew/Public Domain ROMs. You can use copyright-free ROM images for testing(*).
3. Run the emulator. Pass the ROM file path as an argument. Example: cargo run nestest.nes or fami-rust nestest.nes
4. Current Behavior: An empty window will appear (since graphics are not yet implemented), but the emulator logic runs in the background.
5. Logging: All CPU states are output to the console on every clock cycle.

---

(*) nestest.nes is recommended for comprehensive testing of all 6502 instructions.