Installing Ubertooth One on Backtrack 5

Last Updated: 06/08/11

This guide will help users get the Ubertooth up and running on Backtrack 5. Most of this documentation is from http://ubertooth.sourceforge.net/usage/start/. This in not a "How To" guide for using the Ubertooth. It is simply a tutorial on configuring the Backtrack environment for use with the Ubertooth. Read the documentation on the Ubertooth website and the READMEs accompanying the software for more information on usage. This guide was developed on Backtrack 5, KDE, 32-bit.


First you will need to purchase your Ubertooth. Check to Ubertooth website for location to place an order. If you already have the device, go ahead and plug it into the Backtrack environment.

Download the Ubertooth software in Backtrack from the SVN. This guide assumes the Ubertooth software will be installed in the /pentest/bluetooth directory, however it could be installed in any user defined directory on the host system.

# cd /pentest/bluetooth
# svn co https://ubertooth.svn.sourceforge.net/svnroot/ubertooth ubertooth

Kismet Plugin

Ubertooth comes with a plugin for Kismet. This can be used to capture portions of Bluetooth traffic and identify "Non-Discoverable" Bluetooth device. See Ubertooth documentation for more information.

# cd /pentest/bluetooth/ubertooth/trunk/host/kismet/plugin-ubertooth
# apt-get install libpcre3 libpcre3-dev source-kismet libcap-dev libnl-dev libusb-1.0-0-dev
# git clone git://git.code.sf.net/p/libbtbb/code libbtbb
# cd libbtbb/
# make
# make install
# cd ../
# KIS_SRC_DIR=/var/backtrack/sources/kismet/201103r2/bt0/upstream-sources/kismet make
# KIS_SRC_DIR=/var/backtrack/sources/kismet/201103r2/bt0/upstream-sources/kismet make userinstall

Now edit the kismet configuration file to add "pcapbtbb" to logtypes=.

# vim /usr/local/etc/kismet.conf

Edit the following line.


Now start up Kismet. The -c ubertooth defines the interface to use.

# kismet -c ubertooth

Load the Ubertooth module in Kismet. Click on Kismet -> Plugins -> Select Plugins.


If the modules in not loaded, hit the down arrow and then the spacebar. This should select the module and then load it.


Once the module is "Pending", hit tab twice and select "Close".


Now you should see the traffic from any Bluetooth communication in the proximity. (NOTE: If it dose not work the first time, try replugging the Ubertooth and restarting Kismet.)



The Bluetooth RXTX tools are used to capture and analyze Bluetooth traffic. See Ubertooth documentation for more information. Most of the resources required were installed when setting up the Kismet Plugin.

# cd /pentest/bluetooth/ubertooth/host/bluetooth_rxtx
# make

Test one of the tools to make sure everything compiles file.

# ./ubertooth-lap


Specan UI

Specan UI is a spectrum analyzer. See Ubertooth documentation for more information.

# cd /pentest/bluetooth/ubertooth/host/specan_ui
# add-apt-repository ppa:pyside
# apt-get update
# apt-get install python-pyside.qtgui
# svn co https://pyusb.svn.sourceforge.net/svnroot/pyusb pyusb
# cd pyusb/trunk/
# ./setup.py build
# ./setup.py install
# cd ../../
# python specan_ui.py

(NOTE: If the program does not look similar to the image below, try replugging the Ubertooth.)



Users should now be able to use the Ubertooth to its full potential. Keep the software up-to-date using the SVN. Consult the website and other software documentation for more information.

Have fun!