Varvara emulator, written in C89(X11)
Go to file
Devine Lu Linvega 4f846beb26 Fixed issue with comments in macros, fixed by jjbliss 2024-05-10 08:15:53 -07:00
etc (uxnasm) Output to stdout 2024-04-02 15:12:00 -07:00
src Fixed issue with comments in macros, fixed by jjbliss 2024-05-10 08:15:53 -07:00
.build.yml Updated CI 2023-08-25 10:17:36 -07:00
.clang-format Added Fn keys controls 2022-04-05 20:06:42 -07:00
.gitignore Init 2022-03-26 17:23:52 -07:00
LICENSE Init 2022-03-26 17:23:52 -07:00
README.md Housekeeping 2023-11-11 09:50:19 -08:00
boot.rom Added boot.rom 2024-02-22 15:47:44 -08:00
makefile Added archive function to makefile 2024-03-28 19:56:40 -07:00

README.md

Uxn11

An emulator for the Uxn stack-machine, written in ANSI C. The emulator contains a few linux specific utilities in the Console device to allow for it to interface with the unix systems.

Building

Graphical

All you need is X11.

gcc -Os -DNDEBUG -g0 -s src/uxn.c src/devices/system.c src/devices/console.c src/devices/screen.c src/devices/controller.c src/devices/mouse.c src/devices/file.c src/devices/datetime.c src/uxn11.c -o bin/uxn11 -lX11

Terminal

If you wish to build the emulator without graphics mode:

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

If do not wish to build it yourself, you can download linux binaries for uxnasm, uxncli and uxn11.

builds.sr.ht status

Usage

The first parameter is the rom file, the subsequent arguments will be accessible to the rom, via the Console vector.

bin/uxnemu bin/polycat.rom arg1 arg2

Devices

The file device is sandboxed, meaning that it should not be able to read or write outside of the working directory.

  • 00 system
  • 10 console(+)
  • 20 screen
  • 80 controller
  • 90 mouse
  • a0 file
  • c0 datetime

Emulator Controls

  • F2 toggle on-screen debugger
  • F4 load boot.rom, or reload rom

Buttons

  • LCTRL A
  • LALT B
  • LSHIFT SEL
  • HOME START

Need a hand?

The following resources are a good place to start:

Contributing

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