---
id: simplepyble
version: "1.1.0"
license: unclear
license_treatment: noncommercial
maintenance: active
---

# simplepyble — The ultimate fully-fledged cross-platform BLE library, designed for simplicity and ease of use.

License: noncommercial · Maintenance: active · Downloads: 160.5K/mo

## What it is and what it does

SimplePyBLE is a cross-platform Bluetooth Low Energy library that abstracts away the complexity of platform-specific BLE APIs on Windows, macOS, and Linux. It provides a unified Python interface for discovering BLE devices, scanning for peripherals, and managing connections through both synchronous and asynchronous patterns. The package wraps lower-level BLE implementations (DBus on Linux, native APIs on Windows and macOS) and exposes them through a clean, consistent API.

The library is designed for developers who need to build BLE applications without wrestling with platform differences. It supports modern Python versions (3.10+) and includes an asyncio-compatible module for non-blocking operations. Installation is straightforward via pip, though platform-specific system libraries (like libdbus-1-dev on Linux) may be required. The package carries no Python runtime dependencies, keeping your dependency tree lightweight.

Use it for:

- Build cross-platform applications that discover and connect to Bluetooth wearables, sensors, or IoT devices
- Scan for BLE peripherals and retrieve their identifiers and addresses for device inventory or pairing workflows
- Integrate asynchronous BLE communication into event-driven Python applications using asyncio
- Prototype and test BLE device interactions on multiple operating systems without rewriting platform-specific code
- Develop commercial BLE applications (with appropriate licensing) for Windows, macOS, and Linux simultaneously

## Worth the install?

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

SimplePyBLE provides cross-platform Bluetooth Low Energy (BLE) bindings for Windows, macOS, and Linux, with both synchronous and asynchronous APIs for discovering and communicating with BLE devices.

Yes, with licensing conditions. Install if you need cross-platform BLE support and your use case is non-commercial or you can obtain a commercial license. The library is actively maintained, has no known vulnerabilities, and provides a clean API across platforms. However, verify upfront whether your intended use qualifies as non-commercial under BUSL-1.1 terms, or budget for a commercial license if building proprietary applications.

## Install

pip install simplepyble
uv add simplepyble
poetry add simplepyble

## Installing simplepyble

Before you install: Medium install friction due to platform-specific compiled wheels; on Debian/Ubuntu, requires libdbus-1-dev headers. Actively maintained with recent release (4 days old) and steady repository activity.

License in practice: Licensed under Business Source License 1.1 (BUSL-1.1) with a non-commercial perpetual use grant; free for non-commercial use but requires a commercial license for proprietary applications. Converts to GPL-3 four years after each release.

Quickstart:

pip install simplepyble

import asyncio
from simplepyble.aio import Adapter

async def main():
    adapters = Adapter.get_adapters()
    adapter = adapters[0]
    async with adapter:
        await adapter.scan_for(5000)
        peripherals = adapter.scan_get_results()
        for peripheral in peripherals:
            print(f"Found: {peripheral.identifier()} [{peripheral.address()}]")

asyncio.run(main())

On Debian/Ubuntu, install libdbus-1-dev headers before building from source. Requires Python 3.10 or later.

Verify before relying:

- Whether the asynchronous API (simplepyble.aio) is production-ready or still experimental
- Performance characteristics and latency guarantees for BLE operations across platforms
- Specific BLE services and characteristics supported or any known limitations

## Package facts

- License: not declared (noncommercial)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 160.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth low energy python, BLE library cross-platform, bluetooth device discovery, async BLE communication, bluetooth peripheral scanning, cross-platform BLE bindings, bluetooth adapter control, bluetooth-iot, cross-platform, async-ready

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