Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/theengs/explorer
Text user interface to discover BLE devices and show their raw advertisement data and decoded data.
https://github.com/theengs/explorer
ble cli iot sensors textual tui
Last synced: about 17 hours ago
JSON representation
Text user interface to discover BLE devices and show their raw advertisement data and decoded data.
- Host: GitHub
- URL: https://github.com/theengs/explorer
- Owner: theengs
- License: gpl-3.0
- Created: 2022-06-27T07:58:09.000Z (over 2 years ago)
- Default Branch: development
- Last Pushed: 2023-01-15T19:10:56.000Z (almost 2 years ago)
- Last Synced: 2023-03-10T06:12:15.727Z (over 1 year ago)
- Topics: ble, cli, iot, sensors, textual, tui
- Language: Python
- Homepage:
- Size: 304 KB
- Stars: 18
- Watchers: 5
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Theengs Explorer
**Theengs Explorer** is a text user interface to discover BLE devices and show their raw advertisement data and decoded data. It leverages the [Theengs Decoder](https://github.com/theengs/decoder) library. It decodes data from a wide range of BLE sensors; LYWSD03MMC, CGD1, CGP1W, H5072, H5075, H5102, TH1, TH2, BBQ, CGH1, CGDK2, CGPR1, RuuviTag, WS02, WS08, TPMS, MiScale, LYWSD02, LYWSDCGQ, MiFlora, ...
Theengs Explorer is still in early development. To try the development version, install its dependencies [Theengs Decoder](https://decoder.theengs.io/use/python.html), [Textual](https://github.com/Textualize/textual), [bluetooth-numbers](https://github.com/koenvervloesem/bluetooth-numbers) and [humanize](https://github.com/python-humanize/humanize) and run it like this:
```shell
python3 TheengsExplorer/__init__.py
```
You can use some optional arguments:
```shell
$ python3 TheengsExplorer/__init__.py --help
usage: __init__.py [-h] [-a ADAPTER] [-s {active,passive}] [-t {celsius,fahrenheit}]
optional arguments:
-h, --help show this help message and exit
-a ADAPTER, --adapter ADAPTER
Bluetooth adapter (e.g. hci1 on Linux)
-s {active,passive}, --scanning-mode {active,passive}
Scanning mode (default: active)
-t {celsius,fahrenheit}, --temperature-unit {celsius,fahrenheit}
Temperature unit (default: celsius)
```
Passive scanning only works on Windows or Linux kernel >= 5.10 and BlueZ >= 5.56 with experimental features enabled.
To enable experimental features in BlueZ on a Linux distribution that uses systemd, run the following command:
```shell
sudo systemctl edit bluetooth.service
```
Then add the following lines:
```
[Service]
ExecStart=
ExecStart=/usr/lib/bluetooth/bluetoothd --experimental
```
Save and close the file and then run the following commands:
```
sudo systemctl daemon-reload
sudo systemctl restart bluetooth.service
```
Note that currently Theengs Explorer has only been tested on Linux, but all libraries it depends on work on Linux, Windows and macOS. If you try it on Windows and macOS and you encounter problems, please let us know in an [issue](https://github.com/theengs/explorer/issues) or a [discussion](https://github.com/theengs/explorer/discussions/4).