6 releases
Uses old Rust 2015
0.1.5 | Jan 5, 2020 |
---|---|
0.1.4 | Sep 30, 2018 |
#16 in #wireless
1MB
1.5K
SLoC
Nearby
Description
Scans nearby wifi networks and the devices connected to each network.
Planned features
- Map nearby devices (Netjson for visualization)
- Count the number of people around you
- Stop Scanning with CTRL-C and print all collected results
- Watch specific Mac Address (Send alert by email)
- BLE Indoor Positioning
- GeoLocation
Build
On Debian based Linux, install apt-get install libpcap-dev
, so build the project:
cargo build --release
Usage
Nearby Devices
Root access is required to nearby
be able to set the wireless interface on Monitor Mode
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
sudo target/release/nearby -i your_wireless_adapter --netjson
Use --graph
to start a webserver and visualize the generated file (networks.json
)
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.
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:
- Alfa AWUS036NHA
- Alfa AWUS036NEH
- TP-Link TL-WN722N (ONLY Version 1)
Dependencies
~48MB
~855K SLoC