mirror of
https://github.com/SoftFever/OrcaSlicer.git
synced 2026-03-08 20:44:43 -06:00
c12912e0df
# Description Fixes the Setup Wizard getting stuck on the "Loading......" screen when running on Wayland sessions. **Root Cause:** When OrcaSlicer runs under XWayland (Wayland sessions with `GDK_BACKEND=x11`), WebKit2GTK's compositing mode can fail silently, causing the Setup Wizard WebView to freeze or render blank. The JavaScript signal from C++ (`userguide_profile_load_finish`) either fails to execute or its rendering result never displays, leaving users permanently stuck. **Solution:** 1. Set `WEBKIT_DISABLE_COMPOSITING_MODE=1` environment variable to force software rendering for WebKit2GTK - this is the same fix used by BambuStudio 2. Enable the 20-second timeout fallback in `load.js` so the wizard proceeds automatically even if the C++ → JavaScript communication fails **Files changed:** - `src/OrcaSlicer.cpp` - Added `WEBKIT_DISABLE_COMPOSITING_MODE` env var (4 lines) - `resources/web/guide/0/load.js` - Enabled timeout fallback (2 lines) # Screenshots/Recordings/Graphs N/A - This is a Linux/Wayland-specific fix that addresses a rendering issue. The visual result is simply that the Setup Wizard proceeds past "Loading......" as expected. ## Tests 1. **On Wayland session (e.g., GNOME on Wayland):** - Remove existing config (`~/.config/OrcaSlicer/`) to simulate first launch - Launch OrcaSlicer - Verify Setup Wizard proceeds past "Loading......" to the actual wizard page 2. **On X11 session:** - Same test as above to verify no regression 3. **Verify env var is set:** - Check that `WEBKIT_DISABLE_COMPOSITING_MODE=1` is in the process environment on Linux builds |
||
|---|---|---|
| .. | ||
| data | ||
| flush | ||
| guide | ||
| homepage | ||
| image | ||
| include | ||
| login | ||
| model | ||
| orca | ||