Troubleshooting on Linux

App crashes when opening an image / entering edit mode

If RapidRAW crashes immediately when you try to start editing a picture, it is almost always due to the automatic selection of the GPU backend.

1. Open the splash screen → Settings (gear icon).
2. Navigate to the Processing tab.
3. Find the Processing Backend setting.
4. Change it from Auto to a specific backend. On Linux, try Vulkan first; if that fails, try OpenGL.
5. Restart the application and try opening the image again. Experiment with different backends if the first one doesn't work.

OpenGL is the fallback that works on most platforms. It's slower than Vulkan, but if Vulkan can't initialize on your specific Mesa or proprietary driver, OpenGL will almost always start.

Linux Wayland / WebKit crash

If RapidRAW crashes on Wayland (typically GNOME + NVIDIA), try launching it with one of these environment variables:

WEBKIT_DISABLE_DMABUF_RENDERER=1 RapidRAW

or

WEBKIT_DISABLE_COMPOSITING_MODE=1 RapidRAW

This issue is related to WebKit and NVIDIA drivers, not RapidRAW directly. Switching to X11, or using AMD / Intel GPUs, may also help.

See #306 for more information.

Logs

When filing a bug, attach the log file:

~/.local/share/io.github.CyberTimon.RapidRAW/logs/app.log

Tail it live during a session:

tail -f ~/.local/share/io.github.CyberTimon.RapidRAW/logs/app.log

See Filing a Bug Report for the full process and the bug template.

See also

• GPU & Drivers for the Vulkan backend.
• File Issues for unsupported RAWs and sidecar problems.
• Filing a Bug Report.