{"id":13587124,"url":"https://github.com/wisespace-io/nearby","last_synced_at":"2025-03-17T14:14:24.580Z","repository":{"id":57643970,"uuid":"146167199","full_name":"wisespace-io/nearby","owner":"wisespace-io","description":"Scans all nearby wifi networks and the devices connected to each network for Indoor positioning","archived":false,"fork":false,"pushed_at":"2020-07-18T16:47:17.000Z","size":2558,"stargazers_count":105,"open_issues_count":3,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-05-10T02:04:10.702Z","etag":null,"topics":["802-11","indoor-positioning","rust","wifi","wifi-hacking","wifi-security","wireless","wireless-security"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wisespace-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-26T09:19:12.000Z","updated_at":"2024-05-08T09:03:24.000Z","dependencies_parsed_at":"2022-08-30T05:12:43.868Z","dependency_job_id":null,"html_url":"https://github.com/wisespace-io/nearby","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wisespace-io%2Fnearby","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wisespace-io%2Fnearby/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wisespace-io%2Fnearby/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wisespace-io%2Fnearby/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wisespace-io","download_url":"https://codeload.github.com/wisespace-io/nearby/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244047646,"owners_count":20389206,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["802-11","indoor-positioning","rust","wifi","wifi-hacking","wifi-security","wireless","wireless-security"],"created_at":"2024-08-01T15:06:02.101Z","updated_at":"2025-03-17T14:14:24.545Z","avatar_url":"https://github.com/wisespace-io.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# Nearby\n\n[![Crates.io](https://img.shields.io/crates/v/nearby.svg)](https://crates.io/crates/nearby)\n[![Build Status](https://travis-ci.org/wisespace-io/nearby.png?branch=master)](https://travis-ci.org/wisespace-io/nearby)\n[![MIT licensed](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE-MIT)\n[![Apache-2.0 licensed](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE-APACHE)\n\n## Description\n\nScans nearby wifi networks and the devices connected to each network.\n\n## Planned features\n\n- [x] Map nearby devices ([Netjson for visualization](https://github.com/netjson/netjsongraph.js))\n- [x] Count the number of people around you\n- [x] Stop Scanning with CTRL-C and print all collected results\n- [ ] Monitor suspicious wireless network activities\n- [ ] GeoLocation (Monitor usage of less common SSIDs)\n- [ ] Watch specific Mac Address (Send alert by email)\n- [ ] BLE Indoor Positioning\n\n## Build\n\nOn Debian based Linux, install `apt-get install libpcap-dev`, so build the project:\n\n```rust\ncargo build --release\n```\n\n## Usage\n\n### Nearby Devices\n\nRoot access is required to `nearby` be able to set the wireless interface on `Monitor Mode`\nYou can list the network interfaces with `ip link show` on Ubuntu.\n\n```rust\nsudo target/release/nearby -i your_wireless_adapter\n```\n\nI.e: wlan0, or just run iwconfig to get it\n\nUse `--netjson` to generate `networks.json` and use it as input to visualization\n\n```rust\nsudo target/release/nearby -i your_wireless_adapter --netjson\n```\n\nUse `--graph` to start a webserver and visualize the generated file (`networks.json`)\n\n```rust\ntarget/release/nearby --graph\n```\n\n### People around you\n\nUse `--people` to generate `people.json`. It will watch Probe Requests and filter the mobiles according to a specified mobile phone vendor list.\n\n```rust\nsudo target/release/nearby -i your_wireless_adapter --people\n```\n\nNote: 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`.\n\n## Wifi adapter should support monitor mode\n\nThere are many USB Wifi adapters that support monitor mode, i.e:\n\n- Alfa AWUS036NHA\n- Alfa AWUS036NEH\n- TP-Link TL-WN722N (ONLY Version 1)\n\n## Disclaimer\n\nIt 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwisespace-io%2Fnearby","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwisespace-io%2Fnearby","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwisespace-io%2Fnearby/lists"}