wisespace-io / nearby

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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
  • Monitor suspicious wireless network activities
  • GeoLocation (Monitor usage of less common SSIDs)
  • Watch specific Mac Address (Send alert by email)
  • BLE Indoor Positioning

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 You can list the network interfaces with ip link show on Ubuntu.

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)

Disclaimer

It is the end user's responsibility to obey all applicable local, state and federal laws. Developers assume no liability and are not responsible for any misuse or damage caused by this program.

About

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

License:Other


Languages

Language:Rust 58.0%Language:JavaScript 38.0%Language:CSS 3.0%Language:HTML 1.1%