bluetooth-auto-recovery

Recover bluetooth adapters that are in an stuck state

bluetooth-auto-recovery v1.6.4 689.2K downloads/30d#5,338 on PyPI★ 11

Permissive license MIT Active released 2026-05-25

What it is and what it does

Bluetooth Auto Recovery is a utility library that detects when Bluetooth adapters have become stuck and restores them to working state. It originated from recovery logic in the ble_monitor project and wraps platform-level Bluetooth adapter management to handle edge cases where adapters stop responding.

The package is designed for developers building Bluetooth-dependent applications who need resilience against adapter hangs. It depends on PyRIC, bluetooth-adapters, btsocket, usb-devices, and async-timeout to interact with the system's Bluetooth stack. The library is pre-alpha and actively maintained, supporting Python 3.10 through 3.14.

Use it for:

Recover stuck Bluetooth adapters in long-running IoT applications
Automatically restore connectivity in BLE monitoring systems that lose adapter responsiveness
Handle adapter hangs in Bluetooth multi-device applications without manual restart
Integrate adapter health checks into Bluetooth device discovery pipelines

Worth the install?

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

Detects and recovers Bluetooth adapters that have entered a stuck or unresponsive state, restoring connectivity without manual intervention.

Yes, if you are building a Bluetooth application that needs resilience against adapter hangs. The package is actively maintained, has low install friction, carries a permissive MIT license, and addresses a real pain point in Bluetooth development. Pre-alpha status means the API may change, but the maintenance signal is solid and there are no known vulnerabilities.

Install

bluetooth-auto-recovery on PyPI

pip

pip install bluetooth-auto-recovery

uv

uv add bluetooth-auto-recovery

poetry

poetry add bluetooth-auto-recovery

Installing bluetooth-auto-recovery

Before you install

Low friction install with a pure-Python wheel. Actively maintained as of August 2026 with recent releases. Depends on five runtime packages including PyRIC and bluetooth-adapters.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart

pip install bluetooth-auto-recovery

import bluetooth_auto_recovery
# Use the recovery utilities to detect and restore stuck adapters

Requires Python 3.10 or later.

Verify before relying

Specific API surface and which recovery methods are exposed for direct use
Whether recovery is automatic on import or requires explicit function calls
System-level permissions and platform-specific requirements for adapter interaction

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	5 — PyRIC, async-timeout, bluetooth-adapters, btsocket, usb-devices
Maintenance	actively maintained — 81 days since the last release
Last repo commit	2026-08-10
First released	2022-08-19
Downloads	689,233/month — #5,338 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-14)

Evidence: bluetooth_auto_recovery-1.6.4-py3-none-any.whl

Development Status :: 2 - Pre-AlphaIntended Audience :: DevelopersNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: Libraries