nearby

Crates.ionearby
lib.rsnearby
version0.1.5
sourcesrc
created_at2018-09-13 19:08:49.78974
updated_at2020-01-05 16:14:43.864064
descriptionScans all nearby wifi networks and the devices connected to each network
homepage
repositoryhttps://github.com/wisespace-io/nearby
max_upload_size
id84577
size4,330,721
Flávio Oliveira (wisespace-io)

documentation

https://github.com/wisespace-io/nearby

README

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)
Commit count: 39

cargo fmt