@ -1,27 +1,32 @@
# Uxn
## Learning
- [Learn Uxntal in Y minutes ](https://learnxinyminutes.com/docs/uxntal/ ) - Language overview for when you're in a hurry.
- [Uxn Guide by Compudanzas ](https://compudanzas.net/uxn_tutorial.html ) - Tutorial guide which covers the basics of Uxn programming.
- [Uxn Video by Compudanzas ](https://www.youtube.com/watch?v=LrNuq_JgaOA ) - Video workshop which covers the basics of Uxn programming.
- [macOS installation ](https://eli.li/how-to-install-uxn-on-macos )
- [Windows installation ](https://itch.io/t/1605965/a-quick-guide-to-running-this-software )
- [Android installation ](https://llllllll.co/t/uxn-virtual-computer/46103/253 ) - Through Termux.
- [HaikuOS installation ](https://discuss.haiku-os.org/t/uxn-ecosystem-on-haiku/12209 ) - Forum thread for the Haiku operating system.
- [Learn-uxn ](https://metasyn.srht.site/learn-uxn/ ) - A web-based learning environment with a text editor and graphics.
- [UxnREPL ](https://wiki.xxiivv.com/etc/uxnrepl/ ) - A web-based learning with examples.
## Documentation
- [Uxntal ](https://wiki.xxiivv.com/site/uxntal.html ) - Uxntal language reference manual.
- [Varvara ](https://wiki.xxiivv.com/site/varvara.html ) - Technical documentation of the Varvara computer and a list of all its devices.
- [Opcodes ](https://wiki.xxiivv.com/site/uxntal_reference.html ) - List of Uxntal opcodes and their effects.
- [Uxn implementation guide ](https://github.com/DeltaF1/uxn-impl-guide ) - Notes on how to implement the Uxn/Varvara virtual machine specification.
- [Uxntal Cheatsheet ](https://github.com/weeble/uxn-cheatsheet ) - Opcode Cheatsheet.
- [Implementation guide ](https://github.com/DeltaF1/uxn-impl-guide ) - Notes on how to implement the Uxn/Varvara virtual machine specification.
- [RosettaCode ](https://rosettacode.org/wiki/Category:Uxntal ) - Uxntal programming chrestomathy.
## File Formats
- [Sprite format ](https://wiki.xxiivv.com/site/chr_format.html ) - `.chr` file format description.
- [Font format ](https://wiki.xxiivv.com/site/ufx_format.html ) - `.ufx` file format description.
- [Compression format ](https://wiki.xxiivv.com/site/ulz_format.html ) - `.ulz` file format description.
## Tutorials
- [Uxn Tutorial by Compudanzas ](https://compudanzas.net/uxn_tutorial.html ) - Tutorial guide which covers the basics of Uxn programming.
- [Uxn Tutorial by Compudanzas(video) ](https://www.youtube.com/watch?v=LrNuq_JgaOA ) - Video workshop which covers the basics of Uxn programming.
- [Learn Uxntal in Y minutes ](https://learnxinyminutes.com/docs/uxntal/ ) - Language overview for when you're in a hurry.
- [HaikuOS ](https://discuss.haiku-os.org/t/uxn-ecosystem-on-haiku/12209 ) - Forum thread for the Haiku operating system.
- [RosettaCode ](https://rosettacode.org/wiki/Category:Uxntal ) - Uxntal programming chrestomathy.
- [macOS installation ](https://eli.li/how-to-install-uxn-on-macos )
- [Windows installation ](https://itch.io/t/1605965/a-quick-guide-to-running-this-software )
- [Android installation ](https://llllllll.co/t/uxn-virtual-computer/46103/253 ), through Termux.
## Emulators
### Desktop
@ -34,23 +39,20 @@
- [Uxn11 ](https://github.com/randrew/uxn32 ) - Linux emulator, written in C.
- [uxn9 ](https://github.com/krzysckh/uxn9 ) - Native emulator for 9front. (no audio support)
- [uxn5 ](https://git.sr.ht/~rabbits/uxn5 ) - Javascript implementation.
- [buxn ](https://github.com/bullno1/buxn ) - Multi platform emulator, written in C.
- [ruxn ](https://codeberg.org/mra/ruxn ) - A Uxn library written in Rust, intended to make defining new Uxn-based systems easy.
- [zuxn ](https://github.com/chmod222/zuxn ) - A Uxn library, emulator and assembler written in Zig.
- [UxnFb ](https://git.badd10de.dev/uxnfb ) - Linux framebuffer emulator, written in C.
- [uxnfloppy ](https://git.sr.ht/~gustav/uxnfloppy ) - Bootable emulator for BIOS, written in 16bit x86 assembly. (no keyboard/gamepad/audio/file support)
- [UxnRPI ](https://git.badd10de.dev/uxnrpi ) - RaspberryPi framebuffer emulator, written in C. (no input support)
- [UxnAmiga ](https://code.mathr.co.uk/uxn-amiga ) - AmigaOS emulator, written in C. (no keyboard or joystick input, no audio support)
- [UxnEssence ](https://gitlab.com/nakst/essence/-/tree/master/ports/uxn ) - [Essence ](https://gitlab.com/nakst/essence ) emulator, written in C.
- [UxnJulia ](https://github.com/Ismael-VC/Varvara.jl ) - Cross-platform emulator and assembler, written in Julia.
- [UxnLua ](https://github.com/DeltaF1/uxn-lua ) - Cross-platform emulator, written in Lua(Love2d).
- [uxn-rs ](https://github.com/Liorst4/uxn-rs ) - Emulator written in Rust.
- [ruxn ](https://codeberg.org/mra/ruxn ) - A Uxn library written in Rust, intended to make defining new Uxn-based systems easy.
- [zuxn ](https://github.com/chmod222/zuxn ) - A Uxn library, emulator and assembler written in Zig.
- [uxnfloppy ](https://git.sr.ht/~gustav/uxnfloppy ) - Bootable emulator for BIOS, written in 16bit x86 assembly. (no keyboard/gamepad/audio/file support)
- [buxn ](https://github.com/bullno1/buxn ) - Multi platform emulator, written in C.
- [uxn.py ](https://github.com/max22-/uxnemu.py ) - Python implementation of the VM.
### Other systems
- **Recommended for terminal-only** : [Uxncli ](https://git.sr.ht/~rabbits/uxncli ) - System, console and file devices only.
- **Recommended for bootstrapping** : [Uxnmin ](https://git.sr.ht/~rabbits/uxnmin ) - Console only.
- [FPGA ](https://github.com/tsalvo/uxn-fpga ) - Nearly Complete.
- [RPi ](https://github.com/ar-nelson/uxnpi ) - Nearly Complete.
- [Game Boy Advance ](https://git.badd10de.dev/uxngba ) - Complete.
@ -79,19 +81,21 @@
- [Libretro port ](https://github.com/kivutar/uxn ) - [Libretro ](https://www.libretro.com/ ) emulation layer.
- [LearnUxn ](https://git.sr.ht/~metasyn/learn-uxn/ ) - Web assembler and emulator.
- [Grid ](https://tildegit.org/nihilazo/grid-uxn ) - Incomplete.
- [Rockbox ](https://tilde.town/~nihilazo/varvara_rockbox.html ) - Implemented: Core, Screen.
- [Logisim ](https://github.com/DeltaF1/uxn-logisim ) - Incomplete.
- [Adafruit PyBadge ](https://git.sr.ht/~poyu/uxn-pybadge ) - Implemented: Core, Console, Screen, Controller.
- [Webuxn ](https://github.com/aduros/webuxn ) - Lightweight port of the Uxn virtual machine to the web via WebAssembly.
- [auxn ](https://github.com/saucesaft/auxn ) - uxn running inside of an audio plugin (standalone mode included)
- [UxnWasm ](https://github.com/remko/uxn.wasm ) - WebAssembly implementation of the Uxn core.
- [uxnbot ](https://git.sr.ht/~rabbits/uxnbot ), a REPL.
- [uxnbot ](https://git.sr.ht/~rabbits/uxnbot ) - a REPL.
- [uxn.py ](https://github.com/max22-/uxnemu.py ) - Python implementation of the VM.
- [Uxncli ](https://git.sr.ht/~rabbits/uxncli ) - System, console and file devices only.
- [Uxnmin ](https://git.sr.ht/~rabbits/uxnmin ) - Console only.
## Applications
### Creative
- [Left ](https://wiki.xxiivv.com/site/left.html ) - Graphical plain-text editor with proportional fonts and Uxntal syntax highlight.
- [Left ](https://wiki.xxiivv.com/site/left.html ) - Graphical text-editor with Uxntal syntax highlight.
- [Nasu ](https://wiki.xxiivv.com/site/nasu.html ) - Spritesheet editor.
- [Noodle ](https://wiki.xxiivv.com/site/noodle.html ) - Drawing tool.
- [Turye ](https://wiki.xxiivv.com/site/turye.html ) - Font editor.
@ -100,14 +104,19 @@
### Utilities
- [Notepad ](https://wiki.xxiivv.com/site/notepad.html ) - Notepad.
- [Calendar ](https://wiki.xxiivv.com/site/calendar.html ) - Calendar.
- [Theme ](https://wiki.xxiivv.com/site/theme.html ) - Theme editor.
- [Dexe ](https://wiki.xxiivv.com/site/dexe.html ) - Graphical hex editor.
- [Calc ](https://git.sr.ht/~rabbits/uxn/tree/main/item/projects/software/calc.tal ) - Graphical hexadecimal calculator.
- [Clock ](https://git.sr.ht/~rabbits/uxn/tree/main/item/projects/examples/devices/datetime.tal ) - Graphical clock.
- [CCCC ](https://wiki.xxiivv.com/site/cccc.html ) - Graphic al calculator.
- [Nebu ](https://wiki.xxiivv.com/site/nebu.html ) - Spreadsheet calculator
- [Starling ](https://git.sr.ht/~cabrendan/starling ) - Spreadsheet application.
- [Beetbug ](https://git.sr.ht/~rabbits/beetbug ) - Step debugger.
- [Varaboy ](https://github.com/tbsp/varaboy ) - Gameboy Emulator.
### Games
- [Oquonie ](https://hundredrabbits.itch.io/oquonie ) - Puzzle adventure game.
- [Niju ](https://hundredrabbits.itch.io/niju ) - Hiragana and katakana learning game.
- [Donsol ](https://hundredrabbits.itch.io/donsol ) - Card game about exploring a dungeon made of a standard 54 poker card set.
- [Flappy ](https://github.com/keijiro/uxn-sketches/blob/main/flappy.tal ) - Implementation of a Flappy Bird-like game.
@ -126,24 +135,20 @@
- [Tile Garden ](https://kylep.itch.io/tile-garden ) - Idle game where you place tiles to make plants.
- [Polycat ](https://git.sr.ht/~rabbits/polycat ) - Platformer game, written in Uxntal for Varvara.
### Networking
- [Xrxs ](https://nilfm.cc/git/xrxs/about/ ) - Experimental game server using the Plan 9 protocol 9p.
### Operating systems/REPLs
- [UF ](http://www.call-with-current-continuation.org/uf/uf.html ) - A traditional Forth system for Varvara.
- [PotatoOS ](http://wiki.xxiivv.com/site/potato.html ) - A little desktop environment.
- [CollapseOS ](https://github.com/schierlm/collapseos-uxn ) - Forth-based [operating system ](http://collapseos.org/ ) for Varvara.
- [Uxnfth ](https://git.sr.ht/~binarycat/uxnfth ) - Uxn-native forth.
- [PotatoOS ](http://wiki.xxiivv.com/site/potato.html ) - A little desktop environment.
- [Varaboy ](https://github.com/tbsp/varaboy ) - Gameboy Emulator.
- [TalOS ](https://github.com/UxnTalOS/talos ) - A small Uxntal REPL and System Monitor/OS written in Uxntal.
### Demos
- [Bad Apple!! Uxn ](http://167.235.19.20/bad-apple-uxn/ ) - An arrangement of the Bad Apple!! music video.
- [Bad Apple!! ](http://167.235.19.20/bad-apple-uxn/ ) - An arrangement of the Bad Apple!! music video.
- [tiles ](https://codeberg.org/kira/uxn-demos/src/branch/master/tiles.tal ) - A scrolling tile-map renderer.
- [svitlyna ](https://github.com/gardenappl/svitlyna ) - A "full-color" image viewer.
- [Bunnymark ](https://git.sr.ht/~rabbits/uxn/tree/main/item/projects/examples/demos/bunnymark.tal ) - Render performance benchmark.
### Libraries
@ -158,17 +163,16 @@
- [femto ](https://git.phial.org/d6/nxu/raw/branch/main/femto.tal ) - nano-like text editor ([about](https://git.phial.org/d6/nxu/raw/branch/main/femto.txt) / [launcher ](https://git.phial.org/d6/nxu/raw/branch/main/femto ) / [rom ](http://plastic-idolatry.com/erik/nxu/femto.rom ))
- [grep ](https://git.phial.org/d6/nxu/raw/branch/main/grep.tal ) - minimal grep-like tool (uses regex.tal)
## Development tools
### Networking
### IDEs
- [Xrxs ](https://nilfm.cc/git/xrxs/about/ ) - Experimental game server using the Plan 9 protocol 9p.
- [Learn-uxn ](https://metasyn.srht.site/learn-uxn/ ) - A web-based development environment with a text editor and graphics.
- [UxnREPL ](https://wiki.xxiivv.com/etc/uxnrepl/ ) - A web-based assembler with examples, no screen.
## Development tools
### Assemblers, compilers & disassemblers
- [Drifblim ](https://wiki.xxiivv.com/site/drifblim.html ) - Uxntal Assembler, written in Uxntal.
- [uxndis ](https://git.sr.ht/~rabbits/uxndis ), a disassembler for rom and sym files.
- **Recommended** : Drifblim ](https://wiki.xxiivv.com/site/drifblim.html ) - Uxntal Assembler, written in Uxntal.
- [uxndis ](https://git.sr.ht/~rabbits/uxndis ) - a disassembler for rom and sym files.
- [Uxncle ](https://github.com/CPunch/Uxncle ) - Compiler for a small subset of C to Uxn bytecode.
- [Pyuxncle ](https://github.com/CPunch/Pyuxncle ) - Python implementation of Uxncle.
- [Conch ](https://github.com/Armael/conch ) - Compiler for a C-like language with Lisp-like syntax to Uxn bytecode.
@ -191,29 +195,26 @@
- [buxn-asm ](https://github.com/bullno1/buxn ) - Uxntal assembler with a type checker.
- [buxn-dbg ](https://github.com/bullno1/buxn-dbg ) - Uxntal step debugger.
- [Callisto ](https://github.com/callisto-lang/compiler ) - Low level compiled programming language with a uxn backend
- [uxnfor ](https://git.sr.ht/~rabbits/uxnfor ) - a formatter for tal files.
### Uxntal language support
- [Atom language package ](https://atom.io/packages/language-uxntal )
- [Emacs mode ](https://github.com/non/uxntal-mode ) ([alt 1](https://github.com/xaderfos/uxntal-mode) [alt 2 ](https://github.com/rafapaezbas/uxntal-mode ))
- [Kate syntax ](https://github.com/pfych/uxntal-kate-syntax )
- [Kakoune plugin ](https://git.sr.ht/~athorp96/uxntal.kak )
- [Lite XL plugin ](https://raw.githubusercontent.com/lite-xl/lite-xl-plugins/master/plugins/language_tal.lua )
- [Micro syntax ](https://hacklab.nilfm.cc/dotfiles/blob/main/micro/syntax/uxn.yaml )
- [Nano syntax ](https://git.phial.org/d6/nxu/src/branch/main/tal.nanorc ) ([alt 1](https://codeberg.org/sejo/uxntal.nanorc) [alt 2 ](https://git.sr.ht/~cassvs/uxntal-nano ))
- [Sublime syntax ](https://git.sr.ht/~rabbits/uxn/tree/main/item/etc/syntax-highlight/tal.sublime-syntax )
- [Vim plugin ](https://github.com/karolbelina/uxntal.vim )
- [Visual Studio Code extension ](https://marketplace.visualstudio.com/items?itemName=karolbelina.uxntal )
- [Language server ](https://github.com/bullno1/buxn-ls )
- [uxnfor ](https://git.sr.ht/~rabbits/uxnfor ), a formatter for tal files.
### Benchmarking
- [Bunnymark ](https://git.sr.ht/~rabbits/uxn/tree/main/item/projects/examples/demos/bunnymark.tal ) - Render performance benchmark.
- [Kate syntax ](https://github.com/pfych/uxntal-kate-syntax )
- [Sublime syntax ](https://git.sr.ht/~rabbits/uxn-utils/tree/main/item/etc/tal.sublime-syntax )
- [Nano syntax ](https://git.sr.ht/~rabbits/uxn-utils/tree/main/item/etc/tal.nanorc )
- [Micro syntax ](https://hacklab.nilfm.cc/dotfiles/blob/main/micro/syntax/uxn.yaml )
- [Nano syntax ](https://git.phial.org/d6/nxu/src/branch/main/tal.nanorc ) ([alt 1](https://codeberg.org/sejo/uxntal.nanorc) [alt 2 ](https://git.sr.ht/~cassvs/uxntal-nano ))
## Community
- [Lines https://llllllll.co/t/uxn-virtual-computer/46103 )
- [Forum https://llllllll.co/t/uxn-virtual-computer/46103 )
- [#uxn on irc.libera.net ](https://web.libera.chat/gamja/?channels=%23uxn )
- [#uxn on Merveilles ](https://merveilles.town/tags/uxn )
Devine Lu Linvega
3 months ago