Metadata-Version: 2.1
Name: humble-explorer
Version: 0.3.0
Summary: Cross-platform, command-line and human-friendly Bluetooth Low Energy Explorer
Home-page: https://github.com/koenvervloesem/humble-explorer/
Author: Koen Vervloesem
Author-email: koen@vervloesem.eu
License: MIT
Project-URL: Documentation, https://humble-explorer.readthedocs.io/
Project-URL: Source, https://github.com/koenvervloesem/humble-explorer/
Project-URL: Changelog, https://github.com/koenvervloesem/humble-explorer/blob/main/CHANGELOG.rst
Project-URL: Tracker, https://github.com/koenvervloesem/humble-explorer/issues
Project-URL: Download, https://pypi.org/project/humble-explorer/#files
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Utilities
Description-Content-Type: text/x-rst; charset=UTF-8
Provides-Extra: testing
License-File: LICENSE.txt

.. 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/ble-explorer/blob/main/LICENSE.txt

|

.. inclusion-marker-start-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.

.. inclusion-marker-stop-description

.. image:: docs/_static/screenshot.png
    :alt: Human-friendly Bluetooth Low Energy Explorer in action

.. inclusion-marker-start-readme-in-docs

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 <https://humble-explorer.readthedocs.io>`_.

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 <https://koen.vervloesem.eu/books/develop-your-own-bluetooth-low-energy-applications/>`_ and the accompanying GitHub repository `koenvervloesem/bluetooth-low-energy-applications <https://github.com/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.
