https://github.com/bee-san/wuds
Wi-Fi User Detection System
https://github.com/bee-san/wuds
Last synced: 18 days ago
JSON representation
Wi-Fi User Detection System
- Host: GitHub
- URL: https://github.com/bee-san/wuds
- Owner: bee-san
- Created: 2016-01-01T23:55:40.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2016-03-14T19:49:58.000Z (almost 10 years ago)
- Last Synced: 2025-01-19T23:47:40.861Z (12 months ago)
- Language: Python
- Size: 4.88 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WUDS: Wi-Fi User Detection System
WUDS is a proximity detection system that uses Wi-Fi probe requests, signal strength, and a white list of MAC addresses to create a detection barrier and identify the presence of foreign devices within a protected zone. Designed with the Raspberry Pi in mind, WUDS can be installed and configured on any system with Python 2.x and a wireless card capable of Monitor mode.
## Setup
```bash
# install prerequisites
# iw - control the wi-fi interface
# pycapy - access full 802.11 frames
# sqlite3 - interact with the database
# screen - (optional) daemonize WUDS
sudo apt-get install iw python-pcapy sqlite3 screen
# lauch a screen session
screen
# install WUDS
git clone https://LaNMaSteR53@bitbucket.org/LaNMaSteR53/wuds.git
cd wuds
# edit the config file
vim config.py
# execute the included run script
./run.sh
# Ctrl+A, D detaches from the screen session
```
## File Summary
* alerts.py - custom alert modules
* config.py - configuration file
* core.py - core library
* run.sh - startup script
* README - this file
## How to use
Configure in config.py first
Run run.sh and follow the onscreen intrucstions