Skip to content

simon0302010/wifi-scan

This branch is 103 commits ahead of booyaa/wifiscanner:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

May 7, 2026
06b8ece · · May 7, 2026

History

195 Commits
Apr 29, 2021
Oct 26, 2025
May 7, 2026
Feb 20, 2017
Aug 22, 2016
Oct 29, 2025
May 7, 2026
Jul 29, 2016
Oct 29, 2025
May 7, 2026
May 7, 2026

Repository files navigation

wifi_scan

CI Crates docs.rs dependency status

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

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

Copyright 2025 simon0302010.

see LICENSE

About

A crate to list WiFi hotspots in your area. Fork of booyaa/wifiscanner.

Resources

License

Contributing

Stars

Watchers

Forks

Contributors

No contributors

Languages

  • Rust 64.5%
  • C 35.2%
  • Makefile 0.3%