simplepyble 1.0.1.dev2

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

SimplePyBLE

The ultimate cross-platform library and bindings for Bluetooth Low Energy (BLE), designed for simplicity and ease of use.

Key Features

• Cross-Platform: Enterprise-grade support for Windows, macOS, Linux

• Easy Integration: Clean, consistent API across all platforms

• Multiple Language Bindings: Production-ready bindings for C, C++, Python, Java and Rust, with more coming soon

• Commercial Ready: Source-available commercial license for proprietary applications

Support & Resources

We’re here to help you succeed with SimpleBLE:

• Documentation: Visit our Documentation page for comprehensive guides

• Commercial Support: Check out our website or email us about licensing and professional services.

• Community: Join our Discord server for discussions and help

• Dongl: Try the official SimpleBLE Bluetooth dongle for reliable prototyping and production.

Don’t hesitate to reach out if you need assistance - we’re happy to help!

Installation

You can install SimplePyBLE from PyPI using pip:

pip install simplepyble

When building from source on Debian or Ubuntu, install the DBus development headers first:

sudo apt-get install libdbus-1-dev

Usage

Please review our code examples on GitHub for more information on how to use SimplePyBLE.

Asynchronous Support

SimplePyBLE provides an asynchronous API via the simplepyble.aio module. This module is designed to work with asyncio and provides a more idiomatic way to handle asynchronous operations in Python.

Example:

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()}]")

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

Check out the async examples for more details.

License

Since January 20th 2025, SimpleBLE is now available under the Business Source License 1.1 (BUSL-1.1). Each version of SimpleBLE will convert to the GNU General Public License version 3 after four years of its initial release. Qualifying non-commercial users may instead continue using and distributing that version under the original BUSL-1.1 terms under the Non-Commercial Perpetual Use Grant in LICENSE.md.

The project is free to use for non-commercial purposes, but requires a commercial license for commercial use. We also offer FREE commercial licenses for small projects and early-stage companies - reach out to discuss your use case!

Why purchase a commercial license?

• Build and deploy unlimited commercial applications

• Use across your entire development team

• Zero revenue sharing or royalty payments

• Choose features that match your needs and budget

• Priority technical support included

• Clear terms for integrating into MIT-licensed projects

Looking for information on pricing and commercial terms of service? Visit www.simpleble.org for more details.

For further enquiries, please email us or leave us a message on our website and we can discuss the specifics of your situation.

---

SimpleBLE is a project powered by The California Open Source Company.