https://github.com/scipag/btle-sniffer

Passively scan for Bluetooth Low Energy devices and attempt to fingerprint them
https://github.com/scipag/btle-sniffer

bluetooth bluetooth-low-energy security security-audit security-hardening security-protocol security-scanner security-vulnerability sniffer sniffing wireless wireless-communication wireless-network

Last synced: 3 months ago
JSON representation

Passively scan for Bluetooth Low Energy devices and attempt to fingerprint them

• Host: GitHub
• URL: https://github.com/scipag/btle-sniffer
• Owner: scipag
• License: mit
• Created: 2017-03-15T07:25:16.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-07-04T14:51:53.000Z (over 1 year ago)
• Last Synced: 2024-06-16T15:02:48.023Z (5 months ago)
• Topics: bluetooth, bluetooth-low-energy, security, security-audit, security-hardening, security-protocol, security-scanner, security-vulnerability, sniffer, sniffing, wireless, wireless-communication, wireless-network
• Language: Python
• Size: 84 KB
• Stars: 141
• Watchers: 8
• Forks: 40
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-network-stuff - **64**星

README

        
# BTLE-Sniffer

This is a simple Python 3.5+ utility for monitoring Bluetooth Low Energy 

traffic and to register devices. Thanks to D-Bus, it does not require

elevated privileges to be run!

## Dependencies

As this project relies on BlueZ, it will only run on Linux

systems. The project further requires GLib2, PyGobject (commonly known as

python-gi, python-gobject or pygobject, but not packaged on PyPi) and D-Bus.

## Installing

You can now use `pip` or `setuptools` to install the package:

    $ pip install -U git+https://github.com/scipag/btle-sniffer.git

## Usage

    usage: btlesniffer [-h] [-V] [-v] [-d] [-o OUT_PATH] [-i BACKUP_INTERVAL] [-r]

                       [-c] [--threshold-rssi THRESHOLD_RSSI]

                       [--connection-polling-interval CONNECTION_POLLING_INTERVAL]

    Scan for Bluetooth Low Energy devices and gather information about them. This

    program will only run on Linux systems.

    optional arguments:

      -h, --help            show this help message and exit

      -V, --version         display version information and exit

      -v, --verbose         increase the verbosity of the program

      -d, --debug           enable debugging features

      -o OUT_PATH, --out-path OUT_PATH

                            path to the device registry backup

      -i BACKUP_INTERVAL, --backup-interval BACKUP_INTERVAL

                            how frequently the device registry backup should be

                            written (in seconds, default 5 s). If set to zero, the

                            backup will be written with every device update.

      -r, --resume          resume from a previous device registry backup (must

                            specify the `-o` option)

      -c, --connect         attempt to connect to all discovered Bluetooth devices

      --threshold-rssi THRESHOLD_RSSI

                            the lower bound received signal strength (RSSI) at

                            which to attempt to connect to devices (in dBa,

                            default -80 dBa).

      --connection-polling-interval CONNECTION_POLLING_INTERVAL

                            how frequently the sniffer shall go through the device

                            registry and attempt to establish connections (in

                            seconds, default 5 s).