something-x-dev 1.7.0.dev15__tar.gz → 1.7.1.dev15__tar.gz

something_x_dev-1.7.1.dev15/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @SoaOaoS

something_x_dev-1.7.1.dev15/.github/workflows/ci.yml

@@ -0,0 +1,64 @@
+name: CI
+
+on:
+  push:
+    branches-ignore: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+  pull-requests: write  # needed for reviewdog to post inline comments
+
+jobs:
+  lint:
+    name: Lint & format
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Setup reviewdog
+        uses: reviewdog/action-setup@v1
+        with:
+          reviewdog_version: latest
+
+      # Posts inline review comments on the PR diff for every ruff finding
+      - name: Lint with reviewdog
+        run: ruff check --output-format rdjson nothing_app/ | reviewdog -f=rdjson -reporter=github-pr-review -fail-on-error
+        env:
+          REVIEWDOG_GITHUB_API_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      # Still fail the job if formatting is wrong
+      - name: Check formatting
+        run: ruff format --check nothing_app/
+
+  test:
+    name: Unit tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update -q
+          sudo apt-get install -y python3-gi python3-gi-cairo gir1.2-gtk-4.0 libgirepository1.0-dev
+
+      # Use a venv that inherits system site-packages so apt-installed gi is visible.
+      # PyGObject cannot be pip-built without Cairo/GLib headers; use the distro package.
+      - name: Create venv with system site-packages
+        run: python3 -m venv --system-site-packages .venv
+
+      - name: Install test dependencies
+        run: .venv/bin/pip install pytest pytest-cov
+
+      - name: Run tests
+        run: .venv/bin/pytest --tb=short --cov=nothing_app --cov-report=term-missing

something_x_dev-1.7.1.dev15/.github/workflows/release-dev.yml

@@ -0,0 +1,97 @@
+name: Release Dev
+
+on:
+  push:
+    branches: [develop]
+
+permissions:
+  contents: write
+  id-token: write  # for PyPI OIDC trusted publishing
+
+jobs:
+  release-dev:
+    runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      # ── Get version from setuptools-scm ────────────────────────────────
+      # After tag v1.7.0, develop automatically produces 1.7.1.devN
+      - name: Get dev version
+        id: version
+        run: |
+          pip install setuptools-scm
+          DEV_VERSION=$(python3 -m setuptools_scm)
+          SHORT_SHA=$(git rev-parse --short HEAD)
+          echo "dev_version=$DEV_VERSION" >> $GITHUB_OUTPUT
+          echo "short_sha=$SHORT_SHA"     >> $GITHUB_OUTPUT
+          echo "Dev version: $DEV_VERSION (sha: $SHORT_SHA)"
+
+      # ── Patch package name for dev channel ─────────────────────────────
+      - name: Patch package name
+        run: |
+          sed -i 's/^name\s*=\s*"something-x"/name            = "something-x-dev"/' pyproject.toml
+          sed -i 's/^something-x = /something-x-dev = /' pyproject.toml
+          grep -E "^name|something-x" pyproject.toml
+
+      # ── Build wheel + sdist ─────────────────────────────────────────────
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build distribution
+        run: |
+          pip install build
+          python -m build
+          ls dist/
+
+      # ── Generate changelog with git-cliff ──────────────────────────────
+      - name: Install git-cliff
+        run: pip install git-cliff
+
+      - name: Generate pre-release notes
+        run: |
+          git cliff --unreleased --strip all 2>/dev/null > /tmp/cliff_body.md
+          if [ ! -s /tmp/cliff_body.md ]; then
+            echo "No user-facing changes since last release." > /tmp/cliff_body.md
+          fi
+
+          cat > /tmp/release_notes.md <<HEADER
+          ## something-x-dev ${{ steps.version.outputs.dev_version }}
+
+          > Pre-release build from \`develop\` — not for production use.
+
+          **Commit**: \`${{ steps.version.outputs.short_sha }}\`
+
+          ### Changes since last stable release
+
+          HEADER
+          cat /tmp/cliff_body.md >> /tmp/release_notes.md
+          cat >> /tmp/release_notes.md <<'FOOTER'
+
+          ### Install
+
+          ```bash
+          pip install something-x-dev==${{ steps.version.outputs.dev_version }}
+
+          # Or download the wheel below
+          pip install something_x_dev-${{ steps.version.outputs.dev_version }}-py3-none-any.whl
+          ```
+          FOOTER
+
+      # ── GitHub pre-release ──────────────────────────────────────────────
+      - name: Create GitHub pre-release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: "dev-${{ steps.version.outputs.short_sha }}"
+          prerelease: true
+          body_path: /tmp/release_notes.md
+          files: dist/*
+
+      # ── Publish to PyPI (OIDC — requires trusted publisher configured) ──
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

something_x_dev-1.7.1.dev15/.github/workflows/release.yml

@@ -0,0 +1,190 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  id-token: write  # for PyPI OIDC trusted publishing
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.RELEASE_PAT }}
+
+      # ── Determine version bump from conventional commit ─────────────────
+      - name: Parse commit and bump version
+        id: version
+        run: |
+          COMMIT_MSG=$(git log -1 --pretty=%B)
+          echo "Commit: $COMMIT_MSG"
+
+          # Read current version from last vX.Y.Z tag (not pyproject.toml)
+          CURRENT=$(git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null | sed 's/^v//')
+          if [ -z "$CURRENT" ]; then
+            CURRENT="0.0.0"
+          fi
+          echo "Current version (last tag): $CURRENT"
+
+          MAJOR=$(echo $CURRENT | cut -d. -f1)
+          MINOR=$(echo $CURRENT | cut -d. -f2)
+          PATCH=$(echo $CURRENT | cut -d. -f3)
+
+          if echo "$COMMIT_MSG" | grep -qE "(^(feat|fix|refactor|perf)!:)|(BREAKING CHANGE:)"; then
+            BUMP=major
+            MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0
+          elif echo "$COMMIT_MSG" | grep -qE "^feat(\([^)]+\))?:"; then
+            BUMP=minor
+            MINOR=$((MINOR + 1)); PATCH=0
+          elif echo "$COMMIT_MSG" | grep -qE "^(fix|perf|refactor)(\([^)]+\))?:"; then
+            BUMP=patch
+            PATCH=$((PATCH + 1))
+          else
+            echo "Commit type does not trigger a release (docs/chore/style/ci/test). Skipping."
+            echo "skip=true" >> $GITHUB_OUTPUT
+            exit 0
+          fi
+
+          NEW="$MAJOR.$MINOR.$PATCH"
+          echo "Bump: $BUMP  →  $CURRENT → $NEW"
+          echo "current=$CURRENT" >> $GITHUB_OUTPUT
+          echo "new=$NEW"         >> $GITHUB_OUTPUT
+          echo "bump=$BUMP"       >> $GITHUB_OUTPUT
+          echo "skip=false"       >> $GITHUB_OUTPUT
+
+      # ── Tag and push (no pyproject.toml commit needed) ──────────────────
+      - name: Create and push release tag
+        if: steps.version.outputs.skip != 'true'
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag "v${{ steps.version.outputs.new }}"
+          git push origin "v${{ steps.version.outputs.new }}"
+
+      # ── Generate changelog with git-cliff ──────────────────────────────
+      - name: Install git-cliff
+        if: steps.version.outputs.skip != 'true'
+        run: pip install git-cliff
+
+      - name: Generate release notes
+        if: steps.version.outputs.skip != 'true'
+        run: |
+          # --latest: commits from the previous vX.Y.Z tag up to the tag we just pushed
+          # cliff.toml: skips merge commits, ignores dev-* tags, filters to conventional commits
+          git cliff --latest --strip all 2>/dev/null > /tmp/cliff_body.md
+          if [ ! -s /tmp/cliff_body.md ]; then
+            echo "No user-facing changes in this release." > /tmp/cliff_body.md
+          fi
+
+          # Prepend the header + install block; cliff body goes in the middle
+          cat > /tmp/release_notes.md <<HEADER
+          ## Something X v${{ steps.version.outputs.new }}
+
+          HEADER
+          cat /tmp/cliff_body.md >> /tmp/release_notes.md
+          cat >> /tmp/release_notes.md <<'FOOTER'
+
+          ### Install
+
+          ```bash
+          # Arch / Omarchy (recommended)
+          sudo pacman -S python-gobject python-dbus python-cairo gtk4 libadwaita
+          pip install something-x==${{ steps.version.outputs.new }}
+
+          # Or download the wheel below
+          pip install something_x-${{ steps.version.outputs.new }}-py3-none-any.whl
+          ```
+          FOOTER
+
+          echo "--- Release notes preview ---"
+          cat /tmp/release_notes.md
+
+      # ── Build wheel + sdist ─────────────────────────────────────────────
+      - name: Set up Python
+        if: steps.version.outputs.skip != 'true'
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build distribution
+        if: steps.version.outputs.skip != 'true'
+        run: |
+          pip install build
+          python -m build
+          ls dist/
+
+      # ── Generate changelog with git-cliff ──────────────────────────────
+      - name: Install git-cliff
+        if: steps.version.outputs.skip != 'true'
+        run: pip install git-cliff
+
+      - name: Generate release notes
+        if: steps.version.outputs.skip != 'true'
+        run: |
+          git cliff --latest --strip all 2>/dev/null > /tmp/cliff_body.md
+          if [ ! -s /tmp/cliff_body.md ]; then
+            echo "No user-facing changes in this release." > /tmp/cliff_body.md
+          fi
+
+          cat > /tmp/release_notes.md <<HEADER
+          ## Something X v${{ steps.version.outputs.new }}
+
+          HEADER
+          cat /tmp/cliff_body.md >> /tmp/release_notes.md
+          cat >> /tmp/release_notes.md <<'FOOTER'
+
+          ### Install
+
+          ```bash
+          # Arch / Omarchy (recommended)
+          sudo pacman -S python-gobject python-cairo gtk4 libadwaita
+          pip install something-x==${{ steps.version.outputs.new }}
+
+          # Or download the wheel below
+          pip install something_x-${{ steps.version.outputs.new }}-py3-none-any.whl
+          ```
+          FOOTER
+
+      # ── GitHub Release ──────────────────────────────────────────────────
+      - name: Create GitHub Release
+        if: steps.version.outputs.skip != 'true'
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: "v${{ steps.version.outputs.new }}"
+          body_path: /tmp/release_notes.md
+          files: dist/*
+
+      # ── Publish to PyPI (OIDC trusted publisher) ────────────────────────
+      - name: Publish to PyPI
+        if: steps.version.outputs.skip != 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      # ── Update AUR package ──────────────────────────────────────────────
+      - name: Update PKGBUILD and push to AUR
+        if: steps.version.outputs.skip != 'true'
+        env:
+          NEW_VERSION: ${{ steps.version.outputs.new }}
+        run: |
+          SHA256=$(sha256sum dist/something_x-${NEW_VERSION}.tar.gz | awk '{print $1}')
+          sed -i "s/^pkgver=.*/pkgver=${NEW_VERSION}/" PKGBUILD
+          sed -i "s/^pkgrel=.*/pkgrel=1/" PKGBUILD
+          sed -i "s/sha256sums=('[^']*')/sha256sums=('${SHA256}')/" PKGBUILD
+
+      - name: Deploy to AUR
+        if: steps.version.outputs.skip != 'true'
+        uses: KSXGitHub/github-actions-deploy-aur@v3.0.1
+        with:
+          pkgname: something-x
+          pkgbuild: ./PKGBUILD
+          commit_username: github-actions[bot]
+          commit_email: github-actions[bot]@users.noreply.github.com
+          ssh_private_key: ${{ secrets.AUR_SSH_PRIVATE_KEY }}
+          commit_message: "Update to ${{ steps.version.outputs.new }}"
+          allow_empty_commits: false

something_x_dev-1.7.1.dev15/.gitignore

@@ -0,0 +1,46 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.so
+*.egg
+*.egg-info/
+.eggs/
+MANIFEST
+
+# Build / distribution
+dist/
+build/
+*.whl
+*.tar.gz
+
+# Virtualenvs
+.venv/
+venv/
+env/
+.env
+ENV/
+
+# Tools
+.cache/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# setuptools-scm generated version file (written at install/build time)
+nothing_app/_version.py
+
+# APK reverse-engineering artifacts (local research only)
+*apkm*
+apkm_decompiled/
+apkm_extracted/

something_x_dev-1.7.1.dev15/DEVICES.md

@@ -0,0 +1,37 @@
+# Something X — Device & Platform Compatibility
+
+---
+
+## Supported devices
+
+The RFCOMM `0x55` protocol is shared across the entire Nothing Ear lineup. Confirmed working on **Nothing Ear (2)**; the same activation sequence, ANC wire values, and EQ command IDs are present in the APK for all models listed below.
+
+| Device | Protocol confirmed | Community reports |
+|---|---|---|
+| Nothing Ear (2) | ✅ reverse-engineered from APK | ✅ |
+| Nothing Ear (1) | ✅ same APK protocol class | needs field testing |
+| Nothing Ear (a) | ✅ same APK protocol class | needs field testing |
+| Nothing Ear (stick) | ✅ (no ANC cmd) | needs field testing |
+| CMF Buds / Buds Pro | ⚠️ likely same, different cmd IDs possible | needs field testing |
+| Nothing Ear (open) | ❓ ANC not applicable | not yet tested |
+| CMF Watch | ❓ different protocol expected | not started |
+
+**If your device doesn't work:** open an issue with the raw RFCOMM dump (run with `SOMETHING_X_DEBUG=1 ./somethingx`).
+
+---
+
+## Linux distros
+
+The app runs on any Linux system with BlueZ. System package names vary:
+
+| Distro | Install command |
+|---|---|
+| Arch / Omarchy | `sudo pacman -S python-gobject python-dbus python-cairo gtk4 libadwaita` |
+| Ubuntu 24.04+ | `sudo apt install python3-gi python3-dbus python3-cairo gir1.2-gtk-4.0 gir1.2-adw-1` |
+| Fedora 39+ | `sudo dnf install python3-gobject python3-dbus python3-cairo gtk4 libadwaita` |
+| openSUSE | `sudo zypper install python3-gobject python3-dbus python3-cairo gtk4 libadwaita` |
+| NixOS | see `flake.nix` |
+
+Requirements: `bluetoothd` running, BlueZ ≥ 5.6, GTK4 ≥ 4.6, libadwaita ≥ 1.2.
+
+Volume control requires `pactl` — available on any PulseAudio or PipeWire system.

{something_x_dev-1.7.0.dev15/something_x_dev.egg-info → something_x_dev-1.7.1.dev15}/PKG-INFO

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

something_x_dev-1.7.1.dev15/PKGBUILD

@@ -0,0 +1,24 @@
+# Maintainer: Raphael <raphael.girard.iut@gmail.com>
+pkgname=something-x
+pkgver=1.0.0
+pkgrel=1
+pkgdesc="GTK4 device manager for Nothing earbuds on Linux"
+arch=('any')
+url="https://github.com/SoaOaoS/nothingonmarchy"
+license=('MIT')
+depends=('python' 'python-gobject' 'python-dbus' 'gtk4' 'libadwaita')
+makedepends=('python-build' 'python-installer' 'python-wheel' 'python-setuptools')
+optdepends=('libpulse: volume control via pactl')
+source=("https://files.pythonhosted.org/packages/source/s/something-x/something_x-${pkgver}.tar.gz")
+sha256sums=('SKIP')
+
+build() {
+    cd "something_x-${pkgver}"
+    python -m build --wheel --no-isolation
+}
+
+package() {
+    cd "something_x-${pkgver}"
+    python -m installer --destdir="$pkgdir" dist/*.whl
+    install -Dm644 LICENSE "${pkgdir}/usr/share/licenses/${pkgname}/LICENSE"
+}

something_x_dev-1.7.1.dev15/ROADMAP.md

@@ -0,0 +1,69 @@
+# Something X — Roadmap
+
+---
+
+## Known Issues
+
+- Window control buttons (close/minimize/maximize) in the headerbar had a double-hover effect on non-tiling desktops due to app CSS overriding the system theme — fixed on `feat/fix-headerbar-window-controls`.
+
+---
+
+## v1.x — Near term
+
+### Docs
+- [x] **GitHub Pages** — project landing page + full documentation site (`docs/`)
+
+### Distribution
+- [x] AUR package — AUR package for Arch users to replace 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
+
+### Features
+- [x] **Low battery desktop 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 automatically on reconnect
+- [x] **CLI quick-toggle** — `something-x --anc off|on|transparency`, `something-x --eq bass`, `something-x --battery`
+- [x] **System tray icon** — show battery on hover via StatusNotifierItem (Waybar/SNI)
+- [x] **Wearing detection display** — show L/R in-ear status on the earbud visual
+- [x] **Auto-connect RFCOMM** — connect as soon as BlueZ reports the device connected, no tap needed
+
+### Fixes
+- [x] **Headerbar button hover** — window controls now respect the system theme on all desktops
+
+### Protocol
+- [x] **Debug mode** — `SOMETHING_X_DEBUG=1` env var dumps raw RFCOMM frames for contributors
+- [x] **Graceful ANC mode detection** — infer supported modes from RFCOMM level response; hide unsupported buttons
+
+---
+
+## v2.x — Medium term
+
+### Features
+- [ ] **Multiple devices simultaneously** — open two device pages, manage both at once
+- [ ] **Quick-settings panel** — small floating overlay triggered by keybind
+- [ ] **Touch controls remapping** — if the protocol exposes it (found in APK, not yet implemented)
+- [ ] **Equalizer graph** — visual EQ curve instead of preset pills; custom presets with sliders
+- [ ] **Firmware update check** — compare device firmware against latest known version, show badge
+
+### Tech
+- [ ] **Async BlueZ** — replace `dbus-python` with `dbus-fast` for non-blocking I/O
+- [ ] **Unit tests** — protocol encode/decode, CRC, ANC mode mapping
+
+---
+
+## v3.x — Long term / ideas
+
+- [ ] **CMF Watch support** — different protocol; would need fresh APK reverse-engineering
+- [ ] **Nothing Phone integration** — glyph control, notification mirroring
+- [ ] **GNOME Shell extension** — battery indicator in the top bar
+- [ ] **KDE Plasma widget** — same idea for KDE users
+- [ ] **macOS port** — replace BlueZ D-Bus with CoreBluetooth via `pyobjc` (long shot)
+
+---
+
+## Won't do
+
+- **Windows** — no BlueZ, RFCOMM access requires a different stack entirely
+- **Wayland screenshot / screen capture control** — out of scope
+- **Streaming / media playback control** — MPRIS already handles this system-wide
+

something_x_dev-1.7.1.dev15/cliff.toml

@@ -0,0 +1,41 @@
+[changelog]
+header = ""
+body = """
+{% for group, commits in commits | group_by(attribute="group") %}
+### {{ group }}
+{% for commit in commits | sort(attribute="message") %}
+- {% if commit.scope %}**{{ commit.scope }}**: {% endif %}\
+{{ commit.message | upper_first }}\
+{% endfor %}
+{% endfor %}
+"""
+footer = ""
+trim = true
+
+[git]
+conventional_commits = true
+filter_unconventional = true
+split_commits = false
+commit_parsers = [
+  { message = "^feat",     group = "Features" },
+  { message = "^fix",      group = "Bug Fixes" },
+  { message = "^perf",     group = "Performance" },
+  { message = "^refactor", group = "Refactoring" },
+  { message = "^docs",     group = "Documentation" },
+  { message = "^style",    group = "Styling" },
+  { message = "^test",     group = "Testing" },
+  # skip anything that isn't useful in a user-facing changelog
+  { message = "^chore: release", skip = true },
+  { message = "^chore",    skip = true },
+  { message = "^ci",       skip = true },
+  { message = "^build",    skip = true },
+  # skip all merge commits regardless of how they are worded
+  { message = "^[Mm]erge[ /]", skip = true },
+  { message = "^Merged",       skip = true },
+]
+filter_commits = false
+# semver release tags only; dev-* tags are ignored for "previous release" calculation
+tag_pattern  = "v[0-9]+\\.[0-9]+\\.[0-9]+"
+ignore_tags  = "dev-.*"
+topo_order   = false
+sort_commits = "oldest"