something-x-dev 1.3.0.dev5

Something X device manager for Omarchy / Linux

Something X — for Linux

A Linux-native companion app for Nothing and CMF Bluetooth devices.
Built for Omarchy (Hyprland / Wayland) — pure black, JetBrains Mono, Nothing Red.

  ●  SOMETHING X
     FOR LINUX

---

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)
• 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)

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)

pip install something-x
something-x

Run from source

git clone https://github.com/SoaOaoS/something-x
cd something-x
./somethingx

Desktop launcher (Walker / Rofi / app menu)

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:

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 is reverse-engineered from the official Android APK. If your device uses different command IDs or channel numbers, patches are very welcome.

---

License

MIT