A NesTs Nintendo Entertainment System (NES) Emulator Written in React

NesTs Nintendo Entertainment System (NES) Emulator



Summary

You can play online demo HERE. TypeScript/React.js NES emulator implementation for My Own Learning Porpose. The implementation is NOT fully faithfull to the original NES hardware and some codes are still messy.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev

Open http://localhost:3000 with your browser to see the result.

Key-Mappings

NES Button Keyboard
Arrow-Right
Arrow-Down
Arrow-Left
Arrow-Up
SELECT Space
START Return
A X
B Z

Roadmap

The following is a checklist of features and their progress:

  • [x] Console
    • [x] NTSC
  • [x] CPU
    • [x] Official Instructions
    • [ ] Unofficial Instructions
    • [x] Interrupts
  • [x] PPU
    • [x] VRAM
    • [x] Background
    • [x] Sprites
    • [x] NTSC TV Artifact Effects
    • [x] Emphasize RGB/Grayscale
  • [ ] APU
    • [ ] AudioWorklet
    • [x] Pulse Channels
    • [x] Triangle Channels
    • [x] Noise Channels
    • [x] Delta Mulation Channel
  • [x] Inputs
  • [x] Memory
  • [x] Cartridge
    • [ ] Battery-backed Save RAM
    • [x] iNES Format
    • [ ] NES 2.0 Format
    • [ ] Mappers
      • [x] NROM (Mapper 0)
      • [x] SxROM/MMC1 (Mapper 1)
      • [x] UxROM (Mapper 2)
      • [x] CNROM (Mapper 3)
      • [ ] TxROM/MMC3 (Mapper 4)
      • [ ] ExROM/MMC5 (Mapper 5)
  • [ ] Misc
    • [ ] Reimplement UI/UX for smartphone users
    • [X] GitHub page
    • [ ] Unit/Integration tests
    • [ ] Refactor Source Codes
    • [X] Error Handling
    • [ ] Documentation
    • [ ] Make Things Responsive

GitHub

https://github.com/ognis1205/nests