= wifi-scan

Friendly front-end to `iwlist` for wireless network scanning & troubleshooting.


== In action

 $ wifi-scan -k channel
 +------+---------+-----------+---------+---------------------------------+
 | cell | channel | frequency | quality | essid                           |
 +------+---------+-----------+---------+---------------------------------+
 | 14   | 1       | 2.412     | 44      | SNewSt2R                        |
 | 7    | 6       | 2.437     | 41      | MOTOROLA-Cxxx4                  |
 | 8    | 6       | 2.437     | 44      | SomeCleverWiFiName              |
 | 2    | 8       | 2.447     | 100     | mytroubledwifi                  |
 | 3    | 8       | 2.447     | 100     | dejaloya                        |
 | 9    | 8       | 2.447     | 100     |                                 |
 | 10   | 11      | 2.462     | 88      | The Jam 2.4G                    |
 | 1    | 36      | 5.18      | 100     | mytroubledwifi-5GHz             |
 | 6    | 36      | 5.18      | 44      | DIRECT-C1-HP OfficeJet Pro 9010 |
 | 11   | 36      | 5.18      | 44      |                                 |
 | 12   | 36      | 5.18      | 44      | yoyoyo                          |
 | 13   | 36      | 5.18      | 44      | XFINITY                         |
 | 15   | 36      | 5.18      | 44      | Lindsey                         |
 | 4    | 48      | 5.24      | 72      | The Jam 5G                      |
 | 5    | 153     | 5.765     | 44      | xfinitywifi                     |
 | 16   | 153     | 5.765     | 44      | thisnetworkisalsohere           |
 +------+---------+-----------+---------+---------------------------------+


== Install

Using Python v3.8 (or better):

[source,sh]
----
python3 -m pip install wifi-scan
----

As an alternative consider https://pipxproject.github.io/pipx/installation/[pipx]:

[source,sh]
----
pipx install wifi-scan
----
