Porporo

Porporo is an experimental operating system specification for Varvara, written in Uxntal and ANSI C. For more details, see the devlog.

Build

To build the emulator, you must install SDL2 for your distro. If you are using a package manager:

sudo pacman -Sy sdl2             # Arch
sudo apt install libsdl2-dev     # Ubuntu
sudo xbps-install SDL2-devel     # Void Linux
brew install sdl2                # OS X

To build Porporo and the required roms:

make run

Since parts of Porporo are built with itself, we need to have a partial implementation of the varvara ecosystem(src/uxncli), and an assembler(src/uxnasm). Compiling porporo begins by building these two tools, then assembling the roms required by porporo(menu.rom, wallpaper.rom, potato.rom). These 3 roms then needs to be converted to C style arrays with format-c.rom rom. When this is done we can finally compile porporo.

Global Controls

• F1, lock varvara.
• F2, center varvara.
• F4, exit varvara.
• F5, soft-reboot varvara.

Action Controls

• esc, set normal mode.
• m, set move mode.
• d, set draw mode.

Roms

Menu.rom

• tab, see all files.
• esc, exit.
• mouse1, or enter, run file.
• mouse2m or shift+enter, send filename.

Wallpaper.rom

The rom expects a file named .wallpaper in the chr format that is large enough to fill the screen. The way I do it is by, first getting the screen size(let's say 1328x640), creating a wallpaper.tga image at that size, converting it with tgachr, generating a file named wallpapera6x50.chr, and finally renaming it to .wallpaper. Voila!

uxncli ~/roms/tgachr.rom wallpaper.tga
mv wallpapera6x50.chr .wallpaper

Potato.rom

Potato is the menubar rom that holds some of the state of porporo in its zero-page:

• 0x00* action vector
• 0x02 action value

Messages

Porporo listens special console messages types:

• 0xff run command
• 0xfe set action type

Need a hand?

The following resources are a good place to start:

• XXIIVV — uxntal
• XXIIVV — uxntal reference
• compudanzas — uxn tutorial

You can also find us in #uxn on irc.esper.net.

Contributing

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