Case study

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.

Targets: Protocol
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-07
Evidence class: C2 code & docs, no demo or download

Stars: 0
Last commit: 2026-10-22
Language: Python
License (GitHub): MIT

GitHub data as of 2026-11-10

Copy as Markdown View JSON Cite

Evidence

Observed: Code and documentation observed; no download method or demo found.
Checked: 2026-11-09

How evidence classes are assigned

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.

Cite

BibTeX

@misc{baseus-cli-case,
  title = {{baseus-cli: reconstructing Baseus Bass BS1 NC control}},
  howpublished = {\url{https://github.com/erenalpars/baseus-cli}},
  url = {https://github.com/erenalpars/baseus-cli},
  urldate = {2026-11-07},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/baseus-cli-case/}}
}

Plain text

baseus-cli: reconstructing Baseus Bass BS1 NC control. https://github.com/erenalpars/baseus-cli (accessed 2026-11-07). Awesome REA entry: https://awesomerea.org/resources/baseus-cli-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · erenalpars/baseus-cli · Revision 2bb1447
PROTOCOL.md GitHub · erenalpars/baseus-cli · Revision 2bb1447