| Name | bleak JSON |
| Version |
1.1.1
JSON |
| download |
| home_page | None |
| Summary | Bluetooth Low Energy platform Agnostic Klient |
| upload_time | 2025-09-07 18:44:48 |
| maintainer | None |
| docs_url | None |
| author | Henrik Blidh |
| requires_python | >=3.9 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
=====
Bleak
=====
.. image:: https://github.com/hbldh/bleak/workflows/Build%20and%20Test/badge.svg
:target: https://github.com/hbldh/bleak/actions?query=workflow%3A%22Build+and+Test%22
:alt: Build and Test
.. image:: https://img.shields.io/pypi/v/bleak.svg
:target: https://pypi.python.org/pypi/bleak
.. image:: https://img.shields.io/pypi/dm/bleak.svg
:target: https://pypi.python.org/pypi/bleak
:alt: PyPI - Downloads
.. image:: https://readthedocs.org/projects/bleak/badge/?version=latest
:target: https://bleak.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
:target: https://github.com/psf/black
.. container::
.. image:: Bleak_logo2.png
:target: https://github.com/hbldh/bleak
:alt: Bleak Logo
Bleak is an acronym for Bluetooth Low Energy platform Agnostic Klient.
* Free software: MIT license
* Documentation: https://bleak.readthedocs.io.
Bleak is a GATT client software, capable of connecting to BLE devices
acting as GATT servers. It is designed to provide a asynchronous,
cross-platform Python API to connect and communicate with e.g. sensors.
Installation
------------
.. code-block:: bash
$ pip install bleak
Features
--------
* Supports Windows 10, version 16299 (Fall Creators Update) or greater
* Supports Linux distributions with BlueZ >= 5.55
* OS X/macOS support via Core Bluetooth API, from at least OS X version 10.13
* Android backend compatible with python-for-android
Bleak supports reading, writing and getting notifications from
GATT servers, as well as a function for discovering BLE devices.
Usage
-----
To discover Bluetooth devices that can be connected to:
.. code-block:: python
import asyncio
from bleak import BleakScanner
async def main():
devices = await BleakScanner.discover()
for d in devices:
print(d)
asyncio.run(main())
Connect to a Bluetooth device and read its model number:
.. code-block:: python
import asyncio
from bleak import BleakClient
address = "24:71:89:cc:09:05"
MODEL_NBR_UUID = "2A24"
async def main(address):
async with BleakClient(address) as client:
model_number = await client.read_gatt_char(MODEL_NBR_UUID)
print("Model Number: {0}".format("".join(map(chr, model_number))))
asyncio.run(main(address))
DO NOT NAME YOUR SCRIPT ``bleak.py``! It will cause a circular import error.
See examples folder for more code, for instance example code for connecting to a
`TI SensorTag CC2650 <http://www.ti.com/ww/en/wireless_connectivity/sensortag/>`_
Raw data
{
"_id": null,
"home_page": null,
"name": "bleak",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Henrik Blidh",
"author_email": "henrik.blidh@nedomkull.com",
"download_url": "https://files.pythonhosted.org/packages/10/88/6bb2bcb94ef7a2f37c5bd5ec99a4ae9208c4caa3fa6d203f9b601e047e64/bleak-1.1.1.tar.gz",
"platform": null,
"description": "=====\nBleak\n=====\n\n.. image:: https://github.com/hbldh/bleak/workflows/Build%20and%20Test/badge.svg\n :target: https://github.com/hbldh/bleak/actions?query=workflow%3A%22Build+and+Test%22\n :alt: Build and Test\n\n.. image:: https://img.shields.io/pypi/v/bleak.svg\n :target: https://pypi.python.org/pypi/bleak\n\n.. image:: https://img.shields.io/pypi/dm/bleak.svg\n :target: https://pypi.python.org/pypi/bleak\n :alt: PyPI - Downloads\n\n.. image:: https://readthedocs.org/projects/bleak/badge/?version=latest\n :target: https://bleak.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n :target: https://github.com/psf/black\n\n.. container::\n\n .. image:: Bleak_logo2.png\n :target: https://github.com/hbldh/bleak\n :alt: Bleak Logo\n\nBleak is an acronym for Bluetooth Low Energy platform Agnostic Klient.\n\n* Free software: MIT license\n* Documentation: https://bleak.readthedocs.io.\n\nBleak is a GATT client software, capable of connecting to BLE devices\nacting as GATT servers. It is designed to provide a asynchronous,\ncross-platform Python API to connect and communicate with e.g. sensors.\n\nInstallation\n------------\n\n.. code-block:: bash\n\n $ pip install bleak\n\nFeatures\n--------\n\n* Supports Windows 10, version 16299 (Fall Creators Update) or greater\n* Supports Linux distributions with BlueZ >= 5.55\n* OS X/macOS support via Core Bluetooth API, from at least OS X version 10.13\n* Android backend compatible with python-for-android\n\nBleak supports reading, writing and getting notifications from\nGATT servers, as well as a function for discovering BLE devices.\n\nUsage\n-----\n\nTo discover Bluetooth devices that can be connected to:\n\n.. code-block:: python\n\n import asyncio\n from bleak import BleakScanner\n\n async def main():\n devices = await BleakScanner.discover()\n for d in devices:\n print(d)\n\n asyncio.run(main())\n\n\nConnect to a Bluetooth device and read its model number:\n\n.. code-block:: python\n\n import asyncio\n from bleak import BleakClient\n\n address = \"24:71:89:cc:09:05\"\n MODEL_NBR_UUID = \"2A24\"\n\n async def main(address):\n async with BleakClient(address) as client:\n model_number = await client.read_gatt_char(MODEL_NBR_UUID)\n print(\"Model Number: {0}\".format(\"\".join(map(chr, model_number))))\n\n asyncio.run(main(address))\n\nDO NOT NAME YOUR SCRIPT ``bleak.py``! It will cause a circular import error.\n\nSee examples folder for more code, for instance example code for connecting to a\n`TI SensorTag CC2650 <http://www.ti.com/ww/en/wireless_connectivity/sensortag/>`_\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Bluetooth Low Energy platform Agnostic Klient",
"version": "1.1.1",
"project_urls": {
"Changelog": "https://github.com/hbldh/bleak/blob/develop/CHANGELOG.rst",
"Documentation": "https://bleak.readthedocs.io",
"Homepage": "https://github.com/hbldh/bleak",
"Issues": "https://github.com/hbldh/bleak/issues",
"Support": "https://github.com/hbldh/bleak/discussions"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "815ac3378ba7b05abc7c2d95ae492eac0523d937c77afcb9ff7e7f67fe2ca11d",
"md5": "3b2562ccd80b358ea685ec6d2468d2de",
"sha256": "e601371396e357d95ee3c256db65b7da624c94ef6f051d47dfce93ea8361c22e"
},
"downloads": -1,
"filename": "bleak-1.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3b2562ccd80b358ea685ec6d2468d2de",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 136534,
"upload_time": "2025-09-07T18:44:47",
"upload_time_iso_8601": "2025-09-07T18:44:47.525258Z",
"url": "https://files.pythonhosted.org/packages/81/5a/c3378ba7b05abc7c2d95ae492eac0523d937c77afcb9ff7e7f67fe2ca11d/bleak-1.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "10886bb2bcb94ef7a2f37c5bd5ec99a4ae9208c4caa3fa6d203f9b601e047e64",
"md5": "e176e942a79869ee3dc9c16df42cbdd9",
"sha256": "eeef18053eb3bd569a25bff62cd4eb9ee56be4d84f5321023a7c4920943e6ccb"
},
"downloads": -1,
"filename": "bleak-1.1.1.tar.gz",
"has_sig": false,
"md5_digest": "e176e942a79869ee3dc9c16df42cbdd9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 116277,
"upload_time": "2025-09-07T18:44:48",
"upload_time_iso_8601": "2025-09-07T18:44:48.978365Z",
"url": "https://files.pythonhosted.org/packages/10/88/6bb2bcb94ef7a2f37c5bd5ec99a4ae9208c4caa3fa6d203f9b601e047e64/bleak-1.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-07 18:44:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hbldh",
"github_project": "bleak",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "bleak"
}
