/humble-explorer

Cross-platform, command-line and human-friendly Bluetooth Low Energy scanner

Primary LanguagePythonMIT LicenseMIT

Continuous Integration Python package version Supported Python versions Documentation Status Codecov coverage License

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

Documentation

Read HumBLE Explorer's online documentation.

Learn more about Bluetooth Low Energy development

If you want to learn more about Bluetooth Low Energy development, read the 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.

License

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