something-x-dev 1.2.3.dev1__py3-none-any.whl

nothing_app/splash.py

@@ -0,0 +1,181 @@
+import math
+import time
+import cairo
+import gi
+
+gi.require_version("Gtk", "4.0")
+gi.require_version("Adw", "1")
+from gi.repository import Gtk, Adw, GLib
+
+
+_DURATION_MS = 2300
+
+
+def _ease_out(t: float) -> float:
+    return 1.0 - (1.0 - t) ** 3
+
+
+def _ease_in_out(t: float) -> float:
+    if t < 0.5:
+        return 4 * t * t * t
+    p = -2 * t + 2
+    return 1 - p * p * p / 2
+
+
+def _p(t: float, start: float, end: float) -> float:
+    if t <= start:
+        return 0.0
+    if t >= end:
+        return 1.0
+    return (t - start) / (end - start)
+
+
+class SplashScreen(Adw.Window):
+    def __init__(self, on_done):
+        super().__init__()
+        self._on_done = on_done
+        self._start: float | None = None
+        self._done = False
+
+        self.set_default_size(420, 780)
+        self.set_resizable(False)
+        self.set_decorated(False)
+        self.add_css_class("splash-window")
+
+        area = Gtk.DrawingArea()
+        area.set_draw_func(self._draw)
+        area.set_hexpand(True)
+        area.set_vexpand(True)
+        self.set_content(area)
+        self._area = area
+
+    def start(self):
+        self._start = time.monotonic()
+        GLib.timeout_add(16, self._frame)
+
+    def _frame(self) -> bool:
+        if self._done:
+            return False
+        elapsed = (time.monotonic() - self._start) * 1000
+        self._area.queue_draw()
+        if elapsed >= _DURATION_MS + 80:
+            self._done = True
+            GLib.idle_add(self._on_done)
+            return False
+        return True
+
+    def _draw(self, _area, cr, width, height):
+        if self._start is None:
+            cr.set_source_rgb(0, 0, 0)
+            cr.paint()
+            return
+
+        t = (time.monotonic() - self._start) * 1000
+        cx, cy = width / 2, height / 2
+
+        cr.set_source_rgb(0, 0, 0)
+        cr.paint()
+
+        # global fade out 1750 → 2300ms
+        fade = 1.0 - _ease_in_out(_p(t, 1750, 2300))
+        if fade < 0.004:
+            return
+
+        dot_cy = cy - 62
+        title_y = cy + 4
+        sub_y = cy + 38
+
+        # ── red dot ──────────────────────────────────────────────────────────
+        dot_in = _ease_out(_p(t, 0, 380))
+        if dot_in > 0:
+            pulse = 1.0 + math.sin(t / 380 * math.pi * 2) * 0.18
+            glow_r = 22 * pulse
+            rg = cairo.RadialGradient(cx, dot_cy, 0, cx, dot_cy, glow_r)
+            rg.add_color_stop_rgba(0, 0.91, 0.21, 0.21, 0.32 * dot_in * fade)
+            rg.add_color_stop_rgba(1, 0.91, 0.21, 0.21, 0)
+            cr.set_source(rg)
+            cr.arc(cx, dot_cy, glow_r, 0, 2 * math.pi)
+            cr.fill()
+
+            cr.set_source_rgba(0.91, 0.21, 0.21, dot_in * fade)
+            cr.arc(cx, dot_cy, 4.5 * dot_in, 0, 2 * math.pi)
+            cr.fill()
+
+        # ── ripple rings ─────────────────────────────────────────────────────
+        for i, delay in enumerate((0, 190, 380)):
+            rp = _p(t, 80 + delay, 900 + delay)
+            if 0 < rp < 1:
+                r = 5 + _ease_out(rp) * 85
+                alpha = ((1 - rp) ** 1.4) * (0.55 - i * 0.12) * fade
+                cr.set_source_rgba(0.91, 0.21, 0.21, alpha)
+                cr.set_line_width(1.0 + (1 - rp) * 0.6)
+                cr.arc(cx, dot_cy, r, 0, 2 * math.pi)
+                cr.stroke()
+
+        # ── "SOMETHING X" typewriter ─────────────────────────────────────────
+        title = "SOMETHING X"
+        n_visible = min(int(_p(t, 450, 1020) * (len(title) + 1)), len(title))
+
+        cr.select_font_face("JetBrains Mono", cairo.FontSlant.NORMAL, cairo.FontWeight.BOLD)
+        cr.set_font_size(32)
+
+        # stable centering from full string measurement
+        full_te = cr.text_extents(title)
+        px = cx - full_te.width / 2 - full_te.x_bearing
+
+        for i, ch in enumerate(title[:n_visible]):
+            is_x = ch == "X" and i == len(title) - 1
+            r, g, b = (0.91, 0.21, 0.21) if is_x else (1.0, 1.0, 1.0)
+            cr.set_source_rgba(r, g, b, fade)
+            te = cr.text_extents(ch)
+            cr.move_to(px - te.x_bearing, title_y)
+            cr.show_text(ch)
+            px += te.x_advance
+
+        # cursor: blinks after typing (400ms cycle), gone after 1600ms
+        cursor_visible = n_visible < len(title) or (
+            t < 1600 and int((_p(t, 1020, 1600) * 1000) / 420) % 2 == 0
+        )
+        if cursor_visible:
+            cr.set_source_rgba(0.91, 0.21, 0.21, 0.85 * fade)
+            cr.rectangle(px + 3, title_y - 27, 2, 31)
+            cr.fill()
+
+        # ── "FOR LINUX" with letter-spacing ──────────────────────────────────
+        sub_p = _ease_out(_p(t, 880, 1200)) * fade
+        if sub_p > 0.004:
+            cr.select_font_face("JetBrains Mono", cairo.FontSlant.NORMAL, cairo.FontWeight.NORMAL)
+            cr.set_font_size(11)
+            sub = "FOR LINUX"
+            spacing = 5.5
+            advances = [cr.text_extents(ch).x_advance for ch in sub]
+            total_w = sum(advances) + spacing * (len(sub) - 1)
+            lx = cx - total_w / 2
+            for ch, adv in zip(sub, advances, strict=True):
+                te = cr.text_extents(ch)
+                cr.set_source_rgba(1.0, 1.0, 1.0, 0.32 * sub_p)
+                cr.move_to(lx - te.x_bearing, sub_y)
+                cr.show_text(ch)
+                lx += adv + spacing
+
+        # ── thin horizontal rule under subtitle ──────────────────────────────
+        rule_p = _ease_out(_p(t, 1050, 1350)) * fade
+        if rule_p > 0.004:
+            rule_y = sub_y + 18
+            rule_half = 28 * rule_p
+            cr.set_source_rgba(0.91, 0.21, 0.21, 0.22 * rule_p)
+            cr.set_line_width(1)
+            cr.move_to(cx - rule_half, rule_y)
+            cr.line_to(cx + rule_half, rule_y)
+            cr.stroke()
+
+        # ── bottom caption ────────────────────────────────────────────────────
+        cap_p = _ease_out(_p(t, 1150, 1500)) * fade
+        if cap_p > 0.004:
+            cr.select_font_face("JetBrains Mono", cairo.FontSlant.NORMAL, cairo.FontWeight.NORMAL)
+            cr.set_font_size(8)
+            cap = "OPEN SOURCE  ·  MADE FOR OMARCHY"
+            te = cr.text_extents(cap)
+            cr.set_source_rgba(1.0, 1.0, 1.0, 0.09 * cap_p)
+            cr.move_to(cx - te.width / 2 - te.x_bearing, height - 52)
+            cr.show_text(cap)

nothing_app/window.py

@@ -0,0 +1,89 @@
+import gi
+
+gi.require_version("Gtk", "4.0")
+gi.require_version("Adw", "1")
+from gi.repository import Gtk, Adw
+
+from .bluetooth import BluetoothDevice, BluetoothManager
+from .pages.home import HomePage
+from .pages.device import DevicePage
+
+
+class SomethingXWindow(Adw.ApplicationWindow):
+    def __init__(self, bt_manager: BluetoothManager, **kwargs):
+        super().__init__(**kwargs)
+        self.set_default_size(420, 780)
+        self.set_resizable(True)
+        self._bt = bt_manager
+        self._build()
+
+    def _build(self):
+        nav = Adw.NavigationView()
+        self.set_content(nav)
+        self._nav = nav
+        nav.push(self._make_home_nav_page())
+
+    def _make_home_nav_page(self) -> Adw.NavigationPage:
+        nav_page = Adw.NavigationPage()
+        nav_page.set_tag("home")
+        nav_page.set_title("Something X")
+
+        toolbar_view = Adw.ToolbarView()
+
+        header = Adw.HeaderBar()
+        header.add_css_class("nothing-header")
+        header.set_show_title(True)
+
+        bt_btn = Gtk.Button.new_from_icon_name("bluetooth-symbolic")
+        bt_btn.set_tooltip_text("Bluetooth settings")
+        bt_btn.connect("clicked", self._open_bt_settings)
+        header.pack_end(bt_btn)
+
+        refresh_btn = Gtk.Button.new_from_icon_name("view-refresh-symbolic")
+        refresh_btn.set_tooltip_text("Refresh devices")
+        refresh_btn.connect("clicked", lambda _: self._bt.refresh())
+        header.pack_end(refresh_btn)
+
+        toolbar_view.add_top_bar(header)
+
+        home_page = HomePage(bt_manager=self._bt)
+        home_page.connect("device-selected", self._on_device_selected)
+        toolbar_view.set_content(home_page)
+
+        nav_page.set_child(toolbar_view)
+        return nav_page
+
+    def _make_device_nav_page(self, bt_device: BluetoothDevice) -> Adw.NavigationPage:
+        nav_page = Adw.NavigationPage()
+        nav_page.set_tag("device")
+        nav_page.set_title(bt_device.name)
+
+        toolbar_view = Adw.ToolbarView()
+
+        header = Adw.HeaderBar()
+        header.add_css_class("nothing-header")
+        toolbar_view.add_top_bar(header)
+
+        device_page = DevicePage(bt_device=bt_device, bt_manager=self._bt)
+        toolbar_view.set_content(device_page)
+
+        nav_page.set_child(toolbar_view)
+        nav_page.connect("hidden", lambda _: device_page.cleanup())
+        return nav_page
+
+    def _on_device_selected(self, _home, bt_device: BluetoothDevice):
+        self._nav.push(self._make_device_nav_page(bt_device))
+
+    def _open_bt_settings(self, _btn):
+        import subprocess
+
+        for cmd in (
+            ["blueman-manager"],
+            ["gnome-control-center", "bluetooth"],
+            ["xdg-open", "settings://bluetooth"],
+        ):
+            try:
+                subprocess.Popen(cmd, start_new_session=True)
+                return
+            except FileNotFoundError:
+                continue

something_x_dev-1.2.3.dev1.dist-info/METADATA

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: something-x-dev
+Version: 1.2.3.dev1
+Summary: Something X device manager for Omarchy / Linux
+Author: Raphael
+License: MIT
+Keywords: nothing,bluetooth,gtk4,linux,omarchy,ear
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: X11 Applications :: GTK
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PyGObject>=3.42
+Requires-Dist: dbus-python>=1.3
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+# Something X — for Linux
+
+> A Linux-native companion app for **Nothing** and **CMF** Bluetooth devices.  
+> Built for [Omarchy](https://omarchy.org) (Hyprland / Wayland) — pure black, JetBrains Mono, Nothing Red.
+
+```
+  ●  SOMETHING X
+     FOR LINUX
+```
+
+[![PyPI](https://img.shields.io/pypi/v/something-x)](https://pypi.org/project/something-x/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-red.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-Linux-blue)](https://github.com/SoaOaoS/something-x)
+
+---
+
+## Features
+
+- **Animated splash screen** — Nothing-branded intro with typewriter effect and ripple rings
+- **Earbud visual** — Cairo-rendered glowing battery rings with radial gradients for L / R / Case
+- **ANC control** — Off · Noise Cancellation · Transparency (real RFCOMM protocol)
+- **EQ presets** — Balanced · More Bass · More Treble · Voice
+- **Volume slider** — controls the PulseAudio/PipeWire A2DP sink directly
+- **Per-device profiles** — ANC and EQ saved per device, restored automatically on reconnect
+- **Background mode** — closing the window keeps the app running; relaunch to reopen
+- **CLI quick-toggles** — control your earbuds without opening the GUI (see [CLI usage](#cli-usage))
+- **Low battery notifications** — `notify-send` alert when any bud drops below 20 %
+- **Firmware version & serial number** — read from the device over RFCOMM
+- **In-ear detection toggle**
+- **Device discovery** — BlueZ D-Bus; Nothing/CMF devices highlighted with a badge
+- **Scan for new devices** — 30 s BlueZ discovery window
+- **Glass morphism UI** — pure black base, frosted glass cards, red gradient accents
+
+---
+
+## Device support
+
+| Device | Discovery | Battery | ANC | EQ | Volume | Firmware |
+|---|---|---|---|---|---|---|
+| Nothing Ear (1) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Nothing Ear (2) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Nothing Ear (a) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Nothing Ear (stick) | ✅ | ✅ | — | ✅ | ✅ | ✅ |
+| CMF Buds / Buds Pro | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| Nothing Phone (1/2) | ✅ | — | — | — | — | — |
+| Other BT devices | ✅ | ✅* | — | — | ✅ | — |
+
+\* via BlueZ `Battery1` interface · RFCOMM features require the device to be connected
+
+---
+
+## Requirements
+
+### System packages (Arch / Omarchy)
+
+```bash
+sudo pacman -S python-gobject python-dbus python-cairo gtk4 libadwaita
+```
+
+| Package | Purpose |
+|---|---|
+| `python-gobject` | GTK4, libadwaita, GLib bindings |
+| `python-dbus` | BlueZ D-Bus access |
+| `python-cairo` | Cairo drawing (earbud visual, splash) |
+| `gtk4` | UI toolkit |
+| `libadwaita` | Navigation, dark theme |
+
+> `pactl` (from `libpulse` / `pipewire-pulse`) is used for volume control — already present on any PulseAudio/PipeWire system.
+
+---
+
+## Installation
+
+### Recommended — pip (after system packages above)
+
+```bash
+pip install something-x
+something-x
+```
+
+### Run from source
+
+```bash
+git clone https://github.com/SoaOaoS/something-x
+cd something-x
+./somethingx
+```
+
+### Desktop launcher (Walker / Rofi / app menu)
+
+```bash
+cp nothing_app/data/com.something.x.omarchy.desktop ~/.local/share/applications/
+update-desktop-database ~/.local/share/applications/
+```
+
+---
+
+## Usage
+
+```
+./somethingx        # from source
+something-x         # if installed via pip
+```
+
+1. **Splash** — animated intro, main window opens after ~2.3 s
+2. **Home** — all paired BT devices; Nothing/CMF get a `NOTHING` badge
+3. **Scan** — "SCAN FOR DEVICES" runs 30 s BlueZ discovery
+4. **Device page** — tap a card to open controls:
+   - Battery rings (L / R / Case) update in real time
+   - ANC and EQ apply immediately over RFCOMM; settings saved automatically
+   - Volume slider controls the A2DP sink via `pactl`
+   - Firmware and serial number shown after connection
+5. **Disconnect** — red button sends a clean BlueZ disconnect
+6. **Close** — hides to background; run `something-x` again to reopen
+
+---
+
+## CLI usage
+
+After connecting to a device at least once via the GUI, you can control it from the terminal:
+
+```bash
+something-x --battery                    # print battery levels
+something-x --anc off|on|transparency   # set ANC mode
+something-x --eq balanced|bass|treble|voice  # set EQ preset
+something-x --anc on --eq bass          # combine actions
+something-x --device AA:BB:CC:DD:EE:FF --battery  # target a specific device
+```
+
+---
+
+## Releases & versioning
+
+This project uses **Conventional Commits**. Pushing to `main` triggers automatic versioning and a PyPI release:
+
+| Commit prefix | Version bump | Example |
+|---|---|---|
+| `feat!:` / `BREAKING CHANGE` | Major (`x.0.0`) | `feat!: new protocol engine` |
+| `feat:` | Minor (`1.x.0`) | `feat: add Ear (open) support` |
+| `fix:` / `perf:` / `refactor:` | Patch (`1.0.x`) | `fix: ANC off not applying` |
+| `docs:` / `chore:` / `style:` / `ci:` | — (no release) | `chore: update readme` |
+
+---
+
+## Architecture
+
+```
+nothing_app/
+├── application.py      Adw.Application — CSS, dark theme, splash, background mode, CLI
+├── splash.py           Animated splash screen (Cairo, typewriter, ripples)
+├── window.py           AdwNavigationView — home ↔ device routing
+├── bluetooth.py        BlueZ D-Bus manager (discovery, connect/disconnect signals)
+├── protocol.py         Nothing Ear RFCOMM 0x55 binary protocol (reverse-engineered)
+├── profiles.py         Per-device ANC/EQ profile persistence (~/.config/something-x/)
+├── data/
+│   └── style.css       Nothing X glass-morphism CSS theme
+└── pages/
+    ├── home.py         Device list + scan button
+    └── device.py       ANC / EQ / volume / settings + Cairo earbud visual
+```
+
+### Protocol notes
+
+Frame format: `[SOF=0x55][ctrl:2 LE][cmd:2 LE][len:2 LE][FSN:1][payload][crc16:2 LE]`
+
+All outgoing frames use `ctrl=0x0160` with CRC16-ARC — the device silently drops SET commands if any frame in the session was sent without CRC.
+
+---
+
+## Contributing
+
+The RFCOMM protocol in [nothing_app/protocol.py](nothing_app/protocol.py) is reverse-engineered from the official Android APK. If your device uses different command IDs or channel numbers, patches are very welcome.
+
+---
+
+## License
+
+MIT

something_x_dev-1.2.3.dev1.dist-info/RECORD

@@ -0,0 +1,19 @@
+nothing_app/__init__.py,sha256=Z68l9J3zMyCa6M1dmudJgClgEwEuUyxETe9C5bv24XY,57
+nothing_app/application.py,sha256=4o9hDtpwtPA8NOz63ZW7c6KOa9UeHjqXizoVIjTdUy8,7444
+nothing_app/bluetooth.py,sha256=pfwfU-7oxZRCRFtDN8goBqMEgET_eWW0NS9lp1pTEac,7609
+nothing_app/profiles.py,sha256=eop3-VXnjkmvlAmIxPlE7CWiS3OxHiQKruCDGiEgXqk,1088
+nothing_app/protocol.py,sha256=MNeBw2VkZClAdKf0BCN11ZdP7eQ4-JBXDl6T8pjomdA,25813
+nothing_app/splash.py,sha256=8GhwQ4F2B9tsxu23VpragjLgxdMKVsg3ZQIlzRC2dY8,6811
+nothing_app/window.py,sha256=saH4pTR8eKAVB_z9Y7rP-AWkKnAZjEfDY9O2h2_hbWU,2885
+nothing_app/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nothing_app/data/com.something.x.omarchy.desktop,sha256=Uet1FGwgMDvHlejxNuhR8cTWNrYEqnJlTvipl2ztFp8,362
+nothing_app/data/style.css,sha256=I-IlEidE8hY6lC18gmPkNNAytEAsYxmxWrs6RG5jHkc,16214
+nothing_app/pages/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nothing_app/pages/device.py,sha256=mN5FU9vX4oELyq8aYuCkujmtfBg7okHLkM3LYA59gnk,21309
+nothing_app/pages/home.py,sha256=2Mg7HleCM8qcg9giHM2FSPoKc1o6an_fNhVP4wxiI-0,7563
+something_x_dev-1.2.3.dev1.dist-info/licenses/LICENSE,sha256=f82aGY-Qd4Huw5T9EsynF6CJhVPdcnsTSuuaskxc1ak,1064
+something_x_dev-1.2.3.dev1.dist-info/METADATA,sha256=qCMu2wXCpkBKekfG8LaopzewR98wxStrp7iUU-6Me20,7019
+something_x_dev-1.2.3.dev1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+something_x_dev-1.2.3.dev1.dist-info/entry_points.txt,sha256=1GFpyZMwyA0nk1swIfywPADzWXZ4wd0o0N4mIDB5R1I,61
+something_x_dev-1.2.3.dev1.dist-info/top_level.txt,sha256=yERYCJXvIBXR40iWxixVVZI3z-B4gNYXEdXFiiWa7KI,12
+something_x_dev-1.2.3.dev1.dist-info/RECORD,,

something_x_dev-1.2.3.dev1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

something_x_dev-1.2.3.dev1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+something-x = nothing_app.application:main

something_x_dev-1.2.3.dev1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SoaOaoS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

something_x_dev-1.2.3.dev1.dist-info/top_level.txt

@@ -0,0 +1 @@
+nothing_app