wifi-scanner
A command line tool for scanning nearby Wi-Fi networks using Node.js
npm install -g wifi-scanner
Instructions
Install wifi-scanner
globally using npm install -g wifi-scanner
.
Run wifi-scanner
with the desired options on your terminal.
Options
Short Version Command | Long Version Command | Description |
---|---|---|
-h | --help | output usage information |
-V | --version | output the version number |
-i | --interface [interfaceName] | Capture interface. Defaults to 'wlan0'. (CASE-SENSITIVE) |
-p | (Optional) Print results to the console. | |
-o | --output [filename] | (Optional) Output filename. (CASE-SENSITIVE) |
-c | --criteria [criteria] | (Optional) Criteria to filter. Example: 'security'. (CASE-SENSITIVE) |
-s | --sortCriteria [criteria] | (Optional) Sort results according to a specified criteria. |
-a | --ascending | (Optional) Sort results ascendingly. (DEFAULT) |
-d | --descending | (Optional) Sort results descendingly. |
-f | --filter [result] | (Optional) Desired result for specified criteria. Example: 'wep'. (CASE-SENSITIVE) |
-r | --retry | (Optional) Should retry until it finds a result matching the specified filter. |
-t | --timeout | (Optional) Retry interval (millisseconds). Defaults to 1000. |
Example Queries
Searches for every WEP network and sorts them descendingly by their signal:
wifi-scanner -c security -f wep -s signal -d
Searches for every WEP network each 5000ms until it finds one.
wifi-scanner -r -t 5000 -c security -f wep
Gets every nearby network, prints the results to the console and saves them into a networks.json file.
wifi-scanner -p -o networks.json
Gets every nearby network using the ath0
interface.
wifi-scanner -i ath0
Criteria
Name | Description |
---|---|
address | MAC adres |
channel | Broadcast channel |
frequency | Broadcast frequency |
mode | Mode |
quality | Network quality |
signal | Signal level |
ssid | SSID |
security | Security (wpa, wep, wpa2) |
Contributing
Feel free to contribute in any way you want. Every help is valid. If you find any issues or even if you have a suggestion please feel free to report it using our issue tracker.
This is the OpenSource Software's magic ✨
License
No need for copyright, live free, buddy, internet is for everyone 😉