.. image:: docs/public/simpleBLE-logo-dark.png#gh-light-mode-only :alt: SimpleBLE :align: center :width: 360px

.. image:: docs/public/simpleBLE-logo.png#gh-dark-mode-only :alt: SimpleBLE :align: center :width: 360px

SimpleBLE

Build Bluetooth once. Ship it everywhere.

|CI Main| |Latest Release| |License|

SimpleBLE is the cross-platform Bluetooth Low Energy stack for Windows, macOS, Linux, iOS, and Android. Use it from C++, C, C#, Python, Java, Kotlin, Swift, Dart, Delphi, Go, Rust, JavaScript, React Native, or Flutter, with a dedicated API for Unreal Engine.

Why SimpleBLE

• One cross-platform API: Keep application-facing BLE logic consistent across desktop and mobile.
• Native underneath: Use WinRT, CoreBluetooth, BlueZ, and Android Bluetooth through one maintained stack.
• Built for real products: Central- and peripheral-role support across all supported platforms.
• Commercially supported: Ship proprietary applications with licensing and direct technical support available.

Get Started

Choose the API that fits your project in the Installation_ guide, then get to a first BLE scan in minutes with the Quickstart. For tutorials, recipes, platform notes, and API references, visit the Documentation.

Dongl: Official SimpleBLE Hardware

Dongl_ is a USB Bluetooth adapter made for SimpleBLE. Its Bluetooth stack runs in firmware we develop together with the library, so it behaves the same on every Windows, macOS, and Linux computer.

Use Dongl when you want firmware visibility, customizability, and direct support from the team building SimpleBLE.

• Plug in several Dongls next to the computer's own adapter; SimpleBLE lists each one as an adapter.
• Get real device addresses on macOS and Windows, and answer pairing requests without system dialogs.
• Evaluate the firmware on Nordic's nRF52840 Dongle or DK.

Documentation and Support

• Read the Documentation <https://docs.simpleble.org/?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=support>__ and Announcements_.
• Ask questions and share projects in GitHub Discussions_.
• Review the security policy_ or learn how to contribute_.
• Explore the lower-level SimpleBluez_ and SimpleDBus_ libraries.
• Visit |website|_ or |email|_ about commercial licensing and professional services.
• Browse the SimpleBLE Store_.

License

SimpleBLE is available under the Business Source License 1.1 (BUSL-1.1). It is free to use for non-commercial purposes and requires a commercial license for commercial use. Each version converts to the GNU General Public License version 3 four years after its initial release. Qualifying non-commercial users may instead continue using and distributing that version under the original BUSL-1.1 terms through the Non-Commercial Perpetual Use Grant in LICENSE.md.

Free commercial licenses are available for qualifying small projects and early-stage companies, and commercial licenses carry no royalties or revenue sharing. See |website-url|_ for pricing and commercial terms, or |leavemessage|_ to discuss your use case.

---

SimpleBLE is a project powered by |caos|_.

.. Badges

.. |CI Main| image:: https://github.com/simpleble/simpleble/actions/workflows/ci_main.yml/badge.svg?branch=main :alt: CI Main :target: https://github.com/simpleble/simpleble/actions/workflows/ci_main.yml?query=branch%3Amain

.. |Latest Release| image:: https://img.shields.io/github/v/release/simpleble/simpleble?sort=semver&display_name=tag :alt: Latest release :target: https://github.com/simpleble/simpleble/releases/latest

.. |License| image:: https://img.shields.io/badge/license-BUSL--1.1-blue :alt: BUSL 1.1 license :target: https://github.com/simpleble/simpleble/blob/main/LICENSE.md

.. Links

.. |email| replace:: email us .. _email: mailto:[email protected]

.. |leavemessage| replace:: leave us a message .. _leavemessage: https://www.simpleble.org/contact?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=license

.. |website| replace:: our website .. _website: https://simpleble.org?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=support

.. |website-url| replace:: www.simpleble.org .. _website-url: https://simpleble.org?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=license

.. |caos| replace:: The California Open Source Company .. _caos: https://californiaopensource.com?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=footer

.. _Announcements: https://simpleble.org/blog/news?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=support .. _Documentation: https://docs.simpleble.org/?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=get_started .. _GitHub Discussions: https://github.com/simpleble/simpleble/discussions .. _Dongl: https://www.simpleble.org/dongl?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=dongl .. _SimpleBLE Store: https://simpleble.store?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=support .. _SimpleBluez: https://docs.simpleble.org/simplebluez/usage?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=support .. _SimpleDBus: https://docs.simpleble.org/simpledbus/usage?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=support .. _security policy: https://github.com/simpleble/simpleble/blob/main/SECURITY.md .. _contribute: https://github.com/simpleble/simpleble/blob/main/CONTRIBUTING.md .. _Installation: https://docs.simpleble.org/installation?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme&utm_content=get_started .. _Quickstart: