Uxn

Tutorials

• Uxn Tutorial by Compudanzas - Beginner-friendly tutorial guide which covers the basics of Uxn programming.
• Uxn Tutorial by Compudanzas(video) - Beginner-friendly video workshop which covers the basics of Uxn programming.
• Learn Uxntal in Y minutes - Quick Uxntal guide.
• Uxn implementation guide - Notes on how to implement the Uxn/Varvara virtual machine specification.
• macOS installation
• Windows installation
• Android installation - Guide for running Uxn on the Android operating system through Termux.
• HaikuOS - Forum thread for the Haiku operating system.
• RosettaCode - Uxntal programming chrestomathy. See also: tasks not implemented yet.

Documentation

• Uxntal - Uxntal language reference manual.
• Varvara - Technical documentation of the Varvara computer and a list of all its devices.
• Opcodes - List of Uxntal opcodes and their effects.
• Uxntal Cheatsheet - Opcode Cheatsheet.
• Sprite format - .chr file format description.
• Font format - .ufx file format description.
• Compression format - .ulz file format description.

Emulators

Desktop

• Recommended for Linux: Uxn2 - Cross-platform emulator, written in C(SDL2).
• Recommended for Windows: Uxn32 - Windows emulator, written in C.
• Recommended for Mac: Raven - Cross-platform emulator, written in Rust.
• Uxn38 - Emulator written in C with SDL1.
• Nux - Emulator written in Go.
• Uxn11 - Linux emulator, written in C.
• uxn9 - Native emulator for 9front. (no audio support)
• uxn5 - Javascript implementation.
• UxnFb - Linux framebuffer emulator, written in C.
• UxnRPI - RaspberryPi framebuffer emulator, written in C. (no input support)
• UxnAmiga - AmigaOS emulator, written in C. (no keyboard or joystick input, no audio support)
• UxnEssence - Essence emulator, written in C.
• UxnJulia - Cross-platform emulator and assembler, written in Julia.
• UxnLua - Cross-platform emulator, written in Lua(Love2d).
• uxn-rs - Emulator written in Rust.
• ruxn - A Uxn library written in Rust, intended to make defining new Uxn-based systems easy.
• zuxn - A Uxn library, emulator and assembler written in Zig.
• uxnfloppy - Bootable emulator for BIOS, written in 16bit x86 assembly. (no keyboard/gamepad/audio/file support)
• buxn - Multi platform emulator, written in C.
• uxn.py - Python implementation of the VM.

Other systems

• FPGA - Nearly Complete.
• RPi - Nearly Complete.
• Game Boy Advance - Complete.
• Nintendo 64 - Complete.
• Nintendo DS - Complete.
• Playdate - Complete.
• Nook eReader - Complete.
• Nokia N900 - Partial.
• Game Boy - Experimental.
• DOS - Implemented: Core, Screen, Mouse, Controller.
• Teletype - Incomplete.
• ESP32 - Incomplete.
• iOS - Nearly Complete (missing midi and controller).
• iOS - Incomplete.
• STM32 - Incomplete.
• STM32duino - Incomplete.
• IBM PC - Incomplete.
• PlayStation Vita - Incomplete.
• PlayStation Portable - Nearly Complete (missing keyboard).
• Atari ST - Incomplete.
• Android - Complete.
• Pebble OS - Experimental.

Misc

• Libretro port - Libretro emulation layer.
• LearnUxn - Web assembler and emulator.
• Grid - Incomplete.
• Rockbox - Implemented: Core, Screen.
• Logisim - Incomplete.
• Adafruit PyBadge - Implemented: Core, Console, Screen, Controller.
• Webuxn - Lightweight port of the Uxn virtual machine to the web via WebAssembly.
• auxn - uxn running inside of an audio plugin (standalone mode included)
• UxnWasm - WebAssembly implementation of the Uxn core.
• uxnbot, a REPL.

Applications

Creative

• Left - Graphical plain-text editor with proportional fonts and Uxntal syntax highlight.
• Nasu - Spritesheet editor.
• Noodle - Drawing tool.
• Turye - Font editor.
• Orca - Livecoding IDE.
• uxn-harp - Chordal musical toy.

Utilities

• Dexe - Graphical hex editor.
• Calc - Graphical hexadecimal calculator.
• Clock - Graphical clock.
• Starling - Spreadsheet application.
• Beetbug - Step debugger.

Games

• Niju - Hiragana and katakana learning game.
• Donsol - Card game about exploring a dungeon made of a standard 54 poker card set.
• Flappy - Implementation of a Flappy Bird-like game.
• Pong - Recreation of the classic Pong game.
• Snake - Classic Snake game implementation.
• Cat Cubes - Puzzle game about matching and clearing tiles from a board.
• Minesweeper - Minesweeper port for Varvara.
• XO - TicTacToe for Varvara.
• Fourtette - Tetris for Varvara.
• Shanghai - Mahjong Solitaire for Varvara.
• Pinkie Run - Pony-themed Endless Runner for Varvara.
• oneko-uxn - A version of “Neko”, the classic desktop pet cat, with several characters.
• Lights Out - Puzzle game for Varvara.
• Worm - Dune themed snake game for Varvara.
• Kodiak - Klondike solitaire with music and bears.
• Tile Garden - Idle game where you place tiles to make plants.
• Polycat - Platformer game, written in Uxntal for Varvara.

Networking

• Xrxs - Experimental game server using the Plan 9 protocol 9p.

Operating systems/REPLs

• UF - A traditional Forth system for Varvara.
• CollapseOS - Forth-based operating system for Varvara.
• Uxnfth - Uxn-native forth.
• PotatoOS - A little desktop environment.
• Varaboy - Gameboy Emulator.
• TalOS - A small Uxntal REPL and System Monitor/OS written in Uxntal.

Demos

• Bad Apple!! Uxn - An arrangement of the Bad Apple!! music video.
• tiles - A scrolling tile-map renderer.
• svitlyna - A "full-color" image viewer.

Libraries

• math32 - Unsigned 32-bit integers
• regex - Regex parsing and matching (repl)
• fix16 - Signed 16-bit fixed point numbers (8.8)
• alloc - Arena-based memory allocator
• arg - Command-line argument parsing (demo)

Terminal / Command-line

• femto - nano-like text editor (about / launcher / rom)
• grep - minimal grep-like tool (uses regex.tal)

Development tools

IDEs

• Learn-uxn - A web-based development environment with a text editor and up-to-date versions of Uxnasm and Uxnemu.

Assemblers, compilers & disassemblers

• Drifblim - Uxntal Assembler, written in Uxntal.
• uxndis, a disassembler for rom and sym files.
• Uxncle - Compiler for a small subset of C to Uxn bytecode.
• Pyuxncle - Python implementation of Uxncle.
• Conch - Compiler for a C-like language with Lisp-like syntax to Uxn bytecode.
• Uxnbruteforce - Tool for optimizing little pieces of Uxntal code.
• Uxnlin - Linter for Uxntal.
• Uxnbot - IRC bot for assembling and running small Uxntal snippets.
• Pyuxntaldisasm - Very basic disassembler for Uxn ROMs.
• Uxnasm-js - Uxntal assembler written in JavaScript.
• Uxn-disassembler - A rom disassembler writen in Uxntal
• Dotal - A small language designed to compile to the Uxn virtual machine.
• lunas - An Uxntal assembler written in Lua.
• chibicc-uxn - A C compiler for Uxn, written in C.
• nito - A compiler from Uxntal to C, written in Raku. See also the blog post.
• funktal - A small, statically typed, functional programming language that compiles to Uxntal. The compiler is written in Fortran. See also the blog post.
• Finwë - A high-level, stack-based language that compiles to Uxn bytecode.
• Yaku - An Uxntal assembler and interpreter.
• B - Compiler for the B Programming Language implemented in Crust, has support for uxn target.
• niënor - Optimizing compiler for a Lisp dialect.
• SUPERFLY - Concatenative array language.
• buxn-asm - Uxntal assembler with a type checker.
• buxn-dbg - Uxntal step debugger.
• Callisto - Low level compiled programming language with a uxn backend

Uxntal language support

• Atom language package
• Emacs mode (alt 1 alt 2)
• Kate syntax
• Kakoune plugin
• Lite XL plugin
• Micro syntax
• Nano syntax (alt 1 alt 2)
• Sublime syntax
• Vim plugin
• Visual Studio Code extension
• Language server
• uxnfor, a formatter for tal files.

Benchmarking

• Bunnymark - Render performance benchmark.

Community

• Lines
• #uxn on irc.libera.net
• #uxn on Merveilles

Contributing

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