Porting a raylib game for the andbernic with muos

2026-08-30T00:00:00+02:00

Porting a raylib game for the andbernic with muos

I have anbernic with muos as system. I've thinked why not use this these machines for something more than emulation, like making games for these kind of machines with portmaster. All this it's done on an Arch, Endeavour OS, on a x86_64, so you'll have to adapt these step to the system you have.

Portmaster

Portmaster is a plataform that provides the instalation of games from other platforms, either with and runtime environment or offering native versions of these games.

For this case I use westonpack, more than anything becuse it seems muos uses the framebuffer /dev/fb0 to draw on screen instead of DRM/KMS as raylib uses. Westonpack is a runtime environment that emulates the graphics stack that is found tipically on a Linux desktop and not on a Linux for embedded.

Building environment preparation

Reading this https://portmaster.games/porting.html you can have your environment for porting games with raylib. In this section I'm going to describe how I've mounted mine.

You need to have installed in your system debootstrap and qemu-user-static-binfmt.

We adapt the steps we need from https://wiki.debian.org/Debootstrap.

> mkdir debian-arm64
> sudo debootstrap --arch=arm64 stable debian-arm64 http://deb.debian.org/debian/

Once finished we do chroot there

> sudo chroot debian-arm64/

If qemu-user-static-binfmt is well installed on the host, on chroot when doing the following

> uname -m

should display

aarch64

Installation and package configuration

Do this on yor terminal, inside chroot

> apt install cmake-curses-gui build-essential libsdl2-dev

Download the source code of the actual version of raylib (for this date) https://github.com/raysan5/raylib/archive/refs/tags/6.0.tar.gz in root, or another part of your chroot environment

Personally for working comfortably in chroot root from host I give it all permissions from my user and group to the root of chroot (no /root from the host). Extract zip and enter in the dir.

> tar -xzf raylib-6.0.tar.gz
> cd raylib-6.0
> ccmake .

Press C key (Configure)

Once finished the initial configuration

We edit these fields until the look like this, we don't delete fields.

BUILD_EXAMPLES OFF
OPENGL_VERSION 2.1
PLATFORM SDL

Again, configure, until Generate appears (key G), and press G to generate. Exit and do

> make
> make install

Una vez listo, copia tu juego en una carpeta dentro del chroot y cuando lo compiles añades estas bibliotecas mas las que tengas Once done, copy your game into a dir inside chroot and when you compile add these libraries

-ldrm -lgbm -lEGL -lGL

Westonpack

Follow the instructions from https://github.com/binarycounter/Westonpack/wiki/SDL2-on-X11-Example#running-sdl2-games-that-require-x11.

And copy and adapt this script https://github.com/binarycounter/Westonpack/wiki/SDL2-on-X11-Example#example-script-opengl-2 for your port.

At least changing the names is enough. Rename the script to the name of your port.

Packaging for testing

The port structure would be

port
├── game-name
│   ├── assets
│   │   ├── whatever
│   │
│   ├── libs.aarch64    Put all your libraries you game uses here
│   │   └── libraylib.so.600    This if you has compiled raydlib as a dynamic lib
│   ├── game-name.aarch64
│   └── x11sdllib
│       └── libSDL2-2.0.so.0
└── game-name.sh

Uploading to your little machine

Use scp or sftp to upload the port to your machine for testing

Copy /port/nombre-juego to ports/nombre-juego Copy /port/nombre-juego.sh to ROMS/Ports/nombre-juego.sh

Portmaster here tells about to kill the UI to test the game from terminal, with the last steps we can keep the user interface and test the game as if it were downloaded from Portmaster.

This structure is for testing purposes only, for packaging for portmaster is necessary metadata files.

This is all for the moment, for any aclaration or details please contact me.

glimmerptr

Porting a raylib game for the andbernic with muos

Porting a raylib game for the andbernic with muos

Portmaster

Building environment preparation

Installation and package configuration

Westonpack

Packaging for testing

Uploading to your little machine