Skip to content

VirusFriendly/GobBLE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GobBLE's Logo

GobBLE

Binder

This Jupyter notebook analyzes the RaMBLE database to enumerate new BLE devices and technologies that the analyst may wish to investigate, by reporting device indicators not previously recorded.

Preview

A static preview can be found here

A dynamic preview can be seen on Binder

Get Started

If you're unfamiliar with using Jupyter notebooks, here's a simple tutorial

This notebook depends on the database exported by RaMBLE, a passive BLE scanner for Android devices.

Export the RaMBLE database and copy it to the location with the notebook as RaMBLE.sqlite and then use the Jupyter notebook as normal.

Binder Support

Binder allows you to view Jupyter notebooks online. If you would like view this notebook but with your database using Binder, you'll need to have your database accessible online (like Google Drive if you know this trick). Fork this repo, and then change the URL in the postBuild file to location of your database. Then submit your repo to MyBinder.org.

CAUTION

The RaMBLE database contains location data, which people can use to track your where-abouts and possibly the location of your home, school, or workplace. If you're concerned about sharing your location data, run the droplocation.py provided in the extras directory.

Example:

With the database in the current directory:

python3 droplocation.py

or provide the script the location (on your computer) of the database

python3 droplocation.py ~/Downloads/RaMBLE.sqlite

Additionally, the RaMBLE database can also contain non-randomized MAC addresses, which people can also use to track your where-abouts. As this notebook file uses these addresses, an address stripper that doesn't break notebook functionality is in the works, but currently not included. Post your databases at your own risk.

Google Maps support

To enable heatmaps of stationary devices, save your Google Maps Javascript SDK API Key in the file gmaps_api.key