Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

Scans all nearby wifi networks and the devices connected to each network for Indoor positioning
https://github.com/wisespace-io/nearby

802-11 indoor-positioning rust wifi wifi-hacking wifi-security wireless wireless-security

Last synced: 2 months ago
JSON representation

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

Host: GitHub
URL: https://github.com/wisespace-io/nearby
Owner: wisespace-io
License: other
Created: 2018-08-26T09:19:12.000Z (about 6 years ago)
Default Branch: master
Last Pushed: 2020-07-18T16:47:17.000Z (about 4 years ago)
Last Synced: 2024-05-10T02:04:10.702Z (5 months ago)
Topics: 802-11, indoor-positioning, rust, wifi, wifi-hacking, wifi-security, wireless, wireless-security
Language: Rust
Homepage:
Size: 2.44 MB
Stars: 105
Watchers: 5
Forks: 9
Open Issues: 3
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Nearby

[![Crates.io](https://img.shields.io/crates/v/nearby.svg)](https://crates.io/crates/nearby)
[![Build Status](https://travis-ci.org/wisespace-io/nearby.png?branch=master)](https://travis-ci.org/wisespace-io/nearby)
[![MIT licensed](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE-MIT)
[![Apache-2.0 licensed](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE-APACHE)

## Description

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

## Planned features

- [x] Map nearby devices ([Netjson for visualization](https://github.com/netjson/netjsongraph.js))
- [x] Count the number of people around you
- [x] 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:

```rust
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.

```rust
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

```rust
sudo target/release/nearby -i your_wireless_adapter --netjson
```

Use `--graph` to start a webserver and visualize the generated file (`networks.json`)

```rust
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.

```rust
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.