datagod/gpsprobe

GPSProbe allows you to record GPS, MAC address, signal strength etc. of wifi enabled devices nearby.

An example of GPSProbe running on a Raspberry Pi3 with an external Wifi antenna, GPS, and a Unicornhat HD display.

A passive surveillance tool that tracks wifi enabled devices nearby,
GPSProbe records the MAC addresses, GPS co-ordinates and other pertinent
information. This tool pairs nicely with security cameras to provide
evidence of who or what was visiting your property uninvited.

Features:

• record MAC address, time of day, signal strength, vendor, etc.
• can assign a friendly name to previously recognized MAC addresses
• optional tracking of GPS co-ordinates
• tracks routers as well as mobile devices

Optional Unicorn hat HD display

• leverages code from Arcade Retro Clock to display device counts,
  signal counts, and packet counts

Special Thanks:

• This project started off as a fork of probemon. I added the ability
  to capture GPS co-ordinates to the capture file.
  https://github.com/nikharris0/probemon

• Arcade Retro Clock HD has not been released as of July 2019 but I have
  included some functions and objects required to display scrolling
  alphanumerics and strength bars.
  https://github.com/datagod/Arcade-Retro-Clock

• GPS polling code and thread spawning code was borrowed from another
  project that I have since lost track. I will certainly give them
  full credit when I track them down

Sample Output

Details of the captured packets are shown in a series of ncurses windows.

Dependencies

netaddr - https://github.com/drkjam/netaddr scapy - https://github.com/secdev/scapy

Quick install of dependencies

git clone https://github.com/drkjam/netaddr
cd netaddr
sudo python setup.py install
cd
git clone https://github.com/secdev/scapy.git
cd scapy
sudo python setup.py install

gpsprobe's Issues

Equipment List

Do you have a list of everything that you need for this project?

Missing library

The library FriendlyNameList gpsprobe.py depends on is missing. Would you know where I can find this?

Additionally, I had to declare the character encoding at the top of that file with utf-8 by adding this line:
# -*- coding: utf-8 -*-