refactor(gpuFallback): Enhance Wayland handling and logging for X11 fallback

- Introduced a check for Wayland sessions in handleLinuxDisplayServer to default to XWayland for stability, addressing potential GPU issues on virtual machines.
- Updated logging messages to clarify the use of XWayland when a Wayland session is detected, improving user guidance on display server settings.
- Removed redundant Wayland session checks from performElectronStartup, streamlining the GPU fallback logic.

Author: jeanfbrito

src/app/main/app.ts

@@ -215,11 +215,7 @@ export const performElectronStartup = (): void => {
     // Read GPU fallback mode (may have been set by previous GPU crash or user setting)
     const gpuFallbackMode = readGpuFallbackMode();
 
-    // Detect Wayland session
-    const sessionType = process.env.XDG_SESSION_TYPE;
-    const isWaylandSession = sessionType === 'wayland';
-
-    // Apply display server mode based on settings and environment
+    // Apply display server mode based on settings
     if (gpuFallbackMode === 'x11') {
       console.log('Display server mode: forcing X11');
       app.commandLine.appendSwitch('ozone-platform', 'x11');
@@ -230,14 +226,9 @@ export const performElectronStartup = (): void => {
       console.log('Display server mode: GPU disabled');
       app.disableHardwareAcceleration();
       app.commandLine.appendSwitch('disable-gpu');
-    } else if (gpuFallbackMode === 'none' && isWaylandSession) {
-      // On Wayland sessions, default to X11 to avoid GPU initialization issues
-      // Users can set gpuFallbackMode to 'wayland' in settings to use native Wayland
-      console.log(
-        'Wayland session detected, using X11 fallback for stability (XDG_SESSION_TYPE=wayland)'
-      );
-      app.commandLine.appendSwitch('ozone-platform', 'x11');
     }
+    // Note: 'none' mode on Wayland is handled by handleLinuxDisplayServer() in main.ts
+    // which relaunches with --ozone-platform=x11 before Electron initializes
   }
 };
 

src/main.ts

@@ -79,16 +79,26 @@ const handleLinuxDisplayServer = (): void => {
   // Determine if we need to relaunch with X11 flag
   let needsX11 = false;
 
+  const isWaylandSession = process.env.XDG_SESSION_TYPE === 'wayland';
+
   if (gpuFallbackMode === 'x11') {
     needsX11 = true;
   } else if (gpuFallbackMode === 'wayland') {
     // User explicitly wants native Wayland, don't add X11 flag
     needsX11 = false;
+  } else if (gpuFallbackMode === 'none' && isWaylandSession) {
+    // Default to XWayland on Wayland sessions for stability.
+    // Native Wayland can hang on VMs/systems with GPU issues.
+    // Users can opt-in to native Wayland via Settings > General > Display Server Mode.
+    // XWayland remains available even on Wayland-only distros (Fedora 43+).
+    needsX11 = true;
   }
-  // If gpuFallbackMode is 'none', try native mode and let crash handler decide
 
   if (needsX11) {
-    console.log('GPU fallback mode set to X11, relaunching with X11');
+    console.log(
+      'Wayland detected, using XWayland for stability. To use native Wayland, change Display Server Mode in Settings.',
+      { gpuFallbackMode, isWaylandSession }
+    );
     relaunchApp('--ozone-platform=x11');
   }
 };