wifi-scanner

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	--print	(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 :sparkles:

License

MIT License

No need for copyright, live free, buddy, internet is for everyone :wink: