USB Bluetooth
Take full control of your USB Bluetooth controllers from Python!
If you want to use this library with Scapy, please check out scapy-usbbluetooth.
For general documentation about the project, please visit usbbluetooth.github.io.
For a C version of this library, check out UsbBluetooth for C.
For a C# version of this library, check out UsbBluetooth for C#.
Installation
Just use pip :)
pip install usbbluetooth
Usage
Once installed, you may list devices using usbbluetooth.list_controllers(), and for each device you may open() the device, write() and read() to them and close() it once you are done.
See the examples folder for some sample code.
Plaform quirks
This package has some requirements to work because of different platform particularities. To make sure the package works, please, see https://usbbluetooth.github.io/quirks/
History
Package versions < 0.1 were bindings around the original C library.
The history for those packages can be found in the usbbluetooth repository in the respective tags.
Package versions >= 0.1 are developed in this repo and based of pyusb, the Python LibUSB binding.
Metadata
Release files for usbbluetooth 0.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| usbbluetooth-0.1.5.tar.gz | 32.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| usbbluetooth-0.1.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 57.4 kB
Release files / usbbluetooth-0.1.5.tar.gz
| Download URL | usbbluetooth-0.1.5.tar.gz |
|---|---|
| Size | 32.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
591daea1e634132d2cfb4800b357fa9f5780cfe9729bd9905d071f6f8c474617
|
|
BLAKE2b-256 checksum How to use checksums |
99a59e43a13b013cc3365450243cecf8ebc2fb5a821a8ecc131775537a5f14a8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 9, 2026.
Transparency logRelease files / usbbluetooth-0.1.5-py3-none-any.whl
| Download URL | usbbluetooth-0.1.5-py3-none-any.whl |
|---|---|
| Size | 24.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b2c37ef195aea8fdb9480d307acadd0f3e9fb7cb413d78b427ccbd5a5ac85ba8
|
|
BLAKE2b-256 checksum How to use checksums |
b629cb2578ddaf7a48c074b289c6d605ce4789a1918d5bf3d4458c98b23dc0f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 9, 2026.
Transparency log