Wisespace Io Nearby Save

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

Project 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
  • 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.

Open Source Agenda is not affiliated with "Wisespace Io Nearby" Project. README Source: wisespace-io/nearby
Stars
101
Open Issues
3
Last Commit
3 years ago
Repository

Open Source Agenda Badge

Open Source Agenda Rating