Nearby

Crates.io Build Status MIT licensed Apache-2.0 licensed

Description

Scans nearby wifi networks and the devices connected to each network.

Planned features

Build

On Debian based Linux, install apt-get install libpcap-dev, so build the project:

rust cargo build --release

Usage

Nearby Devices

Root access is required to nearby be able to set the wireless interface on Monitor Mode

rust sudo target/release/nearby -i your_wireless_adapter

I.e: wlan0, or just run iwconfig to get it

Use --netjson to generate networks.json and use it as input to visualization

rust sudo target/release/nearby -i your_wireless_adapter --netjson

Use --graph to start a webserver and visualize the generated file (networks.json)

rust target/release/nearby --graph

People around you

Use --people to generate people.json. It will watch Probe Requests and filter the mobiles according to a specified mobile phone vendor list.

rust sudo target/release/nearby -i your_wireless_adapter --people

Note: The default scan time is 120s, if it stops working after a short period of time often with the error message libpcap error: The interface went down, it may be because another running process is causing it. On Ubuntu, you may be the network-manager, try service network-manager stop.

Wifi adapter should support monitor mode

There are many USB Wifi adapters that support monitor mode, i.e: