gearkite/wigleanalyzer

Wigle Analyzer

Analyzes Wigle database exports

Installation

From Source

1. Clone the Git repository
   git clone https://github.com/GearKite/WigleAnalyzer.git

2. Enter the directory
   cd WigleAnalyzer

3. Install the package

   • Using Python Poetry:
     1. Install the package and dependencies
        poetry install
     2. Enter the virtual environment
        poetry shell
   • Using Pip:
     1. Create a virtual environment
        python -m venv .venv
     2. Activate the virtual environment
        source .venv/bin/activate
     3. Install the package and dependencies
        pip install .

Usage

$ wigle_analyzer -h
usage: Wigle Analyzer [-h] -i INPUT_FILE [-o OUTPUT_FILE] [-f {csv,sqlite}] -a {geojson_map,max_distances,point_maps} [-b] [-m MAC] [-v] [-q]

Analyzes Wigle database exports

options:
  -h, --help            show this help message and exit
  -i INPUT_FILE, --input_file INPUT_FILE
  -o OUTPUT_FILE, --output_file OUTPUT_FILE
  -f {csv,sqlite}, --input_format {csv,sqlite}
  -a {geojson_map,max_distances,point_maps}, --analyzer {geojson_map,max_distances,point_maps}
  -b, --keep-bad-entries
  -m MAC, --mac MAC     Centers output on a specific MAC address
  -v, --verbose
  -q, --quiet

Examples

• Find the networks and devices which have traveled the furthest (max distance between 2 seen locations) and write that to a text file:

  $ wigle_analyzer -i my-db-export.sqlite -a max_distances -o out.txt

• Create a GeoJSON map of locations a specific network has been seen:

  $ wigle_analyzer -i my-csv-export.csv -a geojson_map -m xx:xx:xx:xx:xx:xx -o locations.geojson

Make sure to have patience if your exports are large ^^