Fix Setup Wizard stuck on "Loading..." on Wayland #895

New Issue

MrUnknownDE · 2026-04-05T16:34:13+02:00

MrUnknownDE commented

2026-04-05 16:34:13 +02:00

Originally created by @SoftFever on 2/3/2026

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:

Set WEBKIT_DISABLE_COMPOSITING_MODE=1 environment variable to force software rendering for WebKit2GTK - this is the same fix used by BambuStudio
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)

---update---
Duplicated effort with #7591
Based on the test results, it seems we don’t need to disable WEBKIT_DISABLE_DMABUF_RENDERER. Keep as is for now

Fixes #3479
Fixes #4132
Fixes #4935
Fixes #7581

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

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
On X11 session:
- Same test as above to verify no regression
Verify env var is set:
- Check that WEBKIT_DISABLE_COMPOSITING_MODE=1 is in the process environment on Linux builds

*Originally created by @SoftFever on 2/3/2026* # 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) ---update--- Duplicated effort with #7591 Based on the test results, it seems we don’t need to disable `WEBKIT_DISABLE_DMABUF_RENDERER`. Keep as is for now Fixes #3479 Fixes #4132 Fixes #4935 Fixes #7581 # 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

MrUnknownDE closed this issue

2026-04-05 16:34:13 +02:00

Sign in to join this conversation.

No Label

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github/OrcaSlicer#895