October 17, 2021, 4:22pm 253

Sure thing. Is here on llllllllines good? It’ll get a bit buried. I don’t have a blog or something like that at the moment (boo I’m an impoverished netizen!). Well I could do a GitHub thing.

Here’s a loose sketch, I’ll update as necessary.

First get the command line environment in place and a graphical UI with two Android apps

1. Install command line environment Termux. It’s powerful and loads of fun, but for now we focus on just getting Uxn going. Old versions are available via Google Play, the newer versions moved to alternative app store F-Droid.
2. Install X11 graphical user interface. Follow the steps in that doc but basically apt install x11-repo and apt install tigervnc fluxbox.
3. On Android side install a VNC client e.g. VNC viewer.

Then get the build environment in place.

1. Install compiler and build tools with apt install clang git.
2. Install SDL with apt install sdl2.

Ok onetime setup is complete. Run the steps below to update and run Uxn

1. Acquire Uxn source code with git clone https://git.sr.ht/~rabbits/uxn the first time, or git pull to retrieve updates.
2. Build Uxn with ./build.sh

Run the whole stack

1. In Termux, run vncserver -localhost. You might want to tweak the -geometry argument later on to minimize scrolling
2. Tell X11 where the screen is with export DISPLAY=:1 or whatever display number vncserver reported.
3. Run your VNC client and connect to localhost on start.
4. Run Uxn with bin/uxnemu bin/piano.rom or another rom, e.g. Orca

To bring down the environment, disconnect your VNC client, press Ctrl-C in the terminal you ran uxnemu, and run vncserver -kill.

Uxn wants compiled roms to be in directory ~/roms.

(from the top of my head, I’ll update as I recall. I also made this comment a wiki which I believe means anyone can edit it)

6 Likes