Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/koenvervloesem/humble-explorer

Cross-platform, command-line and human-friendly Bluetooth Low Energy scanner
https://github.com/koenvervloesem/humble-explorer

ble ble-scanner bleak bluetooth bluetooth-le bluetooth-low-energy cli python python3 textual tui

Last synced: 19 days ago
JSON representation

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

Awesome Lists containing this project

README

        

.. image:: https://github.com/koenvervloesem/humble-explorer/workflows/tests/badge.svg
:alt: Continuous Integration
:target: https://github.com/koenvervloesem/humble-explorer/actions
.. image:: https://img.shields.io/pypi/v/humble-explorer.svg
:alt: Python package version
:target: https://pypi.org/project/humble-explorer/
.. image:: https://img.shields.io/pypi/pyversions/humble-explorer.svg
:alt: Supported Python versions
:target: https://python.org/
.. image:: https://readthedocs.org/projects/humble-explorer/badge/?version=latest
:target: https://humble-explorer.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://codecov.io/gh/koenvervloesem/humble-explorer/branch/main/graph/badge.svg?token=YE57XF55FF
:alt: Codecov coverage
:target: https://codecov.io/gh/koenvervloesem/humble-explorer
.. image:: https://img.shields.io/github/license/koenvervloesem/humble-explorer.svg
:alt: License
:target: https://github.com/koenvervloesem/humble-explorer/blob/main/LICENSE.txt

|

.. inclusion-marker-after-badges

===============
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.

.. image:: https://github.com/koenvervloesem/humble-explorer/raw/main/docs/_static/screenshot.png
:alt: 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.