Skip to content
damnmsPublic

About

Android app for Bluetooth toothbrushes – no account, no internet permission. Laifen, Philips Sonicare, Oral-B, Oclean, Xiaomi.

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Bürstli 🪥

Build Release License: GPL-3.0

Open-source Android app for Bluetooth toothbrushes. No account. No internet permission. No nonsense.

Works with brushes from Laifen, Oclean, Oral-B, Philips Sonicare and Xiaomi – the Laifen Wave is tested on a real brush, the Sonicare DiamondClean 9000 confirmed, the others are experimental. Any other brush can record a report, so it can be added.

Bürstli connected to a Laifen Wave: battery, start button, 30-second nudge, high frequency and brushing time

The official app wants you to register with an e-mail address or phone number and confirm a verification code. To adjust a toothbrush. Bürstli doesn't. It talks to your brush over Bluetooth, and that's it — the app doesn't even have the permission to access the internet.

Bürstli is Swiss German for "little brush". Rhymes with Brötli. Pronounce it however you like.

Supported brushes

Brand Model Status What you see
Laifen Wave (LFTB01) ✅ tested battery, modes, brushing time, start/stop, the hidden fourth mode – and you can change them
Wave Pro, Wave SE, Kids TC51 🧪 experimental battery, brushing time, brushing/idle, settings
Oclean X series (X, X Pro, X Ultra, X Pro Elite, …), Z1 🧪 experimental battery, brushing history, score
other Oclean models 🧪 experimental model, battery
Oral-B iO, Genius, Smart, Pro, Triumph 🧪 experimental status, mode, pressure, battery, brushing history
Philips Sonicare DiamondClean, Prestige, ExpertClean, Kids, … 🧪 experimental ¹ battery, mode, intensity, brush head; switching mode and intensity
7100 (HX742X) 🔍 recognized a report – tester wanted
Xiaomi T500, T700, T700i, T501 🧪 experimental ² brushing/off, score of the last session
21 more models in Mi Home 🔍 recognized a report
Any other brush Playbrush, usmile, Ailoria, MOVA, Tesla, … ✋ pick it by hand a report

¹ Reading confirmed on a DiamondClean 9000 – thanks to my awesome brother! ² The T700 and T501 broadcast encrypted: Bürstli needs the brush's key (how to get it). The T500 must have been set up with Mi Home once.

Everything each brush shows, its Bluetooth name and what is still untested: follow the brand's link.

✅ tested: confirmed by an owner with Bürstli. 🧪 experimental: built from other people's research verified on real brushes, or from what the official app does, not yet tried with Bürstli. Experimental drivers only read – except Philips Sonicare, where Bürstli also switches mode and intensity and sets the clock, as the official app does (details). 🔍 recognized: Bürstli knows the brush and records a report for it. ✋ any other brush: pick it from the list of nearby devices to record a report.

Install

Get it on Obtainium

Recommended: Obtainium. It installs Bürstli straight from the GitHub releases and keeps it up to date – no store, no account. With Obtainium installed, tap the badge above on your phone, or add https://github.com/damnms/buerstli by hand.

Or by hand: grab the APK from Releases and open it on your phone. You'll have to look for updates yourself. No Google Play Services needed either way.

Tips:

  • The brush only shows up while it's awake. Pick it up before tapping Find my brush.
  • It can only talk to one app at a time. Close the official app (or nRF Connect) first.
  • After a disconnect it may take up to a minute until the brush advertises again.

Permissions

Permission Why
BLUETOOTH_SCAN, BLUETOOTH_CONNECT To find and talk to the brush (Android 12+)
ACCESS_FINE_LOCATION Android 11 and older only — the OS requires it for Bluetooth scanning
INTERNET not requested

Help wanted: testers 🙋

Got a brush marked 🔍 or 🧪? You can help without any technical knowledge: open Bürstli, tap Find my brush, then Let's go. Bürstli doesn't know your brush at all? Tap My brush isn't supported and pick it from the list of Bluetooth devices nearby. Bürstli listens to your brush for about a minute – it only reads, nothing on the brush is changed – and gives you a report to send by messenger, e-mail or as a GitHub issue.

What a report would settle, per brand:

  • Laifen Wave Pro, SE, Kids TC51: does the screen fill, and does it match the official app? What to check
  • Oclean: model and battery for every Oclean, the brushing history for the X series and the Z1. Bürstli only asks for the data; it never sends the command the app deletes the history with. One report from an X or X Pro answers most of it. What to check
  • Oral-B: battery, brushing history and brush head reminder come from studying the official app. One report from an iO and one from an older Genius or Smart would settle most of it. What to check
  • Philips Sonicare 7100 (HX742X): it speaks a different protocol ("Condor"), written down from the official app. A report shows whether it answers the way the app expects – the first step to a driver.
  • Xiaomi: the T500, T700, T700i and T501 have drivers that only listen. The T700 and T501 broadcast encrypted; with the brush's key (how to get it) Bürstli reads them – brush once, then copy the nerd log. A report from any other Xiaomi shows whether it can be read without Mi Home. What to check

For developers

./gradlew test lintDebug assembleDebug
  • docs/ARCHITECTURE.md: how the code is split, and why.
  • CONTRIBUTING.md: adding a brush, the changelog, releasing (scripts/release.sh).
  • docs/: the protocol notes per brand, with where every value comes from.

Releases are built by GitHub Actions when a tag v* is pushed. The workflow expects these repository secrets: KEYSTORE_BASE64, KEYSTORE_PASSWORD, KEY_ALIAS, KEY_PASSWORD.

Credits

The protocol knowledge comes from earlier interoperability work, which deserves all the credit:

For Laifen's newer brushes, Oclean, Oral-B, Philips Sonicare and Xiaomi, the official apps were also studied to understand the protocol; the protocol notes say what comes from where. No code was copied from any of them, and none from an official app.

How this was made

Bürstli was written with the help of an AI assistant (Claude). For the Laifen Wave, the protocol was verified step by step on a real brush, and the parser is tested against packets captured from that brush. The Philips Sonicare driver was confirmed on a real DiamondClean 9000. Everything else is built on other people's research or on what the official app does (see Credits), and stays experimental until an owner confirms it.

Legal

This is an independent interoperability project. It is not affiliated with, endorsed by or supported by Laifen, Philips, Procter & Gamble (Oral-B), Xiaomi or Oclean. "Laifen", "Laifen Wave", "Philips", "Sonicare", "Oral-B", "Xiaomi", "Mijia" and "Oclean" are trademarks of their respective owners and are used here only to describe compatibility. Tools by others that the docs point to (e.g. for a Xiaomi key) are not part of Bürstli; Bürstli has no rights or duties regarding them. Use at your own risk – worst case, your toothbrush forgets its favourite settings.

License

GPL-3.0. Fork it, improve it, share it — but keep it open. Nobody gets to turn this into yet another closed app that wants your phone number.

About

Android app for Bluetooth toothbrushes – no account, no internet permission. Laifen, Philips Sonicare, Oral-B, Oclean, Xiaomi.

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages