Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time


GitHub release GitHub action GitHub issues License: GPL v3

A Bluetooth Low Energy device scanner and analyzer.

Available on Linux, macOS, Windows.

  • 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 walues)
  • frequency analyzer (ONLY if you have an Ubertooth One)


Bluetooth scanner BLE device info BLE device advertisement BLE device service read GUI dark mode

Frequency analyzer (with an Ubertooth One)

frequency analyzer


Build dependencies

You will need a C++17 compiler and Qt 6.5+ with the following 'additional librairies':

  • Qt 5 Compatibility Module
  • 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

$ git clone
$ cd toolBLEx/
$ qmake6
$ make

Using toolBLEx


Bluetooth support might be a little shaky?!


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.


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

Get involved!


You can browse the code on the GitHub page, submit patches and pull requests! Your help would be greatly appreciated ;-)


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!


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