---
id: bluetooth-auto-recovery
version: "1.6.4"
license: MIT
license_treatment: permissive
maintenance: active
---

# bluetooth-auto-recovery — Recover bluetooth adapters that are in an stuck state

License: permissive · Maintenance: active · Downloads: 689.2K/mo

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

pip install bluetooth-auto-recovery
uv add bluetooth-auto-recovery
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_current
- Install friction: low
- Maintenance: active
- Downloads: 689.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth adapter recovery, stuck bluetooth fix, bluetooth auto-recovery, bluetooth adapter stuck state, bluetooth connection recovery, bluetooth adapter reset, bluetooth device recovery, bluetooth, hardware-recovery, iot

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