mirror of
https://github.com/SoftFever/OrcaSlicer.git
synced 2026-03-07 11:04:46 -07:00
# 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 |
||
|---|---|---|
| .. | ||
| calib | ||
| cert | ||
| dailytip | ||
| data | ||
| flush | ||
| fonts | ||
| handy_models | ||
| hms | ||
| i18n | ||
| images | ||
| info | ||
| printers | ||
| profiles | ||
| profiles_template | ||
| shaders | ||
| tooltip | ||
| web | ||
| check_access_code.txt | ||
| Icon.icns | ||