1.2 KiB

Raw Blame History

Uxn

An assembler and emulator for a tiny stack-based computer, written in ANSI C.

Build

Linux

To build the Uxn emulator, you must have SDL2.

./build.sh 
	--debug # Add debug flags to compiler
	--cli # Run rom without graphics

Plan 9

To build the Uxn emulator on 9front, via npe:

mk

If the build fails on 9front because of missing headers or functions, try again after rm -r /sys/include/npe.

Getting Started

Begin by building the assembler and emulator by running the build script. The assembler(uxnasm) and emulator(uxnemu) are created in the bin folder.

./build.sh

The following command will create a rom from an uxambly file, point to a different usm file in the projects folder to assemble a different rom. You can find additional roms here.

bin/uxnasm projects/demos/life.usm bin/life.rom

And, to start the rom:

bin/uxnemu bin/life.rom

Emulator Controls

ctrl+h toggle debugger
alt+h toggle zoom

Need a hand?

Find us in #uxn, on irc.esper.net

1.2 KiB Raw Blame History

Uxn