bluetooth-data-tools

What it is and what it does

Bluetooth Data Tools is a library for parsing and working with Bluetooth Low Energy (BLE) advertisement data and related metadata. It provides structured access to GAP advertisement fields (local name, service UUIDs, service data, manufacturer data, TX power) via both functional and object-oriented interfaces, plus utilities for converting between integer and MAC address formats, extracting short addresses, and formatting human-readable device names.

The package also includes distance estimation from TX power and RSSI measurements, a fast monotonic clock optimized for Bluetooth event timing (using CLOCK_MONOTONIC_COARSE on Linux via Cython), and private address resolution for BLE random addresses using Identity Resolving Keys. It depends on cryptography for the IRK-based address matching and is actively maintained with support for Python 3.10 through 3.14.

Use it for:

• Parse raw BLE advertisement packets into structured fields for device discovery and filtering.
• Convert between Bluetooth MAC address formats and integers for storage or comparison.
• Estimate distance to a Bluetooth device based on TX power and received signal strength.
• Resolve random private addresses in BLE traffic using an Identity Resolving Key.
• Format device names with short addresses for user-facing display in Bluetooth applications.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Parses and manipulates Bluetooth Low Energy advertisement data, addresses, and timing, with utilities for distance estimation and private address resolution.

Yes, if you work with Bluetooth Low Energy data parsing or device discovery. The library is actively maintained, has no known vulnerabilities, supports modern Python versions, and provides a clean API for common BLE operations. Medium install friction is typical for platform-specific packages and not a barrier. The Apache-2.0 license is unrestrictive.

Install

bluetooth-data-tools on PyPI

pip install bluetooth-data-tools

uv add bluetooth-data-tools

poetry add bluetooth-data-tools

Installing bluetooth-data-tools

Before you install

Medium install friction due to platform-specific wheels; active maintenance with a recent release (19 days ago) and current Python version support through 3.14.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions.

Quickstart

pip install bluetooth-data-tools

from bluetooth_data_tools import parse_advertisement_data_bytes
parsed = parse_advertisement_data_bytes(raw_bytes)
local_name, service_uuids, service_data, manufacturer_data, tx_power = parsed

Requires Python 3.10 or later; cryptography dependency must be installed.

Verify before relying

• Whether the Cython-optimized monotonic_time_coarse on Linux provides measurable performance benefit for typical workloads.
• Compatibility with non-x86_64 architectures beyond the manylinux wheel provided.

Package facts

Evidence: bluetooth_data_tools-1.29.21-cp314-cp314-manylinux_2_41_x86_64.whl

Tags

More Libraries packages