Minimise to system tray on close

Closing the window now hides the app to the system tray (like Teams)
and it keeps running in the background. The tray icon restores the
window on click and offers Open / Quit. Quit fully exits and stops the
Bluetooth service. Falls back to normal close if no tray is available.

https://claude.ai/code/session_014KrpftzUgVFGFXVUU3DUTT

Author: claude

src/nothing_ear/ui/main_window.py

@@ -2,17 +2,23 @@
 
 from __future__ import annotations
 
+from pathlib import Path
+
 from PySide6.QtCore import Qt, QObject, Signal
+from PySide6.QtGui import QAction, QIcon
 from PySide6.QtWidgets import (
+    QApplication,
     QFrame,
     QHBoxLayout,
     QLabel,
     QListWidget,
     QListWidgetItem,
     QMainWindow,
+    QMenu,
     QProgressBar,
     QPushButton,
     QSizePolicy,
+    QSystemTrayIcon,
     QTabWidget,
     QVBoxLayout,
     QWidget,
@@ -24,6 +30,15 @@
 from .eq_tab import EqTab
 from .style import STYLESHEET
 
+_ICON_PATH = Path(__file__).resolve().parent.parent / "assets" / "icon.svg"
+
+
+class _Bridge(QObject):
+    """Marshals background-thread updates onto the Qt event loop."""
+
+    devicesChanged = Signal(list)
+    errorOccurred = Signal(str)
+
 
 class _Bridge(QObject):
     """Marshals background-thread updates onto the Qt event loop."""
@@ -43,6 +58,13 @@ def __init__(self, mock: bool = False):
         self._devices: list[BtDevice] = []
         self._primary_path: str | None = None
         self._last_signature: tuple | None = None
+        self._force_quit = False
+        self._tray: QSystemTrayIcon | None = None
+        self._tray_notified = False
+
+        self._app_icon = QIcon(str(_ICON_PATH)) if _ICON_PATH.exists() else QIcon()
+        if not self._app_icon.isNull():
+            self.setWindowIcon(self._app_icon)
 
         self._bridge = _Bridge()
         self._bridge.devicesChanged.connect(self._on_devices)
@@ -64,8 +86,46 @@ def on_update(devices, error):
             self._service = BlueZService(on_update)
 
         self._build_ui()
+        self._setup_tray()
         self._service.start()
 
+    def _setup_tray(self) -> None:
+        if not QSystemTrayIcon.isSystemTrayAvailable():
+            return
+        tray = QSystemTrayIcon(self._app_icon, self)
+        tray.setToolTip("NothingX Desktop")
+
+        menu = QMenu()
+        open_action = QAction("Open", self)
+        open_action.triggered.connect(self._show_window)
+        quit_action = QAction("Quit", self)
+        quit_action.triggered.connect(self._quit)
+        menu.addAction(open_action)
+        menu.addSeparator()
+        menu.addAction(quit_action)
+
+        tray.setContextMenu(menu)
+        tray.activated.connect(self._on_tray_activated)
+        tray.show()
+        self._tray = tray
+        QApplication.instance().setQuitOnLastWindowClosed(False)
+
+    def _on_tray_activated(self, reason) -> None:
+        if reason in (QSystemTrayIcon.Trigger, QSystemTrayIcon.DoubleClick):
+            self._show_window()
+
+    def _show_window(self) -> None:
+        self.showNormal()
+        self.raise_()
+        self.activateWindow()
+
+    def _quit(self) -> None:
+        self._force_quit = True
+        self._service.stop()
+        if self._tray is not None:
+            self._tray.hide()
+        QApplication.instance().quit()
+
     def _build_ui(self) -> None:
         root = QWidget()
         layout = QVBoxLayout(root)
@@ -251,5 +311,17 @@ def _on_error(self, message: str) -> None:
         self._status.setText(f"⚠ {message}")
 
     def closeEvent(self, event) -> None:
+        if self._tray is not None and not self._force_quit:
+            event.ignore()
+            self.hide()
+            if not self._tray_notified:
+                self._tray.showMessage(
+                    "NothingX Desktop",
+                    "Still running in the tray. Right-click the icon to quit.",
+                    self._app_icon,
+                    3000,
+                )
+                self._tray_notified = True
+            return
         self._service.stop()
         super().closeEvent(event)