Bluetooth Adapters

Warnings

• breaking Major versions of the underlying `bleak` library (e.g., 2.x, 3.x) can introduce breaking changes in behavior or API. `bluetooth-adapters` version 2.1.1 explicitly supports `bleak` 1.x. Users integrating with newer `bleak` versions might encounter compatibility issues or require an updated `bluetooth-adapters` release.
  Fix: Check the `bluetooth-adapters` PyPI page or GitHub releases for updates that explicitly support newer `bleak` major versions. Ensure your installed `bleak` version aligns with the requirements of your `bluetooth-adapters` version.
• gotcha On Linux, `bluetooth-adapters` relies on the BlueZ service and D-Bus. Issues can arise if D-Bus is not running, if the BlueZ service is not active, or due to incorrect D-Bus permissions, leading to adapter enumeration failures or communication problems.
  Fix: Ensure the BlueZ service is running and D-Bus is properly configured. Check system logs for D-Bus or BlueZ errors. You might need to adjust user permissions to interact with Bluetooth devices via D-Bus.
• gotcha Bluetooth performance (range, stability, audio quality) can be significantly impacted by electromagnetic interference, particularly from USB 3.0 ports. Plugging a Bluetooth adapter into a USB 3.0 port can cause poor signal quality due to interference in the 2.4GHz band.
  Fix: Plug Bluetooth adapters into a USB 2.0 port. If only USB 3.0 ports are available, use a USB 2.0 extension cable to move the adapter away from the computer or other potential sources of interference.
• deprecated Versions of `bluetooth-adapters` prior to 2.1.0 had a bug that could prevent D-Bus connections from being properly closed, potentially leading to resource leaks or stale connections over time.
  Fix: Upgrade to `bluetooth-adapters` version 2.1.0 or newer to ensure D-Bus connections are reliably closed.

Install

• pip install bluetooth-adapters Install latest version

Imports

• get_adapter_manager

  from bluetooth_adapters import get_adapter_manager

Quickstart

This quickstart demonstrates how to asynchronously retrieve and print information about available Bluetooth adapters on the system. It uses `get_adapter_manager` to get the system's adapter manager and then fetches all detected adapters.

import asyncio
from bluetooth_adapters import get_adapter_manager

async def main():
    manager = await get_adapter_manager()
    adapters = await manager.adapters()
    if not adapters:
        print("No Bluetooth adapters found.")
        return

    print(f"Found {len(adapters)} Bluetooth adapter(s):")
    for adapter in adapters:
        print(f"- Adapter: {adapter.name} ({adapter.address}) "
              f"Powered: {adapter.powered} Discovering: {adapter.discovering}")

if __name__ == "__main__":
    asyncio.run(main())