{"id":18327893,"url":"https://github.com/theengs/explorer","last_synced_at":"2025-04-06T01:32:13.914Z","repository":{"id":41172039,"uuid":"507815585","full_name":"theengs/explorer","owner":"theengs","description":"Text user interface to discover BLE devices and show their raw advertisement data and decoded data.","archived":false,"fork":false,"pushed_at":"2023-01-15T19:10:56.000Z","size":311,"stargazers_count":27,"open_issues_count":2,"forks_count":4,"subscribers_count":6,"default_branch":"development","last_synced_at":"2025-03-21T15:11:01.381Z","etag":null,"topics":["ble","cli","iot","sensors","textual","tui"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theengs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-06-27T07:58:09.000Z","updated_at":"2024-12-31T01:34:45.000Z","dependencies_parsed_at":"2023-02-09T23:30:55.646Z","dependency_job_id":null,"html_url":"https://github.com/theengs/explorer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fexplorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fexplorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fexplorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theengs%2Fexplorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theengs","download_url":"https://codeload.github.com/theengs/explorer/tar.gz/refs/heads/development","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247423476,"owners_count":20936621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ble","cli","iot","sensors","textual","tui"],"created_at":"2024-11-05T19:12:32.907Z","updated_at":"2025-04-06T01:32:12.140Z","avatar_url":"https://github.com/theengs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Theengs Explorer\n\n**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, ...\n\n![Screenshot](screenshot.png)\n\nTheengs 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:\n\n```shell\npython3 TheengsExplorer/__init__.py\n```\n\nYou can use some optional arguments:\n\n```shell\n$ python3 TheengsExplorer/__init__.py --help\nusage: __init__.py [-h] [-a ADAPTER] [-s {active,passive}] [-t {celsius,fahrenheit}]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -a ADAPTER, --adapter ADAPTER\n                        Bluetooth adapter (e.g. hci1 on Linux)\n  -s {active,passive}, --scanning-mode {active,passive}\n                        Scanning mode (default: active)\n  -t {celsius,fahrenheit}, --temperature-unit {celsius,fahrenheit}\n                        Temperature unit (default: celsius)\n```\n\nPassive scanning only works on Windows or Linux kernel \u003e= 5.10 and BlueZ \u003e= 5.56 with experimental features enabled.\n\nTo enable experimental features in BlueZ on a Linux distribution that uses systemd, run the following command:\n\n```shell\nsudo systemctl edit bluetooth.service\n```\n\nThen add the following lines:\n\n```\n[Service]\nExecStart=\nExecStart=/usr/lib/bluetooth/bluetoothd --experimental\n```\n\nSave and close the file and then run the following commands:\n\n```\nsudo systemctl daemon-reload\nsudo systemctl restart bluetooth.service\n```\n\nNote 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).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheengs%2Fexplorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheengs%2Fexplorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheengs%2Fexplorer/lists"}