---
id: aioblescan
version: "0.2.14"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# aioblescan — Scanning Bluetooth for advertised info with asyncio.

License: permissive · Maintenance: dormant · Downloads: 156.2K/mo

## What it is and what it does

aioblescan is a Python 3 asyncio library that captures and decodes Bluetooth Low Energy advertisement packets at the HCI (Host Controller Interface) level. It runs on Linux systems with Bluetooth hardware and parses incoming BLE broadcasts to extract beacon data, sensor readings (temperature, humidity, battery), and device metadata like MAC addresses and signal strength (RSSI).

You attach a callback function to a BTScanRequester, issue a scan command, and the library delivers parsed packets as they arrive. It includes built-in decoders for several beacon standards—Eddystone (URLs, telemetry, UIDs), RuuviTag weather sensors, ATC_MiThermometer, ThermoBeacon, and Tilt hydrometers—and falls back to raw HCI event dumps for unknown formats. The package is primarily a listening tool; it can also send Eddystone advertisements.

Use it for:

- Monitor RuuviTag or other BLE weather sensors to collect temperature, humidity, and pressure readings from multiple devices.
- Track Eddystone beacons in a space to detect proximity or retrieve embedded URLs and telemetry data.
- Build a Tilt hydrometer monitor to log fermentation temperature and gravity readings over time.
- Scan for generic BLE advertisements to discover nearby devices and inspect raw HCI packet structure for reverse-engineering.
- Integrate BLE scanning into an asyncio application to react to beacon events without blocking.

## Worth the install?

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

aioblescan listens for and parses Bluetooth Low Energy (BLE) advertisement packets using Python's asyncio, extracting beacon data, sensor readings, and device information from the air.

Yes, if you need to listen for BLE advertisements on Linux and are comfortable with dormant maintenance. The package has no runtime dependencies, low install friction, and a stable MIT license. It works well for its narrow scope—parsing standard beacon formats and raw HCI packets—but expect no active bug fixes or feature updates. Verify compatibility with your Python version and Bluetooth hardware before relying on it in production.

## Install

pip install aioblescan
uv add aioblescan
poetry add aioblescan

## Installing aioblescan

Before you install: Installation is straightforward with no runtime dependencies. The package is dormant—last release was 2023-01-07 and last commit 2024-08-13—so expect no active maintenance, though the codebase remains stable for its narrow use case.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal legal friction.

Quickstart:

pip install aioblescan

python3 -m aioblescan

# Or in code:
import asyncio
from aioblescan import BTScanRequester

async def process_packet(packet):
    print(packet)

req = BTScanRequester()
req.on_packet(process_packet)
await req.start()

Requires Linux with Bluetooth hardware (HCI socket access); typically needs root or appropriate permissions to access the Bluetooth device.

Verify before relying:

- Whether the package works reliably on modern Linux distributions and recent Python 3.10+ versions given the dormant maintenance status.
- Compatibility with contemporary Bluetooth hardware and HCI stack implementations.
- Whether custom beacon formats beyond Eddystone, RuuviWeather, ATC_MiThermometer, ThermoBeacon, and Tilt are actively parseable or require manual raw-packet handling.

## Package facts

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

## Tags

bluetooth ble scanning asyncio, ble advertisement packet parser, bluetooth beacon detection, eddystone ruuvi tag scanner, ble sensor data extraction, bluetooth low energy monitoring, hci ble packet listener, bluetooth-ble, asyncio, sensor-data

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