Skip to content
A Bluetooth baseband decoding library
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake release: 2018-06-R1 Jun 26, 2018
lib le: handle BT 5.0 long packets May 27, 2018
packaging Update release version in homebrew Feb 26, 2014
python Remove old, unused makefile Mar 3, 2017
tests Add header test Mar 3, 2015
.gitignore Python installations should obey prefixes too Jun 6, 2013
.travis.yml Tidy Travis config to match other projects Dec 17, 2018
CMakeLists.txt Bump SO version and fix some const values Mar 1, 2017
LICENSE create LICENSE: GPLv2 Jun 3, 2018
README.cmake Force PCAP on by default, and remove dependency from cmake Feb 16, 2016 Missing sudo in make install instructions Sep 29, 2015
changelog release: 2018-12-R1 Dec 5, 2018


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/
You can’t perform that action at this time.