SimpleBLE/README.rst

|Latest Documentation Status|

SimpleBLE
==========

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

Announcements
-------------

* **(2025-03-16)** ☕ Java bindings are now in Early Preview. **Looking for design partners who'd like to test it out and provide feedback.**
* **(2025-03-16)** Based in Asia or LATAM? **Looking for partners for more targeted regional sales and support.**
* **(2025-02-25)** 🤖 Android backend support is now in Preview.
* **(2025-01-20)** SimpleBLE is now available under the Business Source License 1.1 (BUSL-1.1). Please see the `LICENSE`_ file for more details.
* **(2024-12-02)** Peripheral functionality is now in Early Preview. **Looking for design partners who'd like to test it out and provide feedback.**

Key Features
------------

* **Cross-Platform**: Enterprise-grade support for Windows, macOS, Linux, iOS, and Android
* **Device Roles**: Full Central support, with Peripheral functionality in Early Preview
* **Easy Integration**: Clean, consistent API across all platforms
* **Multiple Language Bindings**: Production-ready bindings for C, C++, Python, Java (Early Preview), more coming soon
* **Commercial Ready**: Source-available commercial license for proprietary applications

Language Bindings
-----------------

* **C/C++**: Core implementation with full platform support
* **Python (SimplePyBLE)**: Python bindings. See the `SimplePyBLE`_ PyPI page for more details.
* **Java (SimpleJavaBLE) - Early Preview**: Java bindings. **Looking for design partners who'd like to test it out and provide feedback.**
* **Rust (SimpleRsBLE) - Alpha**: Rust bindings (under major refactor). See the `SimpleRsBLE`_ Crates.io page for more details.
* **Android (SimpleDroidBLE) - Alpha**: Android-only bindings (alpha).
* More languages coming soon!

Extension Libraries
-------------------

* **SimpleBluez**: BlueZ abstraction layer over DBus
* **SimpleDBus**: DBus object hierarchy handler

Support & Resources
--------------------

We're here to help you succeed with SimpleBLE:

* **Documentation**: Visit our `ReadTheDocs`_ page for comprehensive guides
* **Commercial Support**: Check our `website`_ or `email us <mailto:contact@simpleble.org>`_ for licensing and professional services
* **Community**: Join our `Discord`_ server for discussions and help

Don't hesitate to reach out - we're happy to help!

Projects using SimpleBLE
------------------------

Don't forget to check out the following projects using SimpleBLE:

* `BrainFlow`_
* `InsideBlue`_
* `NodeWebBluetooth`_

License
=======

Since January 20th 2025, SimpleBLE is now available under the Business Source License 1.1 (BUSL-1.1).
This means that the project is now free to use for non-commercial purposes, but requires a commercial
license for commercial use. Each version of SimpleBLE will convert to the GNU General Public License
version 3 after four years of its initial release.

**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

**You can find more information on pricing and commercial terms of service at www.simpleble.org**

For further enquiries, please contact us at ``contact at simpleble dot org``.

**We also offer FREE commercial licenses for small projects and early-stage companies - reach out to discuss your use case!**

Licensing FAQ
-------------

**What does the Business Source License 1.1 allow and restrict?**

The Business Source License allows non-production use, such as development and testing in isolated
environments. However, any use that could be considered production (including internal tools,
revenue-generating projects, or customer-facing deployments) requires purchasing a commercial license.

After four years of the initial release of a given version of SimpleBLE, the license automatically
converts to the GNU General Public License version 3.

**What do you consider "commercial use"?**

Commercial use in the context of SimpleBLE refers to any usage of the library or its derivatives in
a commercial setting where it contributes, either directly or indirectly, to financial gain. This
includes, but is not limited to, incorporating SimpleBLE into commercial software products, using it
in the development of services offered for a fee, or deploying it within internal tools or software
in a for-profit organization where it adds business value.

**Why do I need to pay for commercial use?**

Commercial licensing enables us to sustainably maintain and enhance SimpleBLE, particularly given
its growing adoption in critical sectors like medical and industrial applications. The revenue
from commercial licenses allows us to provide robust support, maintain compatibility with evolving
underlying APIs, and invest in improvements that benefit all users. This includes expanded
language support, better testing infrastructure, and more comprehensive documentation. While
SimpleBLE remains freely available for non-commercial use, the Business Source License ensures we
can continue providing the level of reliability and support that commercial applications require.

**I already have a commercial license. What happens with this latest license change?**

Nothing changes. You can continue using SimpleBLE under the terms of your commercial license.

**I'm using SimpleBLE commercially, but don't have a commercial license. What should I do?**

Please reach out at ``contact at simpleble dot org`` and we can discuss the specifics of your
situation. We have a free commercial license option for small projects and early-stage companies
and very flexible commercial licensing options for larger projects.


.. Links

.. _website: https://simpleble.org

.. _SimplePyBLE: https://pypi.org/project/simplepyble/

.. _SimpleRsBLE: https://crates.io/crates/simplersble

.. _Discord: https://discord.gg/N9HqNEcvP3

.. _ReadTheDocs: https://simpleble.readthedocs.io/en/latest/

.. |Latest Documentation Status| image:: https://readthedocs.org/projects/simpleble/badge?version=latest
   :target: http://simpleble.readthedocs.org/en/latest

.. Other projects using SimpleBLE

.. _GDSimpleBLE: https://github.com/jferdelyi/GDSimpleBLE
.. _BrainFlow: https://github.com/brainflow-dev/brainflow
.. _InsideBlue: https://github.com/eriklins/InsideBlue-BLE-Tool
.. _NodeWebBluetooth: https://github.com/thegecko/webbluetooth