#wireless #wifi #networking #netjson #dot11

app nearby

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

6 releases

Uses old Rust 2015

0.1.5 Jan 5, 2020
0.1.4 Sep 30, 2018

#16 in #wireless

MIT/Apache

1MB
1.5K SLoC

Rust 1K SLoC // 0.0% comments JavaScript 379 SLoC // 0.3% comments

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

  • 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