SOMETHING X

For Linux

Open Source  ·  Made for Omarchy

Get Started Documentation GitHub
$ pip install something-x

Features

Everything your earbuds need

Native Linux controls for Nothing and CMF devices. No Android app, no cloud, no compromise.

◉
ANC Control
Switch Off · Noise Cancellation · Transparency over the real RFCOMM protocol. Settings saved per device and restored on reconnect.
◈
EQ Presets
Balanced · More Bass · More Treble · Voice. Per-device profiles persisted to ~/.config/something-x/.
◎
Battery Monitor
Real-time L / R / Case battery rings with radial gradients. Low-battery notify-send at 20 %.
▸
CLI Quick-Toggles
Control ANC, EQ, and battery from the terminal. Scriptable and keybind-friendly — no GUI required.
◑
Background Mode
Closing the window keeps the app alive as a single Gio instance. RFCOMM reconnects automatically on Bluetooth re-pair.
⬡
System Tray
StatusNotifierItem icon with battery tooltip. Works with Waybar, KDE, GNOME, and any SNI-compatible panel.
◻
Volume Control
Slider controls the PulseAudio / PipeWire A2DP sink via pactl. Works on any modern audio stack.
◍
Wearing Detection
L / R in-ear status shown live on the earbud visual. Toggleable via the device settings page.
◌
Animated Splash
Cairo-rendered intro with typewriter title, ripple rings, and glow — fully in the Nothing aesthetic.

Installation

Get up and running

Install system dependencies first, then grab the app via pip or run from source.

# 1 — system dependencies
sudo pacman -S python-gobject python-dbus python-cairo gtk4 libadwaita

# 2 — install
pip install something-x

# 3 — launch
something-x
# 1 — system dependencies (Ubuntu 24.04+)
sudo apt install python3-gi python3-dbus python3-cairo gir1.2-gtk-4.0 gir1.2-adw-1

# 2 — install
pip install something-x

# 3 — launch
something-x
# 1 — system dependencies (Fedora 39+)
sudo dnf install python3-gobject python3-dbus python3-cairo gtk4 libadwaita

# 2 — install
pip install something-x

# 3 — launch
something-x
# 1 — system dependencies
sudo zypper install python3-gobject python3-dbus python3-cairo gtk4 libadwaita

# 2 — install
pip install something-x

# 3 — launch
something-x
# run directly from the flake
nix run github:SoaOaoS/something-x

# or add to your system flake inputs — see flake.nix in the repo
git clone https://github.com/SoaOaoS/something-x
cd something-x
# install system deps for your distro first, then:
./somethingx

CLI

Terminal-first controls

After connecting once via the GUI, control your earbuds from any terminal or keybind.

something-x --battery

Print L / R / Case battery percentages and exit.

something-x --anc off|on|transparency

Set ANC mode immediately. Useful in keybinds or scripts.

something-x --eq balanced|bass|treble|voice

Switch EQ preset. Saved to the device profile automatically.

something-x --device AA:BB:CC:DD:EE:FF

Target a specific device by address when multiple are connected.