Uxn is the virtual machine powering the Hundred Rabbits software.

The virtual machine, programmable in Uxntal, is a portability layer with a focus on hosting graphical tools and games. It lives at the heart of the Varvara ecosystem.

• Uxn Instructions: Reference, Tests
• Varvara Devices: Reference, Tests
• Emulators: CLI, GUI(X11)

This wiki along with most of the audio-visual projects documented on it are running on Uxn.

Memory

Uxn utilizes two circular stacks of bytes, the return stack allows it to tunnel through 128 subroutines and find its way back, and 64kb of addressable working memory. It can interface with up to 16 peripherals, such as screens and controllers. Uxn's has no registers, no undefined behaviors, and cannot error.

Emulator

Here is an implementation of a basic Uxn emulator in C89 which includes the Console device and passes the opcode tests:

cc uxnmin.c -o uxnmin view raw

Assembler

Since the assembler is written in the same language that it assembles, there are a few ways to get a working copy of the assembler rom:

1. Download a pre-assembled rom.
2. Assemble your own with the live REPL.
3. Bootstrap from a hexdump.

uxnasm drifloon.tal drifloon.rom view raw

The compiler is used with uxnmin to convert .tal source files into .rom binary files:

cat input.tal | uxnmin drifloon.rom > output.rom

Stack-machines programming make for an habitable bedrock abstraction for this scale of personal computing as one can comfortably write programs in assembly to tackle most computation projects with what feels like high-level abstractions.

Original illustrations created
by Rekka Bellum.

• Official Site
• Run in Browser
• Communities: Mailing List • Forum
• Chat: Catlang Discord • #uxn on irc.libera.chat

• 17P04 — Uxn Specification Frozen
• 15B13 — Uxn is born!

incoming forth macintosh ufx format ulz format drifblim varvara playdate oscean devine lu linvega uxn devlog now lie in it hundred rabbits