Repository files navigation

With the ever increasing dependance on wireless solutions, it sometimes is useful to know the devices around you. This software aims to help know the MAC addresses of the devices that are leaving any sort of trace on the airwaves.

This software is meant for educational purpose only. The author will not be held liable for any harm that is related to the software.

Compiling the sniffer follows the steps of standard CMake based build.

Basically, just run the following steps in the source directory:

mkdir bincd bincmake ..make

This will create awifi-sniffer file which can then be used to sniff packets from an wireless interface.

Running./wifi-sniffer without any parameters shows the usage

Usage: ./wifi-sniffer [options] interface  -m, --macstat   : Show number of detections of each MAC and timestamps  -t, --time t    : Run sniffer for t seconds (default: 60)  -v, --verbose   : Output more information  -d, --debug     : Show debugging information  -h, --help      : Show this help textNote: This program needs to be run as root

Do note that you need to have a wireless interface which supports "Monitor" mode to be able to use this software.

Please read theLICENSE file to know legal details of how you are allowed to use this software. But in short, this software is licensed under MIT License.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THESOFTWARE.