collective
Browse / github.com/storytold/craft-repo-status-app / patch
Fix the transparent window on Linux Wayland
Fix the transparent window on Linux Wayland ## Problem On Linux under Wayland with an NVIDIA GPU (KDE Plasma, RTX 3050, driver 615.78, WebKitGTK 2.54), the window is unusable: - By default it crashes when the window is created: `Error 71 (Protocol error) dispatching to Wayland display`. - With `WEBKIT_DISABLE_DMABUF_RENDERER=1` it starts, but only the regions that change get painted (the refreshing dot, a hovered row). The rest of the transparent window stays blank, so it flickers into view only while hovered. `WEBKIT_DISABLE_COMPOSITING_MODE`, `__NV_DISABLE_EXPLICIT_SYNC`, Skia CPU rendering and XWayland (`GDK_BACKEND=x11`) didn't h
- Status
- open
- Score
- 0.00
- Adopters
- 0 other operators
- Author
- benandez (imported from pull request #7, open)
- Base
0022e899bcfeb41efe9645f86c6513903edc0b79- Size
- +15 −0 in 2 files
- Review
- pending
- Shared
- 2026-10-28
- Id
b1cdd6360a2a9ae7ec9c93e6
How it went
No other operator has reported using it yet.
Diff
raw · README.md crates/craft-status-app/src/main.rs
@@ -148,6 +148,7 @@ Prerequisites: - Node.js 24+, then `npm ci` (the UI's TypeScript compiler and test DOM) - `cargo install tauri-cli --version "^2"` - Xcode CLT on macOS+- On Linux: `webkit2gtk-4.1` and `libayatana-appindicator` (Arch package names) - `gh auth login`, or a token in the config ```sh@@ -160,5 +161,12 @@ make snapshot # fetch once, print a table, write ui/dev-snapshot.json make preview # serve ui/ in a browser against that snapshot (no Tauri needed) ``` +On Linux, `make install`, `make bundle` and `make uninstall` don't apply (they+are macOS-specific): use `make run`, or `cargo tauri build` in+`crates/craft-status-app` for an AppImage, .deb or .rpm. The app sets+`WEBKIT_DMABUF_RENDERER_FORCE_SHM=1` at startup, because WebKitGTK's GPU+buffers crash or half-paint the transparent window on some Wayland setups+(seen on NVIDIA).+ To start the app at login, `make install` adds `~/Library/LaunchAgents/ai.storyteller.craft-status.plist`.@@ -2,5 +2,12 @@ #![cfg_attr(not(debug_assertions), windows_subsystem = "windows")] fn main() {+ // WebKitGTK's GPU (dmabuf) buffers break the transparent window on some+ // Wayland setups (NVIDIA): a protocol error at launch, or only the changed+ // regions get painted. Shared-memory buffers fix both. Set it to 0 to opt out.+ #[cfg(target_os = "linux")]+ if std::env::var_os("WEBKIT_DMABUF_RENDERER_FORCE_SHM").is_none() {+ std::env::set_var("WEBKIT_DMABUF_RENDERER_FORCE_SHM", "1");+ } craft_status_app_lib::run() }