feat: Enhance Linux support for screen sharing and dependencies

docs/linux-display-server.md

@@ -0,0 +1,149 @@
+# Linux Display Server Configuration
+
+Rocket.Chat Desktop automatically detects and uses the best display server (Wayland or X11) for your system. If the app detects GPU issues during startup, it automatically switches to a compatible mode.
+
+## Default Behavior
+
+| Package Type | Display Server | Notes |
+|--------------|---------------|-------|
+| **deb/rpm** | Auto-detect | Uses Wayland if available, falls back to X11 |
+| **Snap** | Auto-detect | Uses Wayland if available, falls back to X11 |
+| **AppImage** | Auto-detect | Uses Wayland if available, falls back to X11 |
+
+## Automatic GPU Crash Recovery
+
+Rocket.Chat Desktop includes automatic GPU crash detection and recovery:
+
+1. **Crash Detection**: If the GPU process crashes during startup (e.g., due to incompatible drivers), the app detects this automatically.
+
+2. **Automatic Fallback**: After detecting crashes, the app saves a fallback mode and relaunches with X11 forced.
+
+3. **Persistent Setting**: The fallback mode is remembered across restarts, preventing repeated crashes.
+
+4. **User Control**: You can view and reset the fallback mode in Settings > General > Display Server Mode.
+
+## Wayland Support
+
+Rocket.Chat Desktop includes native Wayland support with:
+- PipeWire screen capture for video calls
+- Native OS screen picker integration
+- Hardware acceleration
+
+### Requirements for Wayland
+- `xdg-desktop-portal` (recommended, auto-suggested by deb/rpm packages)
+- `xdg-desktop-portal-gtk` or desktop-specific portal backend
+- PipeWire for screen sharing
+- Modern GPU drivers
+
+## Known Issues
+
+### Virtual Machines
+VMs with paravirtual graphics (QXL, VirtualBox, VMware) may have issues with Wayland GPU acceleration.
+
+**Symptoms:**
+```text
+ERROR:viz_main_impl.cc:189] Exiting GPU process due to errors during initialization
+```
+
+**Automatic Recovery:** The app automatically detects this crash and switches to X11 mode. You should see the app restart and work normally after the first crash.
+
+**Manual Solution:** If auto-recovery doesn't work, force X11 mode:
+```bash
+rocketchat-desktop --ozone-platform=x11
+```
+
+**Settings Option:** Go to Settings > General > Display Server Mode and select "Force X11".
+
+### Screen Sharing Not Working on Wayland
+
+If screen sharing doesn't work on Wayland:
+
+1. Install portal dependencies:
+```bash
+# Ubuntu/Debian
+sudo apt install xdg-desktop-portal xdg-desktop-portal-gtk pipewire
+
+# Fedora
+sudo dnf install xdg-desktop-portal xdg-desktop-portal-gtk pipewire
+
+# Arch
+sudo pacman -S xdg-desktop-portal xdg-desktop-portal-gtk pipewire
+```
+
+2. Restart your session or reboot
+
+3. Verify PipeWire is running:
+```bash
+systemctl --user status pipewire
+```
+
+## Manual Override
+
+You can force a specific display server:
+
+```bash
+# Force X11
+rocketchat-desktop --ozone-platform=x11
+
+# Force Wayland (if system supports it)
+rocketchat-desktop --ozone-platform=wayland
+```
+
+## Troubleshooting
+
+### Check Your Display Server
+```bash
+echo $XDG_SESSION_TYPE
+# Output: "wayland" or "x11"
+```
+
+### Check GPU Support
+```bash
+# Check graphics card
+lspci | grep -i vga
+
+# Check VA-API support (hardware video decode)
+vainfo
+```
+
+### Enable Verbose Logging
+
+These are standard Chromium flags that enable detailed logging output:
+
+```bash
+rocketchat-desktop --enable-logging --v=1
+```
+
+### Disable GPU Acceleration (last resort)
+```bash
+rocketchat-desktop --disable-gpu
+```
+
+## Resetting Display Server Mode
+
+If the app auto-switched to X11 and you want to try Wayland again (e.g., after updating GPU drivers):
+
+1. Open the app (it will run in X11 mode)
+2. Go to Settings > General
+3. Find "Display Server Mode"
+4. Select "Auto-detect (Wayland/X11)"
+5. The app will restart and attempt Wayland
+
+If the GPU crashes again, the app will automatically switch back to X11.
+
+## Best Practices
+
+- **Real Hardware + Wayland**: Use default (auto-detection) for best experience
+- **VM + Wayland**: The app will auto-detect and switch to X11 after first crash
+- **X11 Session**: No configuration needed, works automatically
+- **Snap Package**: Uses auto-detection like other package types
+
+## Reporting Issues
+
+When reporting display server issues, include:
+
+1. Display server type: `echo $XDG_SESSION_TYPE`
+2. Graphics card: `lspci | grep -i vga`
+3. Distribution: `cat /etc/os-release`
+4. Package type: snap/deb/rpm/AppImage
+5. Full error output with `--enable-logging --v=1`

electron-builder.json

@@ -133,17 +133,26 @@
   "deb": {
     "fpm": [
       "--after-install=build/linux/postinst.sh"
+    ],
+    "recommends": [
+      "xdg-desktop-portal",
+      "xdg-desktop-portal-gtk"
     ]
   },
   "rpm": {
-    "fpm": ["--rpm-rpmbuild-define=_build_id_links none"]
+    "fpm": [
+      "--rpm-rpmbuild-define=_build_id_links none",
+      "--rpm-tag=Recommends: xdg-desktop-portal",
+      "--rpm-tag=Recommends: xdg-desktop-portal-gtk"
+    ]
   },
   "snap": {
     "plugs": [
       "desktop",
       "desktop-legacy",
       "home",
       "x11",
+      "wayland",
       "unity7",
       "browser-support",
       "network",
@@ -154,9 +163,9 @@
       "audio-playback",
       "audio-record",
       "screen-inhibit-control",
-      "upower-observe"
-    ],
-    "executableArgs": ["--ozone-platform=x11"]
+      "upower-observe",
+      "pipewire"
+    ]
   },
   "afterSign": "./build/notarize.js",
   "generateUpdatesFilesForAllChannels": true,

package.json

@@ -6,7 +6,7 @@
   "productName": "Rocket.Chat",
   "name": "rocketchat",
   "description": "Official OSX, Windows, and Linux Desktop Clients for Rocket.Chat",
-  "version": "4.10.1",
+  "version": "4.10.2",
   "author": "Rocket.Chat Support <support@rocket.chat>",
   "copyright": "© 2016-2025, Rocket.Chat",
   "homepage": "https://rocket.chat",

rollup.config.mjs

@@ -34,7 +34,27 @@
         proc ? 'Restarting main process...' : 'Starting main process...'
       );
 
-      proc = spawn(electron, ['.'], { stdio: 'inherit' });
+      const electronArgs = ['.'];
+
+      // Linux-specific flags for development
+      if (process.platform === 'linux') {
+        electronArgs.push('--no-sandbox');
+
+        // Auto-detect Wayland and use X11 fallback for stability
+        // XDG_SESSION_TYPE is set by the display manager
+        const isWaylandSession = process.env.XDG_SESSION_TYPE === 'wayland';
+
+        if (process.env.FORCE_WAYLAND === 'true') {
+          // User explicitly wants native Wayland
+          electronArgs.push('--ozone-platform=wayland');
+        } else if (process.env.FORCE_X11 === 'true' || isWaylandSession) {
+          // Use X11: either forced or auto-detected Wayland session
+          // Wayland sessions often have GPU issues in VMs, X11 is more stable
+          electronArgs.push('--ozone-platform=x11');
+        }
+      }
+
+      proc = spawn(electron, electronArgs, { stdio: 'inherit' });
 
       proc.on('close', () => {
         proc = null;

scripts/README.md

@@ -0,0 +1,139 @@
+# Testing Scripts
+
+This directory contains automation scripts for testing Rocket.Chat Desktop on Linux.
+
+## Scripts
+
+### `install-volta.sh`
+
+Installs Volta (JavaScript toolchain manager) if it's not already installed. Volta provides node.js and npm, which are required for building the project.
+
+#### Usage
+
+```bash
+# Interactive mode (prompts before installing)
+./scripts/install-volta.sh
+
+# Non-interactive mode (installs automatically)
+./scripts/install-volta.sh --non-interactive
+```
+
+#### What It Does
+
+1. **Checks if Volta is installed**
+   - Looks for `volta` command in PATH
+   - Checks `$VOLTA_HOME` environment variable
+   - Checks common installation location (`~/.volta/bin/volta`)
+
+2. **Installs Volta if missing**
+   - Downloads and runs the official Volta installer
+   - Adds Volta to PATH for current session
+   - Adds Volta to `~/.bashrc` for future sessions
+
+3. **Verifies installation**
+   - Checks that `volta` command is available
+   - Displays Volta version
+
+#### Features
+
+- Can be sourced by other scripts to use its functions
+- Non-interactive mode for CI/automation
+- Automatically adds Volta to shell profile
+- Safe to run multiple times (skips if already installed)
+
+#### Requirements
+
+- `curl` (for downloading Volta installer)
+- Internet connection
+
+### `linux-test-deb.sh`
+
+Builds, installs, and runs the Rocket.Chat Desktop .deb package for testing purposes.
+
+#### Usage
+
+```bash
+./scripts/linux-test-deb.sh [OPTIONS]
+```
+
+#### Options
+
+- `--skip-build` - Skip building the .deb package (useful if you've already built it)
+- `--skip-install` - Skip installing the .deb package (useful for testing installation separately)
+- `--skip-run` - Skip running the installed app (useful if you just want to install)
+- `--help`, `-h` - Show help message
+
+#### Examples
+
+Build, install, and run:
+```bash
+./scripts/linux-test-deb.sh
+```
+
+Skip build if .deb already exists:
+```bash
+./scripts/linux-test-deb.sh --skip-build
+```
+
+Only build and install, don't run:
+```bash
+./scripts/linux-test-deb.sh --skip-run
+```
+
+#### What It Does
+
+1. **Builds the .deb package**
+   - Runs `yarn build-linux` to build the app and create Linux packages
+   - Outputs to `dist/` directory
+
+2. **Finds the .deb file**
+   - Searches for `dist/rocketchat-*-linux-*.deb`
+   - Uses the first matching file found
+
+3. **Installs the .deb package**
+   - Uninstalls any previous version if present
+   - Installs the new package using `dpkg -i`
+   - Automatically fixes missing dependencies with `apt-get install -f`
+
+4. **Runs the installed app**
+   - Launches Rocket.Chat Desktop from `/opt/Rocket.Chat/rocketchat-desktop`
+   - Runs in background and displays the process ID
+
+#### Requirements
+
+- Linux operating system
+- `node.js` and `yarn` (or Volta - the script will install it automatically if needed)
+- `dpkg` and `apt-get` (standard on Debian/Ubuntu systems)
+- `curl` (for installing Volta if needed)
+- Sudo access (for installation, if not running as root)
+
+#### Automatic Dependency Installation
+
+The script automatically installs missing dependencies:
+- **Volta** (if node.js/yarn not found) - provides node.js and npm
+- **binutils** (if `ar` command not found) - required for building .deb packages
+- **Package dependencies** - automatically resolved during .deb installation
+
+#### Output
+
+The script provides color-coded output:
+- 🔵 Blue: Informational messages
+- 🟢 Green: Success messages
+- 🟡 Yellow: Warnings
+- 🔴 Red: Errors
+
+#### Error Handling
+
+The script will exit with a non-zero status code if any step fails. Common issues:
+
+- **Build fails**: Check that all dependencies are installed (`yarn install`)
+- **Install fails**: Ensure you have sudo access and the .deb file is valid
+- **App not found**: The installation path may differ; check `/opt/Rocket.Chat/` or use `which rocketchat-desktop`
+
+#### Notes
+
+- The script automatically handles uninstalling previous versions
+- Missing dependencies are automatically resolved during installation
+- The app runs in the background; use `kill <PID>` to stop it
+- This script is intended for development/testing purposes only
+