README

June 10, 2026 ยท View on GitHub

native uxn emulator for plan9front

state:

  • implemented fully:
    • uxn core
    • system device
    • screen device
    • datetime device
    • controller device
    • console device
    • mouse device
    • file device (see BUGS)
  • not implemented
    • audio device

INSTALLATION

; mk ; mk install

this will install both uxn9 and uxncli executables to your user's bin directory

USAGE

uxn9 [-S] [-A /dev/audioXXX] [-f targetfps] file.rom

-f number changes the target fps -S turns on smart drawing debug mode on -A filename set audio device to filename

BUGS and ISSUES

  • KNOWN

    • File/stat will never return "!!!! file missing" state, as a file is always create(2)d on a File/name call
    • Graphical glitches do happen
    • Keyboard input is annoying at best, infuriating at worst
  • UNKNOWN

    Upon discovery, if compassionate, please e-mail kpm AT krzysckh DOT org with steps to reproduce OR fill an issue on github. If more generous than average, send patches to upppermentioned address OR open pull requests on github. Thank you.

  • kpm