Tracking Issue: Wayland, WebKit, and AppImage issues on Linux

I’ve noticed several recurring reports about issues running RapidRAW under Linux with Wayland, especially with the AppImage builds. I’m opening this tracking issue to collect all Wayland-related problems in one place.

Summary of the Problem

Users on Linux distributions running the Wayland display server (such as modern versions of Ubuntu, Fedora, and Arch with GNOME/KDE) are experiencing a range of issues, from crashes and blank screens to symbol lookup errors.

This is a upstream issue affecting many applications built with the Tauri framework, not just RapidRAW. The common thread appears to be an underlying incompatibility between WebKitGTK (used by Tauri for the UI), proprietary NVIDIA drivers, and the Wayland display server. The problems are most frequently reported with the AppImage builds, likely due to its bundled environment.

Symptoms include:

• The application crashes immediately upon launch or when accessing the file system (e.g., opening a folder).
• The application window opens but remains blank or black.
• Specific errors like EGL_BAD_PARAMETER or Symbol lookup error are reported.
• General UI sluggishness and poor performance.

Known Workaround

As noted in the project's README.md, launching the application with specific environment variables can often resolve these issues by disabling certain rendering features in WebKit.

If you are experiencing crashes on Wayland, please try running RapidRAW from the terminal with one of the following commands:

WEBKIT_DISABLE_DMABUF_RENDERER=1 rapidraw

or

WEBKIT_DISABLE_COMPOSITING_MODE=1 rapidraw

Related Issues

This list consolidates reports that appear to stem from the same root cause.

Crashes, Blank Screens, and Rendering Errors:

• Issues with Ubuntu 24.04 AppImage #297
• Transparent background is distracting #252
• Latest Ubuntu 24.04 AppImage crashes to desktop when accessing folder #187
• Symbol lookup error in Wayland #178
• Crashes when opening folder Linux - Kubuntu 25.04 #134
• Fuji raf files and Linux issues #84
• Nvidia and Wayland not working #60
• AppImage panics on opening image to edit #43
• Webkit Bug #289
• RapidRaw immediately closes when started #422
• Slow performance on Linux. Vulkan issue? Possible workaround. #418
• Crashes on Pop!_OS COSMIC (Ubuntu 24.04 variant) on opening folder #480