You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Andrew Alderwick cbc61578b7 Reuse old artifacts if no solar build computers are reachable. 1 week ago
etc (tests.tal) Put into projects/ 3 months ago
projects Merge branch 'main' of 4 weeks ago
src Fixed issue with monochromatic 2 weeks ago
.build.yml Reuse old artifacts if no solar build computers are reachable. 1 week ago
.clang-format * 2 years ago
.gitignore git ignore plan 9 built files 9 months ago
LICENSE init 2 years ago Update README 4 months ago General improvements to example files 4 months ago
mkfile Print stack with DEO on 0x0f 9 months ago


An assembler and emulator for the Uxn stack-machine, written in ANSI C.

Download binaries

Binaries are available for 64-bit x86 computers running Linux, Windows and macOS.


Linux/OS X

To build the Uxn emulator, you must install SDL2 for your distro. If you are using a package manager:

sudo pacman -Sy sdl2             # Arch
sudo apt install libsdl2-dev     # Ubuntu
sudo xbps-install SDL2-devel     # Void Linux
brew install sdl2                # OS X

Build the assembler and emulator by running the script. The assembler(uxnasm) and emulator(uxnemu) are created in the ./bin folder.

	--debug # Add debug flags to compiler
	--format # Format source code
	--install # Copy to ~/bin

If you wish to build the emulator without graphics mode:

cc src/devices/datetime.c src/devices/system.c src/devices/file.c src/uxn.c -DNDEBUG -Os -g0 -s src/uxncli.c -o bin/uxncli

Plan 9

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


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


Uxn can be built on Windows with MSYS2. Install by downloading from their website or with Chocolatey with choco install msys2. In the MSYS shell, type:

pacman -S git mingw-w64-x86_64-gcc mingw64/mingw-w64-x86_64-SDL2
export PATH="${PATH}:/mingw64/bin"
git clone
cd uxn

If you'd like to work with the Console device in uxnemu.exe, run ./ --console instead: this will bring up an extra window for console I/O unless you run uxnemu.exe in Command Prompt or PowerShell.

Getting Started


To launch a .rom in the emulator, point the emulator to the target rom file:

bin/uxnemu bin/piano.rom

You can also use the emulator without graphics by using uxncli. You can find additional roms here, you can find prebuilt rom files here.


The following command will create an Uxn-compatible rom from an uxntal file. Point the assembler to a .tal file, followed by and the rom name:

bin/uxnasm projects/examples/demos/life.tal bin/life.rom


You can send events from Uxn to another application, or another instance of uxn, with the Unix pipe. For a companion application that translates notes data into midi, see the shim.

uxnemu orca.rom | shim

Emulator Options

  • -s 1, -s 2 or -s 3 set zoom (default 1)

Emulator Controls

  • F1 toggle zoom
  • F2 toggle debug
  • F3 capture screen
  • F4 load launcher.rom


  • LALT B

Need a hand?

The following resources are a good place to start:


Submit patches using git send-email to the ~rabbits/public-inbox mailing list.