https://github.com/emericg/toolBLEx
A multiplatform Bluetooth Low Energy (and Classic) device scanner and analyzer.
https://github.com/emericg/toolBLEx
bluetooth bluetooth-low-energy ubertooth
Last synced: 5 months ago
JSON representation
A multiplatform Bluetooth Low Energy (and Classic) device scanner and analyzer.
- Host: GitHub
- URL: https://github.com/emericg/toolBLEx
- Owner: emericg
- License: gpl-3.0
- Created: 2022-09-01T16:10:54.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-20T15:12:59.000Z (6 months ago)
- Last Synced: 2024-12-20T16:27:46.671Z (6 months ago)
- Topics: bluetooth, bluetooth-low-energy, ubertooth
- Language: QML
- Homepage:
- Size: 2.14 MB
- Stars: 196
- Watchers: 11
- Forks: 16
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# 
[](https://github.com/emericg/toolBLEx/releases)
[](https://github.com/emericg/toolBLEx/actions/workflows/builds_desktop_qmake.yml)
[](https://github.com/emericg/toolBLEx/issues)
[](http://www.gnu.org/licenses/gpl-3.0)
A Bluetooth Low Energy device scanner and analyzer.
> Available on Linux, macOS, Windows.
#### Features
- host adapters info
- RSSI graph / proximity graph (BLE and classic)
- device scanner (BLE and classic)
- device advertisement and services explorer (BLE)
- read/write device services data (BLE)
- export device info: advertisement packets, services and characteristics (with or without values)
- frequency analyzer (ONLY if you have an Ubertooth One)
#### Download
## Screenshots
## Frequency analyzer (with an Ubertooth One)
## Documentation
#### Build dependencies
You will need a C++17 compiler and Qt 6.5+ with the following 'additional librairies':
- Qt Connectivity
- Qt Charts
For Windows builds, you'll need the MSVC 2019+ compiler. Bluetooth won't work with MinGW.
For macOS builds, you'll need Xcode 14+ installed.
#### Building toolBLEx
```bash
$ git clone https://github.com/emericg/toolBLEx.git
$ cd toolBLEx/
$ qmake6
$ make
```
#### Using toolBLEx
##### Linux
Double click.
##### macOS
macOS has various limitations regarding Bluetooth handling:
- MAC addresses are hidden by the OS, and replaced by randomly generated UUIDs, making proper device identification hard
- Apple iBeacons are hidden by the OS and don't appear in scan results
- Bluetooth Classic scanning doesn't seem to work at the moment
Starting with macOS 11, the application will ask you for permission to use Bluetooth. You can learn more on Apple [developer website](https://developer.apple.com/documentation/bundleresources/information_property_list/nsbluetoothalwaysusagedescription).
##### Windows
Bluetooth driver support might be a little shaky...
Windows doesn't have good enough support for the Ubertooth One, and thus the frequency analyzer is disabled.
#### Third party projects used by toolBLEx
* [Qt6](https://www.qt.io) ([LGPL v3](https://www.gnu.org/licenses/lgpl-3.0.txt))
* [SingleApplication](https://github.com/itay-grudev/SingleApplication) ([MIT](https://opensource.org/licenses/MIT))
* Graphical resources: [assets/COPYING](assets/COPYING)
## Get involved!
#### Developers
You can browse the code on the GitHub page, submit patches and pull requests! Your help would be greatly appreciated ;-)
#### Users
You can help us find and report bugs, suggest new features, help with translation, documentation and more! Visit the Issues section of the GitHub page to start!
## License
toolBLEx is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
Read the [LICENSE](LICENSE.md) file or [consult the license on the FSF website](https://www.gnu.org/licenses/gpl-3.0.txt) directly.
> Emeric Grange