Merge pull request #80 from open-webui/main

v0.0.3: fix spotlight focus after page interaction, fix ?q= query pas…

Author: tjbck

CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.3] - 2026-04-06
+
+### Fixed
+
+- **Spotlight Focus** — Spotlight now reliably appears after interacting with the main window or webview (fixed blur-during-show race condition on macOS)
+- **Spotlight Query Passthrough** — The `?q=` search parameter from spotlight now correctly navigates already-open webviews instead of being silently ignored
+
 ## [0.0.2] - 2026-04-06
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-webui",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "license": "AGPL-3.0",
   "description": "Open WebUI Desktop",
   "main": "./out/main/index.js",

src/main/index.ts

@@ -180,6 +180,7 @@ function createSpotlightWindow(): BrowserWindow {
     resizable: false,
     hasShadow: false,
     show: false,
+    focusable: true,
     icon: path.join(__dirname, 'assets/icon.png'),
     webPreferences: {
       preload: join(__dirname, '../preload/spotlight-preload.js'),
@@ -206,8 +207,21 @@ function createSpotlightWindow(): BrowserWindow {
     }
   })
 
+  // Hide on blur — but only when the window was truly visible and settled.
+  // Without the guard the blur fires during the show→focus transition and
+  // the window disappears immediately (especially when the user had been
+  // interacting with the main window / webview).
+  let blurArmed = false
+  spotlightWindow.on('focus', () => {
+    blurArmed = false
+    setTimeout(() => {
+      blurArmed = true
+    }, 200)
+  })
   spotlightWindow.on('blur', () => {
-    spotlightWindow?.hide()
+    if (blurArmed) {
+      spotlightWindow?.hide()
+    }
   })
 
   spotlightWindow.on('closed', () => {
@@ -217,26 +231,42 @@ function createSpotlightWindow(): BrowserWindow {
   return spotlightWindow
 }
 
+function showAndFocusSpotlight(win: BrowserWindow): void {
+  // On macOS the app may not be the "active" application when the global
+  // shortcut fires (e.g. user clicked into a webview which is a separate
+  // render process).  Calling app.focus() first ensures macOS brings the
+  // app to the foreground so the subsequent window.focus() actually works.
+  if (process.platform === 'darwin') {
+    app.focus({ steal: true })
+  }
+
+  // Restore to saved position, or default if none saved
+  if (spotlightPosition) {
+    win.setPosition(spotlightPosition.x, spotlightPosition.y)
+  } else {
+    const pos = getDefaultSpotlightPosition()
+    win.setPosition(pos.x, pos.y)
+  }
+
+  win.show()
+  win.focus()
+
+  // Tell the renderer to focus the input field (belt-and-suspenders —
+  // the renderer also listens for the 'focus' window event)
+  win.webContents.focus()
+}
+
 function toggleSpotlight(): void {
   if (spotlightWindow && !spotlightWindow.isDestroyed()) {
     if (spotlightWindow.isVisible()) {
       spotlightWindow.hide()
     } else {
-      // Restore to saved position, or default if none saved
-      if (spotlightPosition) {
-        spotlightWindow.setPosition(spotlightPosition.x, spotlightPosition.y)
-      } else {
-        const pos = getDefaultSpotlightPosition()
-        spotlightWindow.setPosition(pos.x, pos.y)
-      }
-      spotlightWindow.show()
-      spotlightWindow.focus()
+      showAndFocusSpotlight(spotlightWindow)
     }
   } else {
     const win = createSpotlightWindow()
     win.once('ready-to-show', () => {
-      win.show()
-      win.focus()
+      showAndFocusSpotlight(win)
     })
   }
 }

src/renderer/src/lib/components/Main/Connections.svelte

@@ -306,10 +306,32 @@
     window.electronAPI.onData((data: any) => {
       if (data.type === 'connection:open' && data.data?.url) {
         const connId = data.data.connectionId ?? ''
-        openConnections.set(connId, data.data.url)
+        const incomingUrl = data.data.url
+        const alreadyOpen = openConnections.has(connId)
+
+        openConnections.set(connId, incomingUrl)
         openConnections = new Map(openConnections)
-        connectedUrl = data.data.url
+        connectedUrl = incomingUrl
         activeConnectionId = connId
+
+        // If the webview for this connection already exists in the DOM,
+        // updating the map value won't cause it to re-navigate (Electron
+        // webview `src` changes on an existing element are ignored). We
+        // need to explicitly call loadURL so that e.g. the spotlight ?q=
+        // parameter actually reaches the Open WebUI instance.
+        if (alreadyOpen) {
+          requestAnimationFrame(() => {
+            const container = document.querySelector('.content-webview-container')
+            if (!container) return
+            const wv = container.querySelector(
+              `webview[partition="persist:connection-${connId}"]`
+            ) as any
+            if (wv?.loadURL) {
+              wv.loadURL(incomingUrl)
+            }
+          })
+        }
+
         // Don't switch to connected view during active install — the install
         // flow handles its own transition after confirming reachability.
         if (installPhase !== 'working') {