Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

nessemble

nessemble is a 6502 assembler targeting the Nintendo Entertainment System (NES), written in Rust.

Upgrading from a 1.x release? See Upgrading for what changed in 2.0.

Getting Started

To initialize a new project:

nessemble init

Build the project:

nessemble project.asm --output project.nes --format nes

Run project.nes in any NES emulator to see the result.

Documentation

Start here: Installation.

  • Usage — the command-line interface.
  • Syntax — the assembly language reference.
  • Extending — custom pseudo-instructions with Rhai.
  • Building — building from source.
  • Translating — adding a locale.