---
id: oralb-ble
version: "1.1.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# oralb-ble — Bluetooth library for Oral B devices

License: permissive · Maintenance: active · Downloads: 76.5K/mo

## What it is and what it does

oralb-ble is a stateful Bluetooth advertisement parser designed to extract sensor data from Oral-B toothbrush broadcasts. It does not initiate connections; instead, it passively decodes manufacturer-specific data that the toothbrush transmits while in use. You feed each BLE advertisement into the parser and receive structured sensor updates containing device state, brush mode, pressure level, sector information, and signal strength.

The parser maintains state per device instance, allowing derived fields like sector timer and toothbrush state to remain accurate across multiple advertisements from the same device. It is built on top of bleak, bleak-retry-connector, bluetooth-data-tools, bluetooth-sensor-state-data, and home-assistant-bluetooth. The package is in pre-alpha development but actively maintained, supporting Python 3.10 through 3.14.

Use it for:

- Extract real-time toothbrush state and sensor readings from BLE advertisements in Home Assistant or similar home automation systems
- Monitor oral hygiene metrics from Oral-B devices without pairing or connecting
- Build a passive Bluetooth listener that collects and logs toothbrush activity data over time
- Integrate Oral-B device telemetry into a custom IoT application that processes BLE advertisements locally

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Passive parser for Oral-B toothbrush Bluetooth Low Energy advertisements that decodes manufacturer data broadcast by the device without establishing a connection.

Yes, if you need to parse Oral-B toothbrush Bluetooth advertisements in a Home Assistant context or similar passive BLE listener. The low install friction, active maintenance, permissive license, and zero known vulnerabilities make it safe to adopt. Pre-alpha status means the API may change, so pin the version if stability is critical; otherwise it is suitable for its narrow, well-defined use case.

## Install

pip install oralb-ble
uv add oralb-ble
poetry add oralb-ble

## Installing oralb-ble

Before you install: Low friction install with a pure-Python wheel. Active maintenance as of August 2026 with recent release history. Five runtime dependencies are all Bluetooth-focused libraries, suggesting stable, well-maintained peers.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open and proprietary projects.

Quickstart:

pip install oralb-ble

from home_assistant_bluetooth import BluetoothServiceInfo
from oralb_ble import OralBBluetoothDeviceData

parser = OralBBluetoothDeviceData()
update = parser.update(service_info)
print(update.title)

Requires Python 3.10 or later; requires a source of BLE advertisements (typically from home-assistant-bluetooth or similar Bluetooth integration).

Verify before relying:

- Whether the parser handles all Oral-B toothbrush models or only specific series
- Performance characteristics when processing high-frequency advertisement streams
- Backward compatibility guarantees across minor versions given pre-alpha status

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 76.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

oral-b toothbrush ble parser, bluetooth toothbrush data decoder, oral-b ble advertisement parser, toothbrush sensor data extraction, ble manufacturer data parser, oral-b device state monitoring, bluetooth-ble, iot-sensors, home-automation

[View on SkillFed](https://skillfed.io/packages/oralb-ble) · [View on PyPI](https://pypi.org/project/oralb-ble/)