https://github.com/matthewelse/bleep

Python BLE Library for Linux and OS X
https://github.com/matthewelse/bleep

Last synced: 2 days ago
JSON representation

Python BLE Library for Linux and OS X

• Host: GitHub
• URL: https://github.com/matthewelse/bleep
• Owner: matthewelse
• License: apache-2.0
• Created: 2015-08-19T18:07:21.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-09-03T22:29:45.000Z (5 months ago)
• Last Synced: 2025-01-16T12:31:38.981Z (9 days ago)
• Language: Python
• Homepage:
• Size: 86.9 KB
• Stars: 33
• Watchers: 5
• Forks: 11
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# bleep

[![CI](https://github.com/matthewelse/bleep/actions/workflows/CI.yml/badge.svg)](https://github.com/matthewelse/bleep/actions/workflows/CI.yml)

A BLE abstraction layer for Python. This library is a wrapper around the

`btleplug` rust library, and supports Windows, Linux and macOS.

## Current Support

* Discovering devices

* Reading advertising data

* Connecting to devices

* Discovering services, characteristics and descriptors

* Read from and writing to characteristics

## Installation

```bash

pip install bleep

```

If you want to develop bleep, instead of the last line, clone the repo and run:

```

git clone https://github.com/matthewelse/bleep

pip install maturin

maturin develop 

```

## Examples

### tree.py

You can run tree.py to see all of the services, characteristics and descriptors

attached to a device with a specific name. In order to find the device's name

address, you could use `hcitool lescan`, or use `BLEDevice.discoverDevices()`.

```

usage: tree.py [-h] name 

```

## Usage

See examples/ for examples of how to use this library.