thomasgregg/oralb-ha

Oral-B Live is a custom component for Home Assistant that brings real-time brushing data from Oral-B iO toothbrushes into your smart home setup. It shows a live timer, pressure, quadrant tracking, brushing mode, and a history log. It is designed for a specific problem: recent iO firmware updates stopped the toothbrush from broadcasting live session data over Bluetooth while you brush. Older Oral-B brushes send out a small Bluetooth signal every second during brushing. Home Assistant can listen to this passively and show you a live timer, pressure changes, and which quadrant of your mouth you are cleaning. The iO brushes with updated firmware stopped doing this. Now, during a session the brush goes silent, then sends a single summary when you finish. Passive listeners see a jump from idle to a final duration, with nothing in between. This integration works around that by opening an active Bluetooth connection to the brush, called a GATT connection, to pull the live data that passive listening can no longer catch. It runs a hybrid approach. A passive layer listens for broadcasts when the brush is idle, keeping battery and state updated for free. An active layer opens a connection during or after brushing to retrieve the live timer, pressure, quadrant, and other details. The main complication is that the brush accepts only one Bluetooth client at a time. Three parties want that slot: the iO Sense charger with its display, the Oral-B phone app, and Home Assistant. Only one can connect during a session. This is a firmware property of the brush, not something the integration can fix. It offers two connection modes to handle the trade-off. In charger-priority mode, the default, Home Assistant does not compete for the slot while you brush. The charger display works as normal, and Home Assistant records the session from passive signals. It tries a brief sync afterward to read the brush's own session record. You keep a complete brushing log, but live timer and pressure updates are not guaranteed. In live mode, Home Assistant takes the slot and holds it, giving you full real-time updates at one second intervals. The trade-off is that the charger display stops working and the phone app cannot sync while Home Assistant holds the connection. The full README is longer than what was shown.