Skip to main content

Add a short description here!

Project description

PyPI-Server Project generated with PyScaffold

HumBLE Explorer

Human-friendly Bluetooth Low Energy Explorer

This is a cross-platform (Windows, Linux, macOS) human-friendly program to scan for Bluetooth Low Energy (BLE) advertisements on the command line. It’s mostly useful for people who develop BLE software or want to debug problems with BLE devices.

Human-friendly Bluetooth Low Energy Explorer in action

Installation

You can install HumBLE Explorer as a pip package from PyPI:

pip install humble-explorer

Usage

HumBLE Explorer understands some command-line arguments, which you can see with the --help option:

humble-explorer --help

Making Changes & Contributing

This project uses pre-commit, please make sure to install it before making any changes:

pip install pre-commit
cd humble-explorer
pre-commit install

It is a good idea to update the hooks to the latest version:

pre-commit autoupdate

Don’t forget to tell your contributors to also install and use pre-commit.

Debugging code

You can debug HumBLE Explorer with Textual’s debug console.

To use the console, open up two terminal emulators. Run the following in one of the terminals:

textual console

You should see the Textual devtools welcome message.

In the other console, run HumBLE Explorer with:

TEXTUAL=devtools python3 src/humble_explorer/__main__.py

Learn more about Bluetooth Low Energy development

If you want to learn more about Bluetooth Low Energy development, read my book Develop your own Bluetooth Low Energy Applications for Raspberry Pi, ESP32 and nRF52 with Python, Arduino and Zephyr and the accompanying GitHub repository koenvervloesem/bluetooth-low-energy-applications.

Note

This project has been set up using PyScaffold 4.3.1. For details and usage information on PyScaffold see https://pyscaffold.org/.

License

This project is provided by Koen Vervloesem as open source software with the MIT license. See the LICENSE file for more information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

humble-explorer-0.1.0.tar.gz (252.7 kB view details)

Uploaded Source

Built Distribution

humble_explorer-0.1.0-py3-none-any.whl (8.3 kB view details)

Uploaded Python 3

File details

Details for the file humble-explorer-0.1.0.tar.gz.

File metadata

  • Download URL: humble-explorer-0.1.0.tar.gz
  • Upload date:
  • Size: 252.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.6

File hashes

Hashes for humble-explorer-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b002934d932d8903cba177639d2d4b4fd2a48a949b6b4102593f534321f65935
MD5 3c77451a69bc05ec677c717e685cdf3c
BLAKE2b-256 44414ad70762681dff3cf9008a604e2ad47476774bfa1749b476a22cc540bee5

See more details on using hashes here.

File details

Details for the file humble_explorer-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for humble_explorer-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fd826ecd8e2a4e8d62926f0af11f7f20ba4952a65eb99416ead29644da4f1df2
MD5 799cece1ec240aed5ee11dc2555fa121
BLAKE2b-256 8696100c37ab380192cb76a8a028b473117855a7b08be1222c947ab6586c109e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page