humble-explorer 0.1.1

Add a short description here!

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.

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.