How to install BLEAH on Kali Linux

in security, opensource, bluetooth

A few days ago, Simone Margaritelli aka evilsocket released BLEAH, a BLE (Bluetooth Low Energy, or Bluetooth Smart) scanner and device enumerator that is incredibly simple to use.

I just played around with it and documented the installation steps on the most recent Kali Linux.

BLEAH in action

I will not cover how to use BLEAH. Read Simone's introductory blog post and the README for that.

Hardware requirements

You don't need special Bluetooth equipment like the Ubertooth One to use BLEAH. Any onboard Bluetooth chip should do. I am using a $10 USB dongle that supports BLE (most do) because the onboard chip of my MacBook was not working through VirtualBox.


Let's start by installing some dependencies and useful Bluetooth related tools:

$ sudo apt update
$ sudo apt install python-pip libglib2.0-dev git bluez

Next, install setuptools for Python, which is required for the installation of BLEAH and the underlying Bluetooth library.

$ pip install -U pip setuptools

Now, install bluepy:

$ git clone
$ cd bluepy
$ python build
$ sudo python install

Once that finished, you can install BLEAH itself:

$ cd .. # if you are still in bluepy/ directory
$ git clone
$ cd bleah
$ python build
$ sudo python install

Running BLEAH

With BLEAH and its dependencies installed, you can go on and run it. Let's make sure your Bluetooth adapter is detected.

$ sudo hciconfig
hci0:    Type: Primary  Bus: USB
    BD Address: 5C:F3:70:83:0E:9A  ACL MTU: 1021:8  SCO MTU: 64:1
    RX bytes:882 acl:0 sco:0 events:36 errors:0
    TX bytes:386 acl:0 sco:0 commands:36 errors:0

Success! We have one Bluetooth adapter called hci0. Note that its status is DOWN.

If your adapter is DOWN, go ahead and activate it:

$ sudo hciconfig hci0 up
$ sudo hciconfig 
hci0:    Type: Primary  Bus: USB
    BD Address: 5C:F3:70:83:0E:9A  ACL MTU: 1021:8  SCO MTU: 64:1
    RX bytes:1456 acl:0 sco:0 events:66 errors:0
    TX bytes:754 acl:0 sco:0 commands:66 errors:0

That looks better. Now you can go ahead and run BLEAH. Follow Simone's instructions for more examples and use-cases.

$ sudo bleah -t0

Running BLEAH

Have fun! 🤠