Add Settings page and persist preferences locally

New Settings tab with an option to control close behaviour (minimise to
tray vs quit), saved to ~/.config/nothingx-desktop/settings.json. The
window honours the setting on close.

https://claude.ai/code/session_014KrpftzUgVFGFXVUU3DUTT

Author: claude

src/nothing_ear/config.py

@@ -0,0 +1,53 @@
+"""Local persisted settings, stored as JSON under the user's config dir."""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+
+_DEFAULTS = {
+    "minimize_to_tray": True,
+}
+
+
+def _config_path() -> Path:
+    base = os.environ.get("XDG_CONFIG_HOME") or os.path.join(Path.home(), ".config")
+    return Path(base) / "nothingx-desktop" / "settings.json"
+
+
+class Settings:
+    def __init__(self) -> None:
+        self._path = _config_path()
+        self._data = dict(_DEFAULTS)
+        self.load()
+
+    @property
+    def path(self) -> str:
+        return str(self._path)
+
+    def load(self) -> None:
+        try:
+            with open(self._path, encoding="utf-8") as handle:
+                stored = json.load(handle)
+            if isinstance(stored, dict):
+                for key in _DEFAULTS:
+                    if key in stored:
+                        self._data[key] = stored[key]
+        except Exception:
+            pass
+
+    def save(self) -> None:
+        try:
+            self._path.parent.mkdir(parents=True, exist_ok=True)
+            with open(self._path, "w", encoding="utf-8") as handle:
+                json.dump(self._data, handle, indent=2)
+        except Exception:
+            pass
+
+    def get(self, key: str):
+        return self._data.get(key, _DEFAULTS.get(key))
+
+    def set(self, key: str, value) -> None:
+        self._data[key] = value
+        self.save()

src/nothing_ear/ui/main_window.py

@@ -26,8 +26,10 @@
 
 from .. import __version__
 from ..bluetooth import BtDevice
+from ..config import Settings
 from .anc_tab import AncTab
 from .eq_tab import EqTab
+from .settings_tab import SettingsTab
 from .style import STYLESHEET
 
 _ICON_PATH = Path(__file__).resolve().parent.parent / "assets" / "icon.svg"
@@ -55,6 +57,7 @@ def __init__(self, mock: bool = False):
         self.setStyleSheet(STYLESHEET)
 
         self._mock = mock
+        self._settings = Settings()
         self._devices: list[BtDevice] = []
         self._primary_path: str | None = None
         self._last_signature: tuple | None = None
@@ -121,10 +124,7 @@ def _show_window(self) -> None:
 
     def _quit(self) -> None:
         self._force_quit = True
-        self._service.stop()
-        if self._tray is not None:
-            self._tray.hide()
-        QApplication.instance().quit()
+        self.close()
 
     def _build_ui(self) -> None:
         root = QWidget()
@@ -214,6 +214,7 @@ def _build_tabs(self) -> QWidget:
         tabs.addTab(self._anc_tab, "ANC")
         self._eq_tab = EqTab(mock=self._mock)
         tabs.addTab(self._eq_tab, "EQ")
+        tabs.addTab(SettingsTab(self._settings), "Settings")
 
         return tabs
 
@@ -311,7 +312,12 @@ 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:
+        minimize = (
+            self._tray is not None
+            and bool(self._settings.get("minimize_to_tray"))
+            and not self._force_quit
+        )
+        if minimize:
             event.ignore()
             self.hide()
             if not self._tray_notified:
@@ -324,4 +330,7 @@ def closeEvent(self, event) -> None:
                 self._tray_notified = True
             return
         self._service.stop()
+        if self._tray is not None:
+            self._tray.hide()
         super().closeEvent(event)
+        QApplication.instance().quit()

src/nothing_ear/ui/settings_tab.py

@@ -0,0 +1,72 @@
+"""Settings tab: app preferences persisted to a local config file."""
+
+from __future__ import annotations
+
+from PySide6.QtWidgets import (
+    QCheckBox,
+    QFrame,
+    QLabel,
+    QVBoxLayout,
+    QWidget,
+)
+
+from .. import __version__
+from ..config import Settings
+
+
+class SettingsTab(QWidget):
+    def __init__(self, settings: Settings) -> None:
+        super().__init__()
+        self._settings = settings
+        self._build()
+
+    def _build(self) -> None:
+        root = QVBoxLayout(self)
+        root.setContentsMargins(0, 16, 0, 0)
+        root.setSpacing(14)
+
+        window_card = QFrame()
+        window_card.setObjectName("card")
+        wv = QVBoxLayout(window_card)
+        wv.setContentsMargins(18, 18, 18, 18)
+        wv.setSpacing(8)
+
+        wtitle = QLabel("Window")
+        wtitle.setObjectName("sectionTitle")
+        wv.addWidget(wtitle)
+
+        self._tray_checkbox = QCheckBox("Minimise to tray when closing the window")
+        self._tray_checkbox.setChecked(bool(self._settings.get("minimize_to_tray")))
+        self._tray_checkbox.toggled.connect(self._on_tray_toggled)
+        wv.addWidget(self._tray_checkbox)
+
+        hint = QLabel("When off, closing the window quits the app instead of keeping it running in the tray.")
+        hint.setObjectName("deviceMeta")
+        hint.setWordWrap(True)
+        wv.addWidget(hint)
+
+        root.addWidget(window_card)
+
+        about_card = QFrame()
+        about_card.setObjectName("card")
+        av = QVBoxLayout(about_card)
+        av.setContentsMargins(18, 18, 18, 18)
+        av.setSpacing(6)
+
+        atitle = QLabel("About")
+        atitle.setObjectName("sectionTitle")
+        av.addWidget(atitle)
+        av.addWidget(self._meta(f"NothingX Desktop · v{__version__}"))
+        av.addWidget(self._meta(f"Settings file: {self._settings.path}"))
+
+        root.addWidget(about_card)
+        root.addStretch(1)
+
+    def _meta(self, text: str) -> QLabel:
+        label = QLabel(text)
+        label.setObjectName("deviceMeta")
+        label.setWordWrap(True)
+        return label
+
+    def _on_tray_toggled(self, checked: bool) -> None:
+        self._settings.set("minimize_to_tray", bool(checked))

src/nothing_ear/ui/style.py

@@ -121,6 +121,19 @@
     border-radius: 8px;
 }
 
+QCheckBox { spacing: 10px; color: #f5f5f5; }
+QCheckBox::indicator {
+    width: 20px;
+    height: 20px;
+    border: 1px solid #3a3a3a;
+    border-radius: 6px;
+    background: #161616;
+}
+QCheckBox::indicator:checked {
+    background: #ffffff;
+    border-color: #ffffff;
+}
+
 QDialog { background-color: #0d0d0d; }
 
 QScrollArea { border: none; background: transparent; }