Skip to content

ilvkr4/wifiexplorer-sensor

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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 &

(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.

If you have a Debian-based system, you could also use the wifiexplorer-sensor startup script. Copy wifiexplorer-sensor to the target platform, then type the following to enable it:

sudo install -p -m 755 wifiexplorer-sensor /etc/init.d/wifiexplorer-sensor
sudo update-rc.d wifiexplorer-sensor defaults
sudo systemctl daemon-reload

Then, start the sensor by typing:

sudo service wifiexplorer-sensor start

Using

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.

About

Enables remote scanning in WiFi Explorer Pro

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 83.5%
  • Shell 16.5%