Preload system SDL2 to use muOS mali driver

pygame-ce's PyPI wheel bundles a headless SDL2 that only has the
offscreen/dummy video drivers. On muOS devices, this results in an
invisible app — pygame renders to memory, the framebuffer never updates,
and users are stuck on the muOS "Loading Application" splash.

muOS devices ship their own SDL2 2.28.5 at /usr/lib/libSDL2-2.0.so.0
with a custom mali video driver for the Mali GPU. On some setups
(e.g. RG35XXH) a SETUP_APP hook LD_PRELOADs libmustage.so which pulls
in this system SDL2, making it work by accident. On others (RG35XX Pro,
RG40XXH) libmustage.so is missing, so the bundled headless SDL2 gets
used and the screen stays blank.

Fix: explicitly LD_PRELOAD /usr/lib/libSDL2-2.0.so.0 from the launch
script when present. pygame then uses muOS's mali-capable SDL2
regardless of libmustage.so availability.

Also bundles libdrm.so.2/libgbm.so.1 (belt-and-braces — if a device
ever needs kmsdrm instead of mali, SDL can dlopen them from the
PyInstaller temp dir) and logs the active SDL video driver at startup
to make future display issues easier to diagnose.

Bumps version to 4.0.5. Fixes #53 — confirmed on RG35XXH, RG35XX Pro,
and RG40XXH.

Author: milouk

app.spec

@@ -4,7 +4,14 @@
 a = Analysis(
     ['src/app.py'],
     pathex=[],
-    binaries=[],
+    binaries=[
+        # Bundle libdrm/libgbm so SDL2's dynamically-loaded kmsdrm driver
+        # can find them inside PyInstaller's temp extraction dir. Without
+        # these, SDL2 falls back to the offscreen driver on muOS devices
+        # that don't expose libdrm via a standard library path.
+        ('/usr/lib/aarch64-linux-gnu/libdrm.so.2', '.'),
+        ('/usr/lib/aarch64-linux-gnu/libgbm.so.1', '.'),
+    ],
     datas=[],
     hiddenimports=[],
     hookspath=[],

mux_launch.sh

@@ -33,6 +33,16 @@ export XDG_DATA_HOME="$STATICDIR"
 export HOME="$STATICDIR"
 export LD_LIBRARY_PATH="$BINDIR/libs.aarch64:$LD_LIBRARY_PATH"
 
+# Force pygame to use muOS's system SDL2 (which has the 'mali' video driver)
+# instead of pygame-ce's bundled headless copy (dummy/offscreen only).
+# On muOS setups with libmustage.so this already happens via SETUP_APP's
+# LD_PRELOAD; on setups without it (e.g. some RG40XXH firmwares) we have
+# to do it ourselves.
+SYSTEM_SDL2="/usr/lib/libSDL2-2.0.so.0"
+if [ -f "$SYSTEM_SDL2" ]; then
+    export LD_PRELOAD="$SYSTEM_SDL2:$LD_PRELOAD"
+fi
+
 # Launcher
 cd "$ARTIE_DIR" || exit
 

src/app.py

@@ -39,7 +39,7 @@
 from settings import SettingsScreen, SystemSelectionScreen, VirtualKeyboard
 from updater import check_for_update, download_and_apply_update
 
-VERSION = "4.0.4"
+VERSION = "4.0.5"
 
 
 class _ScrapeCancelledError(Exception):

src/graphic.py

@@ -151,9 +151,10 @@ def draw_start(self, display_width: int = 0, display_height: int = 0):
             pygame.mouse.set_visible(False)
             # Enable key repeat for smooth hold-to-scroll (400ms delay, 80ms interval)
             pygame.key.set_repeat(400, 80)
+            driver = pygame.display.get_driver()
             logger.log_info(
                 f"Pygame display initialized: {dw}x{dh} "
-                f"(internal {SCREEN_WIDTH}x{SCREEN_HEIGHT})"
+                f"(internal {SCREEN_WIDTH}x{SCREEN_HEIGHT}, driver={driver})"
             )
         except (pygame.error, OSError) as e:
             logger.log_warning(f"Display initialization failed: {e}")