Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/drubaby/pi-probe-sniffer
Raspberry Pi-hosted wifi probe monitor with mqtt and supabase connections.
https://github.com/drubaby/pi-probe-sniffer
mqtt raspberrypi supabase wifi-probes
Last synced: 27 days ago
JSON representation
Raspberry Pi-hosted wifi probe monitor with mqtt and supabase connections.
- Host: GitHub
- URL: https://github.com/drubaby/pi-probe-sniffer
- Owner: drubaby
- License: gpl-3.0
- Created: 2024-04-01T16:28:29.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-05-27T15:15:37.000Z (5 months ago)
- Last Synced: 2024-09-29T00:43:20.814Z (about 1 month ago)
- Topics: mqtt, raspberrypi, supabase, wifi-probes
- Language: Python
- Homepage:
- Size: 721 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PiSniffer
Always-on WiFi Probe Request Packet Sniffer designed to run on a Raspberry Pi with a USB wireless card in monitor mode.
Logs probe requests from unknown devices to a daily CSV file and publishes them to an MQTT broker for home automation integrations. My instance is configured to run with a (free) Supabase DB to store known-device MAC addresses (freeing logs from clutter) and to upload a nightly digest of probes for analysis.
Future work:
- Implementing a UI I can monitor from my phone
- Discord notifications for unknown device detection
## Hardware
### Required
- Raspberry Pi
- USB Wireless Card capable of monitor mode
- USB Drive (to capture logs)
### Hardware setup
The wireless card will be detected and put into monitor mode by `start.sh` but we will want the usb drive to auto-mount on startup.
1. run `sudo blkid` to find the `PARTUUID` of the usb drive
2. add the following line to `/etc/fstab` where PARTUUID matches your device id
```bash
PARTUUID=24f4a1c2-233b-cf49-a147-137e81505db0 /media/usb ntfs defaults,auto,nofail,x-systemd,device-timeout=30, -o umask=000 0 0
```
## Installation
1. Clone this repository to raspberry pi
2. Make scripts executable with `sudo chmod +x start.sh` and `sudo chmod +x setup.sh`
3. Run `sudo bash ./setup.sh` for initial setup (Do this only once! See Optional Setup for steps to do this manually)
---
### Optional Setup
Run these steps to manually set up the `setup.sh` steps
1. Install linux dependencies:
```bash
sudo apt-get install -y aircrack-ng git python3-pip
```
2. Copy systemd service to local systemd directory, reload daemon and start service
```bash
#copy local service to systemd dir
sudo cp probe-sniffer.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable probe-sniffer.service
sudo systemctl start probe-sniffer.service
```
---
## Acknowledgements
This project was inspired by [this blog post](https://www.lanmaster53.com/2014/10/wifi-user-detection-system/) from Tim Tomes which I read many years ago and never stopped thinking about.
Check out the forked repo on [Ryan C Butler's GitHub](https://github.com/ryancbutler/wuds/tree/master).
I also learned a lot about WiFi probes from reading [these blog posts from Adam Robinson](https://attackingpixels.com/Tracking-Mobile-Devices-Through-802.11-Probe-Request-Frames-Part-1/) from whom I copped a lot of the core python code.