Skip to content

AppImage shows only white screen since v0.2.2 (EGL_BAD_PARAMETER) #96

@steepdawn974

Description

@steepdawn974

Bug description

Starting with the v0.2.2 AppImage the application window never finishes loading – only a blank white screen is shown.
Console prints:

Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...

Downgrading to the v0.2.1 AppImage works fine.

Steps to reproduce

  1. Download keeper-desktop_0.2.2_amd64.AppImage
  2. chmod +x keeper-desktop_0.2.2_amd64.AppImage
  3. ./keeper-desktop_0.2.2_amd64.AppImage
  4. Window opens → stays white forever
    (same result on both Wayland and X11 sessions)

Environment

  • OS: Arch Linux (kernel 6.11)
  • Mesa: 24.2.3
  • libwebkit2gtk-4.0-37 (system): 2.44
  • GPU: Intel

Root cause

The v0.2.2 AppImage bundles its own copy of libwebkit2gtk-4.0-37 that was built against Ubuntu 22.04's older EGL/Mesa headers.
When the runtime web-process tries to create an EGL context it receives EGL_BAD_PARAMETER and aborts, leaving the front-end window empty.

Possible Work-around (suggested by AI; not verified!)

Delete the bundled library so the AppImage falls back to the system's up-to-date webkit:

sudo mount -o loop keeper-desktop_0.2.2_amd64.AppImage /mnt
sudo rm /mnt/usr/lib/libwebkit2gtk-4.0-37.so*
sudo umount /mnt

Suggested fix (suggested by AI; not verified!)

Do not ship libwebkit2gtk-4.0-37 inside the AppImage (or rebuild it on an Ubuntu ≥24.04 runner with current Mesa/EGL) so the host driver stack is used.

Additional context

Issue identical to the EGL regression seen in other Tauri-based AppImages --> https://github.com/music-assistant/companion/issues/57
Affects both Wayland and X11 sessions.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions