Enables remote scanning in WiFi Explorer Pro
Switch branches/tags
Nothing to show
Clone or download
Latest commit 95ea466 Jan 3, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Create LICENSE Jan 3, 2018
README.md Updated it with new script dependencies. Dec 20, 2017
wifiexplorer-sensor.py Update wifiexplorer-sensor.py Jan 3, 2018

README.md

Remote Sensor Setup

WiFi Explorer Pro allows you to connect to a remote platform (e.g. Raspberry Pi) and perform a passive Wi-Fi scan using a capable Wi-Fi adapter. When a remote sensor is used, the scan results are sent back to WiFi Explorer Pro for its visualization.

To use a platform as a remote sensor you will need a Linux-based computer with a Wi-Fi adapter capable of using monitor mode, and a Python script that enables the sensor functionality.

Installation

  1. Download wifiexplorer-sensor.py and copy the script to the Linux-based platform that will be used as a remote sensor. I recommend you place the script under /usr/local/bin. Also, make sure it has executable permissions:
sudo chmod +x /usr/local/bin/wifiexplorer-sensor.py
  1. Install python, python-pip, scapy and tcpdump. If you're using a Debian-based platform you can type:
sudo apt-get install python python-pip scapy tcpdump
  1. Install the Python port of the Netlink protocol library suite:
sudo pip install libnl
  1. Launch the script. For example, if wlan0 is the Wi-Fi adapter to be used, type:
sudo nohup /usr/local/bin/wifiexplorer-sensor.py wlan0 > /tmp/wifiexplorer-sensor.log 2>&1 &
  1. (Optional) You can make the script launch at startup by editing /etc/rc.local to include the line above. If your Wi-Fi adapter is other than wlan0, change it accordingly. Also, the line above must be included just before the line that says exit 0, in case such line is present.

Once the platform is ready, go to WiFi Explorer Pro > Preferences > Sensors and click '+' to add the new sensor by entering its IP address. This address would be the wired (Ethernet) IP address unless you have a secondary Wi-Fi adapter you can use to connect to the sensor (the Wi-Fi adapter used for scanning will be switched to monitor mode while the scan is in progress!).

You can now go to the WiFi Explorer Pro toolbar and choose your remote sensor to start a scan.