Skip to content

knightconnorp/BlueS.py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
 
 
 
 
 
 
 
 

Repository files navigation

BlueS.py

BlueS.py - Bluetooth Low Energy (BLE) Sniffer

Displays MAC Address, RSSI, Device Name, Company, and Last Seen Time in one simple table
Ability to save table as CSV for later analysis and viewing

Steps

Step 1 - Connect Alfa Card (or alternative BLE adapter)
Step 2 - Use 'iwconfig' (on linux) to ensure your device is detecting your wireless card
Step 3 - (If execution bit not set) chmod +x BlueS.py
Step 4 - Run as sudo/root

Options

-h OR --help Help menu
-o Save output as CSV on exit
-n Must broadcast name of device
-c Must broadcast device manufacturer
-m <mac_address> Hunt on a specific mac address, highlights in RED
-i <hci_interface> Specify hci interface to use in scan
-s <scan_length> Specify scan length in seconds

Dependencies

Run these commands in your linux environment

sudo apt-get install build-essential libglib2.0-dev python3 pip python3-dev
pip install bluepy prettytable

Screenshot of BlueS.py running Screenshot of BlueS.py running