|Latest Documentation Status|

SimpleBLE
==========

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, 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 and Rust, with 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.
* **Rust (SimpleRsBLE) - Early Preview**: Rust bindings with a **NEW API**. See the `SimpleRsBLE`_ Crates.io page for more details.
* **Android (SimpleDroidBLE) - Alpha**: Android-only bindings (alpha).
* More languages coming soon!

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

We're here to help you succeed with SimpleBLE:

* **News and Announcements**: Follow our `Announcements`_ section for announcements and updates.
* **Documentation**: Visit our `ReadTheDocs`_ page for comprehensive guides.
* **Community**: Join our `Discord`_ server for discussions and help.
* **Commercial Support**: Check out |website|_ or |email|_ about licensing and professional services.
* **Extension Libraries**: Learn about `SimpleBluez`_, our BlueZ abstraction layer, and `SimpleDBus`_, our DBus object hierarchy handler.

Explore projects built with SimpleBLE, including `BrainFlow`_, `InsideBlue`_, and `NodeWebBluetooth`_.

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

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.

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 |website-url|_ for more details.

For further enquiries, please |email|_ or |leavemessage|_ and we can discuss the specifics of your situation.

Partnership Opportunities
=========================

We're always looking for new partners to help us test and provide feedback on our projects. If you're
interested in partnering with us, please |email|_ or |leavemessage|_.

🎉 Excited to announce that we've partnered with `Software.com.br`_ to expand SimpleBLE's reach in LATAM!

**Technical Partnerships:** We're seeking design partners to test and provide feedback on our Rust bindings,
Java bindings, and Linux peripheral functionality. Partners will receive exclusive discounts and perks for
their contributions!

**Business Partnerships:** We're looking for partners in Asia to support targeted regional sales and support.
Join us to expand SimpleBLE's reach!

----

**SimpleBLE** is a project powered by |caos|_.

.. Links

.. |email| replace:: email us
.. _email: mailto:contact@simpleble.org

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

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

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

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

.. |Announcements| replace:: Announcements
.. _Announcements: https://simpleble.org/blog/news?utm_source=github&utm_medium=referral&utm_campaign=simpleble_readme

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

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

.. _SimpleBluez: https://github.com/simpleble/simpleble/tree/main/simplebluez

.. _SimpleDBus: https://github.com/simpleble/simpleble/tree/main/simpledbus

.. _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.io/en/latest

.. _Software.com.br: https://software.com.br/

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