Add a short description here!
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | db46505ef06ab5dc76a861a035d2e1e221650de5254d6e00e7ac8e5c9b731a24 |
|
MD5 | a818198c92c3f95e1b4a6774bfe4f0db |
|
BLAKE2b-256 | b2b663d4248407963922d3ba73e1b9d6e183e2db53b935b2d0d0b0607f852520 |
File details
Details for the file humble_explorer-0.1.1-py3-none-any.whl
.
File metadata
- Download URL: humble_explorer-0.1.1-py3-none-any.whl
- Upload date:
- Size: 8.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 50fceffd1c3caee39f22ec49478c4a2aaab0e2c3d371a3a5b2b200a50e235a80 |
|
MD5 | 7f8d956247165b0dcce5d66231f918b3 |
|
BLAKE2b-256 | 3fd6cb1b406258f8d051176cac17fb534970613f69b86867ca55ce82db9c4278 |