fix(linux): prevent startup panic from unrealized capsule GDK window | fix(linux): 修复胶囊窗口因 GDK 未实例化导致的启动崩溃

[yuanchenglu]

User description

Problem

OpenLess crashes on Linux X11 immediately at startup with:

Root Cause

The capsule window is defined in tauri.conf.json with visible: false + transparent: true. On Linux/GTK3, a hidden window never has its underlying GDK window realized. When capsule.set_ignore_cursor_events(true) is called during startup, tao internally calls window.window().unwrap() which returns None for the unrealized window — panic.

This is the same issue reported in:

• voicebox #680 / PR#837
• tao #635

Fix

Before calling set_ignore_cursor_events, move the window off-screen and call show() to force GDK window realization. The window is then repositioned correctly by the existing position_capsule_bottom_center() and hidden as normal.

The change is Linux-only (#[cfg(target_os = "linux")]) and confined to the capsule setup block; no other call sites are touched.

Testing

Verified on Deepin Linux 23 (X11, DDE/kwin_x11):

• Before: crashes 100% on startup
• After: app initializes normally, hotkey listeners register, tray icon appears, capsule shows/hides on speak

References

• voicebox PR#837 (same fix approach): Fix: Linux startup panic from unrealized dictate window (#680) jamiepine/voicebox#837

---

PR Type

Bug fix

---

Description

• Prevent Linux X11 crash when capsule window has visible: false + transparent: true

• Force GDK window realization via gtk_window.realize() before setting cursor passthrough

• Avoids window.window().unwrap() panic in tao’s Linux event loop

---

Diagram Walkthrough

flowchart LR
  A[Capsule window created with visible=false] --> B[gtk_window? Ok]
  B --> C[gtk_window.realize()]
  C --> D[set_ignore_cursor_events true]
  D --> E[Position capsule normally]
  B --> F[Err: skip cursor passthrough]

Loading

File Walkthrough

	Relevant files
Bug fix	lib.rs Force GDK window realization on Linux before input passthrough openless-all/app/src-tauri/src/lib.rs Added use gtk::prelude::WidgetExt; under #[cfg(target_os = "linux")] Before set_ignore_cursor_events, retrieve GTK window and call realize() to force GDK window creation Only execute cursor passthrough if GTK window is obtained successfully +24/-2
Dependencies	Cargo.toml Add gtk crate dependency for Linux build                                  openless-all/app/src-tauri/Cargo.toml Added gtk = "0.18" dependency for Linux target +1/-0

---

[github-actions]

PR Reviewer Guide 🔍

(Review updated until commit 641da39)

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 2 🔵🔵⚪⚪⚪

🧪 No relevant tests

🔒 No security concerns identified

⚡ No major issues detected

[github-actions]

Persistent review updated to latest commit 641da39