# baseus-cli: reconstructing Baseus Bass BS1 NC control

> baseus-cli controls Baseus Bass BS1 NC earbuds on Windows through a reconstructed Classic Bluetooth RFCOMM protocol. Its Python client reads and changes ANC, spatial audio, EQ, bass boost and other settings; a protocol map and research scripts document frame opcodes and state-difference experiments.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-07
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/erenalpars/baseus-cli>
- Primary source: <https://github.com/erenalpars/baseus-cli/blob/2bb1447d216659129a9d0a01473b962cb2dc9098/README.md>
- Catalog page: <https://awesomerea.org/resources/baseus-cli-case/>
- Record JSON: <https://awesomerea.org/resources/baseus-cli-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/baseus-cli-case/index.md)

## Requirements & limits

- **Prerequisites:** Windows 10 or 11, Python 3.9 or later, and paired, connected Bass BS1 NC earbuds.
- **Prerequisites:** The Baseus phone app must release the earbuds' sole control channel.
- **Limits:** The protocol was investigated on one pair; gestures remain undecoded.
- **License:** MIT license.

## Primary sources

1. <https://github.com/erenalpars/baseus-cli/blob/2bb1447d216659129a9d0a01473b962cb2dc9098/README.md>
2. <https://github.com/erenalpars/baseus-cli/blob/2bb1447d216659129a9d0a01473b962cb2dc9098/PROTOCOL.md>

## More in Protocols

- [hxoctkl: reconstructing HyperX Alloy Origins Core profile writes](https://awesomerea.org/resources/hyperx-origins-core-tkl-rgb-case/index.md) · Case study
- [Wireless Doorbell Clone: reconstructing a Grundig QH-831A remote frame](https://awesomerea.org/resources/wireless-doorbell-clone-case/index.md) · Case study
- [Lucci Air Homey App: reconstructing two fan handset RF protocols](https://awesomerea.org/resources/lucci-air-homey-app-case/index.md) · Case study
- [Taktil: reconstructing AULA F99 HID control](https://awesomerea.org/resources/taktil-case/index.md) · Case study
- [MG330 Studio: reconstructing SPCP6651B mouse configuration](https://awesomerea.org/resources/mg330-studio-case/index.md) · Case study
- [qutie: reconstructing PRT Qutie Bluetooth printing](https://awesomerea.org/resources/qutie-printer-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.