Skip to content

fix: Linux AppImage Wayland EGL startup#405

Merged
LucaRonin merged 52 commits intorefactoringhq:mainfrom
hhungxun:fix/linux-appimage-wayland-egl
Apr 29, 2026
Merged

fix: Linux AppImage Wayland EGL startup#405
LucaRonin merged 52 commits intorefactoringhq:mainfrom
hhungxun:fix/linux-appimage-wayland-egl

Conversation

@hhungxun
Copy link
Copy Markdown
Contributor

@hhungxun hhungxun commented Apr 28, 2026

Summary

  • Re-exec Linux AppImage launches on Wayland with the first available system libwayland-client.so in LD_PRELOAD when the user has not already set a preload.
  • Preserve existing AppImage WebKitGTK startup safeguards and explicit user environment overrides.
  • Document the EGL startup failure and manual workaround for AppImage users.

Root Cause

On some GNOME Wayland systems, the AppImage can load Wayland/EGL-related libraries in an order that prevents GTK/WebKit from creating the default EGL display. The reported workaround was to preload the system Wayland client library before launching Tolaria.

Validation

  • cargo fmt --manifest-path src-tauri/Cargo.toml --check
  • cargo test --manifest-path src-tauri/Cargo.toml linux_appimage
  • cargo clippy --manifest-path src-tauri/Cargo.toml --tests -- -D warnings
  • pnpm lint
  • npx tsc --noEmit
  • pnpm exec vitest run src/App.test.tsx --silent
  • full pre-commit hook with VITEST_MAX_WORKERS=1: 283 files, 3354 tests passed

@hhungxun hhungxun marked this pull request as ready for review April 28, 2026 16:07
@hhungxun hhungxun changed the title Fix Linux AppImage Wayland EGL startup fix: Linux AppImage Wayland EGL startup Apr 28, 2026
github-actions Bot added 26 commits April 28, 2026 16:43
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.

2 participants