wifi_scan

Intro

This is a fork of wifiscanner, a crate to list WiFi hotspots in your area. This fork moves wifiscanner away from using command line utilities that can't be relied on. Use versions 0.6.* if you want a drop-in replacement for the original crate.

Full documentation can be found here.

I started developing this project during Midnight Hackathon organised by Hack Club.

Supported Operating Systems

| ✅ Fully working | ⚠️ Partially working | 🛠️ Planned |

Operating System	Status	Notes
macOS	⚠️	requires location access to show bssid and ssid
Linux	✅
Windows	✅
OpenBSD	✅	wpa3-enterprise networks cannot be detected as such
FreeBSD	⚠️	network security is not being exposed
NetBSD	⚠️	network security is not being exposed, drivers may report positive rssi numbers
Android	🛠️

Usage

This crate is on crates.io and can be used by adding wifi_scan to the dependencies in your project's Cargo.toml.

[dependencies]
wifi_scan = "0.7.*"

Example

use wifi_scan;
println!("{:?}", wifi_scan::scan());

Alternatively if you've cloned the Git repo, you can run the above example using: cargo run --example scan.

Changelog

0.7.3 - added partial NetBSD support
0.7.2 - added partial FreeBSD support
0.7.1 - added full support for OpenBSD
0.7.0 - changed api for scan function. also added other functions. more details in the docs.
0.6.3 - switch to using corewlan on macOS due to the removal of the airport utility
0.6.2 - stop relying on netsh utility on windows
0.6.1 - support for multiple wifi adapters on linux
0.6.0 - remove iw dependency for linux
0.5.1 - crates.io metadata update
0.5.0 - add window support (props to @brianjaustin)
0.4.0 - replace iwlist with iw (props to @alopatindev)
0.3.6 - crates.io metadata update
0.3.5 - remove hardcoded path for iwlist (props to @alopatindev)
0.3.4 - initial stable release

How to contribute

see CONTRIBUTING.md

Contributors

wifi_scan would not be possible without the following people:

@alopatindev, @bizzu, @bash, @cristicbz, @lpmi-13, @brianjaustin, @booyaa

Copyright

see LICENSE

wifi_scan 0.7.3