---
id: bluetooth-adapters
version: "2.4.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# bluetooth-adapters — Tools to enumerate and find Bluetooth Adapters

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

## What it is and what it does

Bluetooth-adapters is a library for discovering and enumerating Bluetooth adapters available on a system. It abstracts over platform-specific hardware detection by wrapping multiple backend libraries (dbus-fast for D-Bus systems, uart-devices and usb-devices for direct hardware access) into a unified async interface.

The package is in pre-alpha development but actively maintained, with support for Python 3.10 through 3.14. It's designed for applications that need to detect what Bluetooth hardware is present before attempting connections, making it useful in IoT, device management, and Bluetooth-centric applications. The async design integrates with modern Python concurrency patterns.

Use it for:

- Detect available Bluetooth adapters before initiating device scanning or connections in a Bluetooth application
- Build a system utility that reports installed Bluetooth hardware and its capabilities
- Enumerate adapters in a multi-adapter environment to select which one to use for a specific operation
- Validate Bluetooth hardware availability as part of application startup or health checks

## Worth the install?

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

Enumerates and locates Bluetooth adapters on a system, providing tools to discover available Bluetooth hardware across different platforms and connection types.

Yes, if you need to discover Bluetooth adapters programmatically. The package is actively maintained, has no known vulnerabilities, and low install friction. The pre-alpha status and small community (14 stars) mean the API may change, but for straightforward adapter enumeration it's a reasonable choice. Verify platform support matches your target systems before committing.

## Install

pip install bluetooth-adapters
uv add bluetooth-adapters
poetry add bluetooth-adapters

## Installing bluetooth-adapters

Before you install: Low friction installation with a pure Python wheel. Active maintenance with a recent release 80 days ago. Depends on platform-specific libraries (dbus-fast, uart-devices, usb-devices) which may require system packages on Linux, but the package itself installs cleanly.

License in practice: Apache-2.0 permissive license allows use in commercial and private projects with minimal restrictions; you must retain license notices but are free to modify and distribute.

Quickstart:

pip install bluetooth-adapters

import asyncio
from bluetooth_adapters import get_adapters

async def main():
    adapters = await get_adapters()
    for adapter in adapters:
        print(adapter)

asyncio.run(main())

Requires Python 3.10 or later. On Linux, dbus-fast and related system libraries may need to be installed separately; on other platforms, adapter support depends on available hardware interfaces.

Verify before relying:

- Whether the package provides filtering or search capabilities beyond simple enumeration
- What adapter metadata (name, address, capabilities) is returned by the discovery functions
- Whether adapter enumeration works on Windows, macOS, and other non-Linux platforms

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 746.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth adapter discovery, enumerate bluetooth devices, find bluetooth adapters, bluetooth hardware detection, list available bluetooth, bluetooth adapter enumeration, detect bluetooth interfaces, bluetooth, hardware-detection, async

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