---
id: bluetooth-data-tools
version: "1.29.21"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# bluetooth-data-tools — Tools for converting bluetooth data and packets

License: permissive · Maintenance: active · Downloads: 4.3M/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 4.3M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth ble advertisement parsing, bluetooth address utilities, ble gap data decoder, bluetooth distance estimation, private address resolution ble, bluetooth packet tools, ble data conversion, bluetooth-ble, packet-parsing, iot

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