by greatscottgadgets

greatscottgadgets / libbtbb

A Bluetooth baseband decoding library

128 Stars 72 Forks Last release: almost 2 years ago (2018-12-R1) GNU General Public License v2.0 348 Commits 13 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


This is the Bluetooth baseband decoding library, forked from the GR-Bluetooth project. It can be used to extract Bluetooth packet and piconet information from Ubertooth devices as well as GR-Bluetooth/USRP.

This code is incomplete, it is still under active development. Patches and bug reports should be submitted to the bug tracker on GitHub:

This software has been developed and tested on Linux, it should work on other platforms but this has yet to be tested.

Build Instructions

Libbtbb can be built and installed as follows:

$ mkdir build
$ cd build
$ cmake ..
$ make
$ sudo make install

This will install the library to /usr/local/lib and the headers to /usr/local/include, to install to different locations use:

$ cmake -DINSTALL_DIR=/path/to/install -DINCLUDE_DIR=/path/to/include ..

If you have previous versions of libbtbb, libubertooth or the Ubertooth tools installed, you can use the cleanup script to remove them:

$ sudo cmake/ -d

To list the installed files without removing them, use:

$ cmake/

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.