SimplePyBLE
===========

The ultimate cross-platform bindings for Bluetooth Low Energy (BLE).

|Latest Documentation Status| |PyPI Licence|

Overview
--------

SimplePyBLE provides Python bindings for `SimpleBLE`_, a fully cross-platform BLE library,
designed for simplicity and ease of use, with a consistent behavior and API across all platforms.

SimplePyBLE runs on Windows 10+, Linux (Ubuntu 20.04+) and MacOS 10.15+ (Catalina and newer).

**Commercial licensing is available for projects requiring proprietary distribution.**

If you want to use SimplePyBLE and need help. **Please do not hesitate to reach out!**

* Visit our `ReadTheDocs`_ page for comprehensive documentation.
* Visit our `website`_ or email us at `email us <mailto:contact@simpleble.org>`_ for commercial licensing and professional support services.
* Join our `Discord`_ server for community discussions and help.

Installation
------------

You can install SimplePyBLE from PyPI using pip: ::

   pip install simplepyble

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

License
=======

Since February 15th 2024, SimpleBLE is now available under the GNU General Public License
version 3 (GPLv3), with the option for a commercial license without the GPLv3 restrictions
available for a fee.

**You can find more information on pricing and commercial terms of service on our `website`_.**

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

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

.. Links

.. _website: https://simpleble.org

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

.. _SimpleBLE: https://github.com/OpenBluetoothToolbox/SimpleBLE/

.. _code examples: https://github.com/OpenBluetoothToolbox/SimpleBLE/tree/main/examples/simplepyble

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

.. |PyPI Licence| image:: https://img.shields.io/pypi/l/simplepyble
