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.1.tar.gz (252.7 kB view details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: humble-explorer-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 db46505ef06ab5dc76a861a035d2e1e221650de5254d6e00e7ac8e5c9b731a24
MD5 a818198c92c3f95e1b4a6774bfe4f0db
BLAKE2b-256 b2b663d4248407963922d3ba73e1b9d6e183e2db53b935b2d0d0b0607f852520

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for humble_explorer-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 50fceffd1c3caee39f22ec49478c4a2aaab0e2c3d371a3a5b2b200a50e235a80
MD5 7f8d956247165b0dcce5d66231f918b3
BLAKE2b-256 3fd6cb1b406258f8d051176cac17fb534970613f69b86867ca55ce82db9c4278

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