BlueHydra is a Bluetooth device discovery service built on top of the
bluez library. BlueHydra makes use of ubertooth where available and attempts to track both classic and low energy (LE) bluetooth devices over time.
On a Pwnie Express sensor this will be installed as a system service with the regular updates.
On non Pwnie Express systems the files in this repository can be run directly.
Ensure that the following packages are installed:
bluez-utils bluez-test-scripts python-bluez python-dbus ubertooth # where applicable sqlite3
In addition to the Bluetooth packages listed above you will need to have Ruby version 2.1 or higher installed. With ruby installed add the
bundler gem and then run
bundle install inside the checkout directory.
Once all dependencies are met simply run
./bin/blue_hydra to start discovery. If you experience gem inconsistency try running
bundle exec ./bin/blue_hydra instead.
There are a few flags that can be passed to this script:
--daemonize: suppress CLI output and run in background
--demo: run with CLI output but mask displayed macs for demo purposes
--pulse: attempt to send data to Pwn Pulse
BlueHydra should function with most internal bluetooth cards but we recommend using the Sena UD100 adapter.
Additionally you can make use of Ubertooth One hardware to detect active devices not in discoverable mode.
Note: using an Ubertooth One is not a replacement for a conventional bluetooth dongle.
The config file is located in
/opt/pwnix/pwnix-config/blue_hydra.yml on Pwnie devices. On systems which do no have the /opt/pwnix/pwnix-config directory the service will default to looking in the root of the services directory (where this README file is located. It will still be called
The following options can be set:
log_level: defaults to info level, can be set to debug for much more verbosity. If set to
falseno log or rssi log will be created.
bt_device: specify device to use as main bluetooth interface, defaults to
info_scan_rate: rate at which to run info scan in seconds, defaults to 60
status_sync_rate: rate at which to sync device status to Pulse in seconds
true|false, if set to true will log filtered btmon output
true|false, if set to true will log unfiltered btmon output
file: if set to a filepath that file will be read in rather than doing live device interactions
true|false, if set will log serialized RSSI values
true|false, if set will agressively send RSSIs to Pulse
Helping with Development
PR's should be targeted against the "develop" branch. Develop branch gets merged to master branch and tagged during the release process.