OrcaSlicer/resources
SoftFever c12912e0df
Fix Setup Wizard stuck on "Loading..." on Wayland (#12159)
# 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
2026-02-03 23:10:17 +08:00
..
calib Non manifold edges calibration bug-fix (#11861) 2026-01-16 18:27:22 -03:00
cert FIX:use a complete certificate 2025-09-29 23:38:22 +08:00
dailytip Add the full source of BambuStudio 2022-07-15 23:42:08 +08:00
data Update documentation links in hints.ini (#12075) 2026-01-26 09:51:00 -03:00
flush ENH: update flush data for H2D 2025-09-23 21:42:00 +08:00
fonts Feature/bs1.8beta (#2844) 2023-12-01 10:42:45 +00:00
handy_models Add Cali Cat handy model (#11663) 2025-12-18 12:25:59 +00:00
hms ENH: update HMS for 22E 2025-10-28 15:30:02 +08:00
i18n Fix translations (#11282) 2025-11-05 17:51:50 +08:00
images Merge branch 'main' into libvgcode 2026-01-06 11:09:09 +08:00
info ENH: support E3D print parts display 2025-10-28 15:30:00 +08:00
printers FIX: fixed o1s wiki link redirection 2025-10-30 14:56:49 +08:00
profiles Snapmaker U1: switch wall_generator to arachne (#12121) 2026-02-01 00:10:09 +08:00
profiles_template Fix typo in filament_sbs_template.json (#11837) 2026-01-06 08:34:34 +00:00
shaders Merge remote-tracking branch 'upstream/main' into libvgcode 2025-11-15 11:11:20 -05:00
tooltip post changes after merging BS1.7.4 2023-08-26 18:45:43 +08:00
web Fix Setup Wizard stuck on "Loading..." on Wayland (#12159) 2026-02-03 23:10:17 +08:00
check_access_code.txt ENH:Update IP address input process 2023-02-01 16:24:44 +08:00
Icon.icns fix Mac icon 2023-09-08 00:41:23 +08:00