Nothing Ear API/CLI

An unofficial Rust API/CLI that allows every device on your network to control your Nothing earbuds.
View full docs »

Report Bug · Request Feature · AUR

About The Project

earctl is a Rust rewrite of the backend logic used by the community ear-web tool. It exposes the same Bluetooth Serial Port Profile commands through a REST API and a small CLI. That means you can automate ANC, EQ, latency mode, gestures, and the rest of the Nothing/CMF settings without launching a browser.

Getting Started

Follow these steps to run the API locally. See the docs for deployment, API, and CLI details.

Prerequisites

• Rust toolchain (1.75+ recommended)
• bluez, bluez-utils (for bluetoothctl)
• bluez-deprecated-tools (provides sdptool for RFCOMM channel discovery)
• Your earbuds paired in the desktop Bluetooth UI

Quick install

git clone https://github.com/DaanHessen/earctl.git
cd earctl
cargo build --release
./target/release/earctl server --addr 0.0.0.0:8787

On Arch, install from the AUR with yay -S earctl.

(back to top)

Usage

1. Ensure the server is running (earctl server) and your earbuds are connected via the OS Bluetooth menu.
2. Auto-connect from any terminal:

   earctl auto-connect --name "Nothing Ear"

   The server queries BlueZ for connected devices, discovers the Nothing RFCOMM channel via sdptool, and opens the session. Supply --channel <number> if you need to override the detected value (defaults to channel 1 if detection fails).
3. Toggle ANC, EQ, latency, gestures, LED color, or trigger Find My Buds either via the REST endpoints or the CLI.

For more information, refer to the documentation

Contributing

Contributions are welcome: open an issue if you found a bug or send a pull request with the fix.

Top contributors:

License

Distributed under the GNU Affero GPL-3.0 license. See LICENSE for details.

(back to top)

Contact

Daan Hessen – daanh2002@gmail.com

Project Link: https://github.com/DaanHessen/earctl

Acknowledgments

• RapidZapper, Bendix, Lisra-git, MemerGamer and the rest of the ear-web team for the groundwork.
• The BlueZ maintainers.

(back to top)