something-x-dev 1.8.2.dev26__tar.gz → 1.9.0.dev28__tar.gz

{something_x_dev-1.8.2.dev26 → something_x_dev-1.9.0.dev28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: something-x-dev
-Version: 1.8.2.dev26
+Version: 1.9.0.dev28
 Summary: Something X device manager for Omarchy / Linux
 Author: Raphael
 License: MIT

something_x_dev-1.9.0.dev28/ROADMAP.md

@@ -0,0 +1,107 @@
+# Something X — Roadmap
+
+---
+
+## Current release — v1.8
+
+### Shipped
+- [x] **GitHub Pages** — project landing page + full documentation site (`docs/`)
+- [x] **AUR package** — Arch users can install without pip
+- [x] **NixOS flake** — `flake.nix` for Nix users
+- [x] **`.desktop` file** — ships and auto-installs so the app appears in Walker/Rofi/GNOME launcher
+- [x] **Low battery notification** — `notify-send` when any bud drops below 20 %
+- [x] **Background mode** — closing the window hides it; relaunch shows it again (Gio single-instance)
+- [x] **Per-device profiles** — ANC + EQ saved per device address to `~/.config/something-x/profiles.json`, restored on reconnect
+- [x] **CLI quick-toggle** — `something-x --anc off|on|transparency`, `something-x --eq bass`, `something-x --battery`
+- [x] **System tray icon** — battery on hover via StatusNotifierItem (Waybar/SNI)
+- [x] **Wearing detection display** — L/R in-ear status shown on the earbud visual
+- [x] **Auto-connect RFCOMM** — connects as soon as BlueZ reports the device connected
+- [x] **Async BlueZ** — native `Gio` async D-Bus, no `dbus-python` dependency
+- [x] **Unit tests** — 65 tests covering CRC, protocol parsing, battery dedup, profiles, BluetoothManager
+- [x] **Debug mode** — `SOMETHING_X_DEBUG=1` dumps raw RFCOMM frames for contributors
+- [x] **Graceful ANC mode detection** — infer supported modes from RFCOMM response; hide unsupported buttons
+- [x] **Dynamic versioning** — version sourced from git tags at build time
+- [x] **Liquid glass dark UI** — overhauled aesthetic for the app window
+
+---
+
+## 1.9 — Quality of life
+
+### Features
+- [x] **Device nickname** — rename a paired device in the UI; stored in profiles
+- [x] **Profile import / export** — share `.json` profile files between machines or with other users
+- [ ] **Wear-detect MPRIS actions** — pause media when both buds are removed; resume when reinserted (opt-in)
+- [x] **Notification preferences** — per-event toggles (battery low, connect, disconnect) in settings
+- [x] **Theming** — user-selectable accent color and light/dark mode toggle; theme stored in config
+
+### Tech
+- [x] **Improved test coverage** — profiles round-trip, nickname, notify prefs, notification gating (91 tests total)
+
+---
+
+## 1.10 — Desktop integration
+
+### Features
+- [ ] **D-Bus API** — expose ANC, EQ, battery, and connect/disconnect over a session-bus interface so scripts and status bars can consume it without spawning a CLI process
+- [ ] **Global keybind support** — register a configurable shortcut (e.g. `Super+F1`) to cycle ANC modes without opening the window
+- [ ] **Quick-settings overlay** — small floating panel triggered by keybind or tray click; ANC toggle + battery at a glance
+- [ ] **Waybar module documentation** — sample `custom/somethingx` block wired to the D-Bus API
+
+---
+
+## 1.11 — Multi-device
+
+### Features
+- [ ] **Multiple devices simultaneously** — open a page per device, manage both at once without switching
+- [ ] **Battery overview** — compact summary card on the home page showing all connected devices and their battery levels
+
+---
+
+## 1.12 — EQ overhaul
+
+### Features
+- [ ] **Visual EQ graph** — interactive SVG/Cairo curve instead of preset pills
+- [ ] **Custom EQ presets** — per-band sliders, save with a user-defined name, stored in profiles
+- [ ] **Preset sharing** — export / import individual EQ presets as `.json`
+
+---
+
+## 1.13 — Protocol depth
+
+### Features
+- [ ] **Touch controls remapping** — reassign tap/hold actions if the protocol exposes it (command IDs found in APK, not yet wired up)
+- [ ] **Firmware version display** — read firmware string from RFCOMM and show it in the device page
+- [ ] **Firmware update check** — compare device firmware against latest known version, show a badge when outdated
+
+### Protocol / devices
+- [ ] **CMF Buds / Buds Pro validation** — confirm command IDs and ship explicit support
+- [ ] **Nothing Ear (1) / (a) / (stick) community testing** — collect field reports, fix edge cases
+- [ ] **Structured debug logger** — `SOMETHING_X_DEBUG=1` writes a structured `.jsonl` capture file for easier issue reproduction
+
+---
+
+## 1.14 — Additional devices
+
+### Features
+- [ ] **Nothing Ear (open) support** — ANC not applicable; validate battery and EQ commands
+- [ ] **CMF Watch support** — separate protocol; requires fresh APK reverse-engineering
+- [ ] **Nothing Phone glyph integration** — notification mirroring and glyph lighting (depends on BlueZ + glyph API availability)
+
+---
+
+## Long term / ideas
+
+These have no version target yet — they need either upstream work, a contributor, or significant scoping.
+
+- [ ] **GNOME Shell extension** — battery indicator in the GNOME top bar
+- [ ] **KDE Plasma widget** — same idea for KDE users
+- [ ] **macOS port** — replace BlueZ D-Bus with CoreBluetooth via `pyobjc` (long shot)
+- [ ] **Battery history graph** — plot battery level over time, persisted across sessions
+
+---
+
+## Won't do
+
+- **Windows** — no BlueZ; RFCOMM access requires a completely different stack
+- **Wayland screen capture control** — out of scope
+- **Streaming / media playback control** — MPRIS already handles this system-wide

{something_x_dev-1.8.2.dev26 → something_x_dev-1.9.0.dev28}/nothing_app/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '1.8.2.dev26'
-__version_tuple__ = version_tuple = (1, 8, 2, 'dev26')
+__version__ = version = '1.9.0.dev28'
+__version_tuple__ = version_tuple = (1, 9, 0, 'dev28')
 
 __commit_id__ = commit_id = None

{something_x_dev-1.8.2.dev26 → something_x_dev-1.9.0.dev28}/nothing_app/application.py

@@ -50,6 +50,9 @@ class SomethingXApplication(Adw.Application):
         self._splash: SplashScreen | None = None
         self._window: SomethingXWindow | None = None
         self._tray: SomethingXTray | None = None
+        self._theme_provider: Gtk.CssProvider | None = None
+        self._current_theme = None
+        self._theme_save_id: int | None = None
         self.connect("activate", self._on_activate)
 
     def _on_activate(self, _app):
@@ -61,6 +64,7 @@ class SomethingXApplication(Adw.Application):
         _install_desktop_file()
         Adw.StyleManager.get_default().set_color_scheme(Adw.ColorScheme.FORCE_DARK)
         self._load_css()
+        self._load_theme_css()
         self._bt = BluetoothManager()
         splash = SplashScreen(on_done=self._on_splash_done)
         splash.set_application(self)
@@ -72,6 +76,8 @@ class SomethingXApplication(Adw.Application):
         win = SomethingXWindow(bt_manager=self._bt, application=self)
         win.connect("close-request", self._on_window_close)
         self._window = win
+        if self._current_theme is not None:
+            win.set_opacity(max(0.05, min(1.0, self._current_theme.window_opacity)))
         self._tray = SomethingXTray(self._bt, on_show_window=win.present)
         win.present()
         if self._splash:
@@ -93,6 +99,49 @@ class SomethingXApplication(Adw.Application):
         )
         return True  # prevent default close/destroy
 
+    def _load_theme_css(self):
+        from . import theme as _theme_mod
+
+        self._current_theme = _theme_mod.load()
+        self._theme_provider = Gtk.CssProvider()
+        css = _theme_mod.generate_css(self._current_theme)
+        try:
+            self._theme_provider.load_from_string(css)
+        except AttributeError:
+            self._theme_provider.load_from_data(css.encode())
+
+        display = Gdk.Display.get_default()
+        if display:
+            Gtk.StyleContext.add_provider_for_display(
+                display,
+                self._theme_provider,
+                Gtk.STYLE_PROVIDER_PRIORITY_APPLICATION + 1,
+            )
+
+    def apply_theme(self, t):
+        from . import theme as _theme_mod
+
+        self._current_theme = t
+        css = _theme_mod.generate_css(t)
+        try:
+            self._theme_provider.load_from_string(css)
+        except AttributeError:
+            self._theme_provider.load_from_data(css.encode())
+
+        if self._window is not None:
+            self._window.set_opacity(max(0.05, min(1.0, t.window_opacity)))
+
+        if self._theme_save_id is not None:
+            GLib.source_remove(self._theme_save_id)
+        self._theme_save_id = GLib.timeout_add(500, self._flush_theme_save)
+
+    def _flush_theme_save(self):
+        from . import theme as _theme_mod
+
+        _theme_mod.save(self._current_theme)
+        self._theme_save_id = None
+        return False
+
     def _load_css(self):
         provider = Gtk.CssProvider()
         css = _css_path()

{something_x_dev-1.8.2.dev26 → something_x_dev-1.9.0.dev28}/nothing_app/pages/device.py

@@ -1,3 +1,4 @@
+import json
 import math
 import re
 import subprocess
@@ -8,10 +9,11 @@ import gi
 gi.require_version("Gtk", "4.0")
 gi.require_version("Pango", "1.0")
 gi.require_version("PangoCairo", "1.0")
-from gi.repository import Gtk, GLib, PangoCairo
+from gi.repository import Gtk, GLib, PangoCairo, Gio
 
 from ..bluetooth import BluetoothDevice, BluetoothManager
 from ..protocol import NothingDevice, ANCMode, EQ_PRESETS
+from .. import profiles
 
 
 def _mono_font() -> str:
@@ -487,12 +489,58 @@ class DevicePage(Gtk.Box):
 
         page.append(settings_group)
 
+        page.append(_section("NOTIFICATIONS"))
+
+        notif_group = Gtk.Box(orientation=Gtk.Orientation.VERTICAL, spacing=0)
+        notif_group.add_css_class("settings-group")
+        notif_group.set_margin_bottom(4)
+
+        notify_prefs = profiles.get_notify_prefs(self._bt_device.address)
+
+        self._notif_battery_switch = Gtk.Switch()
+        self._notif_battery_switch.set_active(notify_prefs.get("battery_low", True))
+        self._notif_battery_switch.set_valign(Gtk.Align.CENTER)
+        self._notif_battery_switch.connect("state-set", self._on_notif_battery_toggled)
+        notif_group.append(
+            _settings_row("Battery Low", "Alert when battery drops below 20%", self._notif_battery_switch)
+        )
+
+        self._notif_connect_switch = Gtk.Switch()
+        self._notif_connect_switch.set_active(notify_prefs.get("connect", True))
+        self._notif_connect_switch.set_valign(Gtk.Align.CENTER)
+        self._notif_connect_switch.connect("state-set", self._on_notif_connect_toggled)
+        notif_group.append(
+            _settings_row("Connected", "Alert when device connects", self._notif_connect_switch)
+        )
+
+        self._notif_disconnect_switch = Gtk.Switch()
+        self._notif_disconnect_switch.set_active(notify_prefs.get("disconnect", True))
+        self._notif_disconnect_switch.set_valign(Gtk.Align.CENTER)
+        self._notif_disconnect_switch.connect("state-set", self._on_notif_disconnect_toggled)
+        notif_group.append(
+            _settings_row("Disconnected", "Alert when device disconnects", self._notif_disconnect_switch)
+        )
+
+        page.append(notif_group)
+
         page.append(_section("DEVICE INFO"))
 
         info_group = Gtk.Box(orientation=Gtk.Orientation.VERTICAL, spacing=0)
         info_group.add_css_class("settings-group")
         info_group.set_margin_bottom(4)
 
+        nick_entry = Gtk.Entry()
+        nick_entry.set_hexpand(True)
+        nick_entry.set_valign(Gtk.Align.CENTER)
+        saved_nick = profiles.get_nickname(self._bt_device.address)
+        if saved_nick:
+            nick_entry.set_text(saved_nick)
+        nick_entry.set_placeholder_text(self._bt_device.name)
+        nick_entry.connect("activate", self._on_nickname_activate)
+        nick_entry.connect("notify::has-focus", self._on_nickname_focus_lost)
+        self._nick_entry = nick_entry
+        info_group.append(_settings_row("Nickname", right_widget=nick_entry))
+
         self._fw_label = Gtk.Label(label="—")
         self._fw_label.add_css_class("info-value")
         self._fw_label.set_xalign(1)
@@ -508,6 +556,23 @@ class DevicePage(Gtk.Box):
         addr_val.set_xalign(1)
         info_group.append(_settings_row("Address", right_widget=addr_val))
 
+        io_box = Gtk.Box(orientation=Gtk.Orientation.HORIZONTAL, spacing=8)
+        io_box.set_margin_top(4)
+
+        export_btn = Gtk.Button(label="Export Profile")
+        export_btn.add_css_class("settings-row-action")
+        export_btn.set_hexpand(True)
+        export_btn.connect("clicked", self._on_export_clicked)
+
+        import_btn = Gtk.Button(label="Import Profile")
+        import_btn.add_css_class("settings-row-action")
+        import_btn.set_hexpand(True)
+        import_btn.connect("clicked", self._on_import_clicked)
+
+        io_box.append(export_btn)
+        io_box.append(import_btn)
+        info_group.append(io_box)
+
         page.append(info_group)
 
         self._sync_anc_ui(ANCMode.OFF)
@@ -634,6 +699,95 @@ class DevicePage(Gtk.Box):
             else:
                 btn.remove_css_class("active")
 
+    def _save_nickname(self):
+        if not hasattr(self, "_nick_entry"):
+            return
+        text = self._nick_entry.get_text().strip()
+        profiles.set_nickname(self._bt_device.address, text or None)
+
+    def _on_nickname_activate(self, _entry):
+        self._save_nickname()
+
+    def _on_nickname_focus_lost(self, entry, _param):
+        if not entry.has_focus():
+            self._save_nickname()
+
+    def _on_notif_battery_toggled(self, _switch, state: bool):
+        profiles.set_notify_prefs(self._bt_device.address, {"battery_low": state})
+        return False
+
+    def _on_notif_connect_toggled(self, _switch, state: bool):
+        profiles.set_notify_prefs(self._bt_device.address, {"connect": state})
+        return False
+
+    def _on_notif_disconnect_toggled(self, _switch, state: bool):
+        profiles.set_notify_prefs(self._bt_device.address, {"disconnect": state})
+        return False
+
+    def _on_export_clicked(self, _btn):
+        dialog = Gtk.FileChooserNative(
+            title="Export Profile",
+            transient_for=self.get_root(),
+            action=Gtk.FileChooserAction.SAVE,
+        )
+        dialog.set_current_name(f"something-x-{self._bt_device.address.replace(':', '-')}.json")
+        dialog.connect("response", self._on_export_response, dialog)
+        dialog.show()
+
+    def _on_export_response(self, _dialog, response: int, dialog: Gtk.FileChooserNative):
+        if response != Gtk.ResponseType.ACCEPT:
+            return
+        gfile = dialog.get_file()
+        if not gfile:
+            return
+        path = gfile.get_path()
+        data = profiles.export_profile(self._bt_device.address)
+        try:
+            with open(path, "w") as f:
+                json.dump(data, f, indent=2)
+        except Exception as exc:
+            print(f"[device] export failed: {exc}")
+
+    def _on_import_clicked(self, _btn):
+        dialog = Gtk.FileChooserNative(
+            title="Import Profile",
+            transient_for=self.get_root(),
+            action=Gtk.FileChooserAction.OPEN,
+        )
+        filt = Gtk.FileFilter()
+        filt.set_name("JSON files")
+        filt.add_mime_type("application/json")
+        filt.add_pattern("*.json")
+        dialog.add_filter(filt)
+        dialog.connect("response", self._on_import_response, dialog)
+        dialog.show()
+
+    def _on_import_response(self, _dialog, response: int, dialog: Gtk.FileChooserNative):
+        if response != Gtk.ResponseType.ACCEPT:
+            return
+        gfile = dialog.get_file()
+        if not gfile:
+            return
+        path = gfile.get_path()
+        try:
+            with open(path) as f:
+                data = json.load(f)
+            profiles.import_profile(self._bt_device.address, data)
+            self._reload_notif_switches()
+            if hasattr(self, "_nick_entry"):
+                nick = profiles.get_nickname(self._bt_device.address)
+                self._nick_entry.set_text(nick or "")
+        except Exception as exc:
+            print(f"[device] import failed: {exc}")
+
+    def _reload_notif_switches(self):
+        if not hasattr(self, "_notif_battery_switch"):
+            return
+        prefs = profiles.get_notify_prefs(self._bt_device.address)
+        self._notif_battery_switch.set_active(prefs.get("battery_low", True))
+        self._notif_connect_switch.set_active(prefs.get("connect", True))
+        self._notif_disconnect_switch.set_active(prefs.get("disconnect", True))
+
     def _on_anc_clicked(self, _btn, mode: int):
         self._sync_anc_ui(mode)
         if self._nothing_dev: