Skip to content
Wi-Fi User Detection System
Python Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

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.


# 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
# install WUDS
git clone
cd wuds
# edit the config file
# execute the included run script
# Ctrl+A, D detaches from the screen session

File Summary

  • - custom alert modules
  • - configuration file
  • - core library
  • - startup script
  • README - this file

How to use

Configure in first Run and follow the onscreen intrucstions

You can’t perform that action at this time.