Skip to content

fix: force GTK3 on Linux to prevent white screen on Arch/CachyOS - #44

Open
affectioned wants to merge 1 commit into
mainfrom
fix/gtk3-arch-white-screen
Open

fix: force GTK3 on Linux to prevent white screen on Arch/CachyOS#44
affectioned wants to merge 1 commit into
mainfrom
fix/gtk3-arch-white-screen

Conversation

@affectioned

Copy link
Copy Markdown
Owner

Summary

  • Force --gtk-version=3 in the Linux startup block so Electron's GTK4 renderer doesn't paint white on Arch-based distros (CachyOS in particular).
  • Extends the existing Vulkan/Ozone workaround shipped in 1.3.1, which handled Wayland but not the GTK4 rendering bug reported in White screen on Arch linux (cachyos) #43.
  • Sandbox stays enabled.

Why this fixes #43

The user's log shows Discord RPC connecting (main process is fine) followed immediately by Network service crashed or was terminated, restarting service and a white window. That pattern matches the well-known GTK4 paint failure in Electron (electron/electron#33690) — the renderer never finishes its first paint, the utility processes tear down, and the window stays blank. The confirmed community fix from Arch BBS #306492 is --gtk-version=3, which is what this PR adds.

Does not use --no-sandbox, --disable-gpu, or any of the flags that would reduce security.

Test plan

  • Build a Linux AppImage from this branch and run on CachyOS (the reporter's environment) — window should now load ynoproject.net instead of showing white.
  • Sanity-check on Windows and macOS that the Linux-only block still no-ops there.
  • Confirm Discord RPC still connects and updates presence after the app renders.

Fixes #43

🤖 Generated with Claude Code

Electron's GTK4 renderer paints the window white on many Arch-based
distros (CachyOS reported in #43). The main process still starts, so
Discord RPC connects, but the network service crashes and the renderer
never shows content. The existing Vulkan/Ozone workarounds handle
Wayland but not this GTK4 rendering bug.

Force GTK3 via --gtk-version=3, following the fix confirmed in Arch BBS
#306492. Sandbox stays enabled.

Fixes #43

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@jojo989

jojo989 commented Aug 19, 2026

Copy link
Copy Markdown

this commit still gives me white scren when i build it D:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

White screen on Arch linux (cachyos)

2 participants