op-drone / sniffletokismet

Proxy tool that bridges the gap between the Sniffle Bluetooth 5 long range extended sniffing and Kismet's ANTSDR capture mechanism. This tool allows users to utilize a Sniffle compatible dongle to detect Bluetooth 5 long range extended packets and relay them to Kismet through a ZMQ to TCP proxy.

SniffleToKismet

SniffleToKismet is a proxy tool that bridges the gap between the Sniffle Bluetooth 5 long range extended sniffing and Kismet's ANTSDR capture mechanism. This tool allows users to utilize a Sniffle compatible dongle to detect Bluetooth 5 long range extended packets and relay them to Kismet through a ZMQ to TCP proxy.

Features

• Leverages the Sniffle fork from Sniffle GitHub.
• Supports ZeroMQ (ZMQ) for data transmission.
• Converts ZMQ messages to a format (mostly) compatible with Kismet's ANTSDR capture tool.
• Provides some integration with Kismet for Bluetooth Remote ID drone detection and monitoring.

Requirements

• Sniffle compatible dongle
• Kismet
• Python 3

Setup and Usage

1. Clone the Sniffle fork:

   git clone https://github.com/bkerler/Sniffle

2. Run the Sniffle receiver:

   python3 Sniffle/python_cli/sniff_receiver.py -l -e -z --zmqhost 0.0.0.0 --zmqport 12345

   This command configures the Sniffle dongle to look for Bluetooth 5 long range extended packets.

3. Start the SniffleToKismet proxy with the correct ZMQ details:

   python3 sniffletokismet.py --zmq-host 0.0.0.0 --zmq-port 12345 --tcp-host 0.0.0.0 --tcp-port 9876

4. Start Kismet

   kismet

5. Start the Kismet capture tool:

   kismet_cap_antsdr_droneid --source antsdr-droneid:host=0.0.0.0,port=9876 --connect localhost:3501 --tcp

How It Works

• The Sniffle compatible dongle captures Bluetooth 5 long range extended packets.
• The captured packets are sent to the Sniffle receiver script which forwards them via ZeroMQ (ZMQ).
• The SniffleToKismet proxy receives the ZMQ messages and translates them into a format compatible with Kismet's ANTSDR capture tool.
• Kismet processes the data and provides enhanced drone detection and monitoring.

License

This project is licensed under the MIT License. See the LICENSE file for details.