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.

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.*"

Note: On macOS, the SSIDs and BSSIDs of networks are only shown if location access is granted to the program.

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

Copyright 2019 Mark Sta Ana. Forked and maintained by simon0302010.

Copyright 2025 simon0302010.

see LICENSE