fix: disable WebKitGTK's DMA-BUF renderer to fix blank window on Linux #8

Merged
deiussum merged 1 commit from fix-appimage-gbm-blank-window into develop 2026-09-19 08:52:24 -05:00
Owner

Summary

  • The AppImage build showed a blank white window with Failed to create GBM buffer of size 800x600: Invalid argument on stderr, reported on an NVIDIA proprietary driver
  • This is WebKitGTK's DMA-BUF renderer (default since 2.42) failing to allocate a hardware GBM buffer — a known issue on several GPU stacks, NVIDIA in particular. This exact failure was also seen (and left unresolved) during the original migrate-electron-to-tauri testing
  • Fix: set WEBKIT_DISABLE_DMABUF_RENDERER=1 in src-tauri/src/main.rs before Tauri/WebKitGTK initializes (Linux only), falling back to a compatible rendering path

Test plan

  • cargo check — clean
  • npm run package — builds successfully
  • Confirmed fixed by the reporter on their NVIDIA machine (previously blank window, now renders correctly)

🤖 Generated with Claude Code

https://claude.ai/code/session_01KoLHnQugaAW2eknKo8FxVp

## Summary - The AppImage build showed a blank white window with `Failed to create GBM buffer of size 800x600: Invalid argument` on stderr, reported on an NVIDIA proprietary driver - This is WebKitGTK's DMA-BUF renderer (default since 2.42) failing to allocate a hardware GBM buffer — a known issue on several GPU stacks, NVIDIA in particular. This exact failure was also seen (and left unresolved) during the original `migrate-electron-to-tauri` testing - Fix: set `WEBKIT_DISABLE_DMABUF_RENDERER=1` in `src-tauri/src/main.rs` before Tauri/WebKitGTK initializes (Linux only), falling back to a compatible rendering path ## Test plan - [x] `cargo check` — clean - [x] `npm run package` — builds successfully - [x] Confirmed fixed by the reporter on their NVIDIA machine (previously blank window, now renders correctly) 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01KoLHnQugaAW2eknKo8FxVp
The AppImage build (and potentially other Linux builds) could fail to
render at all, showing a blank white window with "Failed to create GBM
buffer of size WxH: Invalid argument" on stderr - reported with an
NVIDIA proprietary driver. This is WebKitGTK's DMA-BUF renderer
(default since 2.42) failing to allocate a hardware GBM buffer, a
known issue on several GPU stacks (notably NVIDIA).

Set WEBKIT_DISABLE_DMABUF_RENDERER=1 before Tauri/WebKitGTK initializes
to fall back to a compatible rendering path. Confirmed fixed on the
reporter's NVIDIA machine.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KoLHnQugaAW2eknKo8FxVp
deiussum merged commit a2b6bf1e14 into develop 2026-09-19 08:52:24 -05:00
deiussum deleted branch fix-appimage-gbm-blank-window 2026-09-19 08:52:24 -05:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
deiussum/tesserow-backup!8
No description provided.