aioblescan
Scanning Bluetooth for advertised info with asyncio.
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Linux with Bluetooth hardware (HCI socket access); typically needs root or appropriate permissions to access the Bluetooth device.
- 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 · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal legal friction.
last release 2023-01-07 (1315 days) · last repo commit 2024-08-13 · 127 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 156,232 downloads/mo, #10,789 on PyPI
Alternatives
Verify before relying
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()- 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.
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 on this page. Verify before relying on it.
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
aioblescan on PyPI
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.
Requires Linux with Bluetooth hardware (HCI socket access); typically needs root or appropriate permissions to access the Bluetooth device.
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()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 | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 1,315 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 156,232 / month, #10,789 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: aioblescan-0.2.14-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “bluetooth ble scanning asyncio”
- aioblescanaioblescan listens for and parses Bluetooth Low Energy (BLE)…
- simplepybleSimplePyBLE provides cross-platform Bluetooth Low Energy (BLE)…
- winrt-Windows.Devices.Bluetooth.AdvertisementProvides Python bindings to access Windows Runtime Bluetooth…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also aiobmsble · ibeacon-ble · bluetooth-data-tools · inkbird-ble · bumble · oralb-ble · bthome-ble · greeneye_monitor · aioruuvigateway · PySwitchbot