Skip to content

Getting Started with NES Development

Set up your tools for NES 6502 assembly programming.

What You Need

To develop for the NES, you need two things: a way to compile your code, and an emulator to run it.

⚙️ Dev Toolchain

Asm198x is one binary that assembles for every system in the curriculum.

Install

brew install asm198x/tap/asm198x

Or, without Homebrew, the installer script for macOS, Linux and Windows.

Compile

asm198x --dialect ca65 game.asm -o game.nes

Assembling and linking happen in one step, against a bounded linker configuration Asm198x carries itself. There is no nes.cfg to supply.

🖥️ Emulator

Install FCEUX natively for the best experience.

macOS

brew install fceux

Linux

sudo apt install fceux

Windows — Download from fceux.com

Run

fceux game.nes

Ready to Build

Your tools are set up. Time to write some code.

Start with Assembly →