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: