A Bluetooth Low Energy device scanner and analyzer.

Available on Linux, macOS, Windows.

Features

• Bluetooth host adapters info
• RSSI graph / proximity graph (BLE and classic)
• Device scanner (BLE and classic)
• Device advertisement and services explorer (BLE)
• Read/write on device characteristics (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.8+ with the following 'additional librairies':

• Qt Connectivity
• Qt Charts

For macOS builds, you'll need Xcode (15+) installed.
For Windows builds, you'll need the MSVC (2022) installed. Bluetooth won't work with MinGW.

Building toolBLEx

$ git clone https://github.com/emericg/toolBLEx.git
$ cd toolBLEx/
$ cmake -B build/
$ cmake --build build/

Using toolBLEx

Linux

Bluetooth driver support might be a little shaky...

• Apple iBeacons are hidden by the OS and don't appear in scan results?

macOS

macOS has various limitations regarding Bluetooth handling:

• 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
• MAC addresses are hidden by the OS, and replaced by randomly generated UUIDs, making proper device identification hard

Starting with macOS 11, the application will ask you for permission to use Bluetooth. You can learn more on Apple developer website.

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 (LGPL v3)
• SingleApplication (MIT)
• Graphical resources: 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 file or consult the license on the FSF website directly.

Emeric Grange [email protected]