Giter Club home page Giter Club logo

toolblex's Introduction

toolBLEx

GitHub release GitHub action GitHub issues License: GPL v3

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

Download on Flathub

Screenshots

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

Frequency analyzer (with an Ubertooth One)

frequency analyzer

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

$ 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.

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

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]

toolblex's People

Contributors

emericg avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.