Metadata-Version: 2.1
Name: winwifi
Version: 1.0.4
Summary: A Windows Wi-Fi CLI utility
Home-page: https://github.com/changyuheng/winwifi
Author: Johann Chang
Author-email: mr.changyuheng@gmail.com
License: MPL-2.0
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Programming Language :: Python :: 3.6
Classifier: Environment :: Win32 (MS Windows)
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: dev
Provides-Extra: test
License-File: LICENSE

# winwifi.py

A Wi-Fi CLI tool for Windows.
It allows you to scan Wi-Fi Access Points without being an admin to disable and enable the Wi-Fi interface.

## Installation

```
pip install winwifi
```

## Usage

```
wifi 0.0.5

A Windows Wi-Fi CLI

Usage:
    wifi [SWITCHES] [SUBCOMMAND [SWITCHES]] args...

Meta-switches
    -h, --help         Prints this help message and quits
    --help-all         Print help messages of all subcommands and quit
    -v, --version      Prints the program's version and quits

Subcommands:
    connect            Connect to a specific access point; see 'wifi connect --help' for more info
    connected          Show the current connected Wi-Fi SSID; see 'wifi connected --help' for more info
    disconnect         Disconnect from a Wi-Fi access point; see 'wifi disconnect --help' for more info
    forget             Remove speicifc access points from the historical list; see 'wifi forget --help' for more info
    history            List the historical Wi-Fi access points; see 'wifi history --help' for more info
    scan               Scan and list nearby Wi-Fi access points; see 'wifi scan --help' for more info

wifi connect 0.0.5

Connect to a specific access point

Usage:
    wifi connect [SWITCHES] ssid [passwd='']

Hidden-switches
    -h, --help         Prints this help message and quits
    --help-all         Print help messages of all subcommands and quit
    -v, --version      Prints the program's version and quits

Switches
    --oneshot          Do not remember the connection


wifi connected 0.0.5

Show the current connected Wi-Fi SSID

Usage:
    wifi connected [SWITCHES]

Hidden-switches
    -h, --help         Prints this help message and quits
    --help-all         Print help messages of all subcommands and quit
    -v, --version      Prints the program's version and quits


wifi disconnect 0.0.5

Disconnect from a Wi-Fi access point

Usage:
    wifi disconnect [SWITCHES]

Hidden-switches
    -h, --help         Prints this help message and quits
    --help-all         Print help messages of all subcommands and quit
    -v, --version      Prints the program's version and quits


wifi forget 0.0.5

Remove speicifc access points from the historical list

Usage:
    wifi forget [SWITCHES] ssids...

Hidden-switches
    -h, --help         Prints this help message and quits
    --help-all         Print help messages of all subcommands and quit
    -v, --version      Prints the program's version and quits


wifi history 0.0.5

List the historical Wi-Fi access points

Usage:
    wifi history [SWITCHES]

Hidden-switches
    -h, --help         Prints this help message and quits
    --help-all         Print help messages of all subcommands and quit
    -v, --version      Prints the program's version and quits


wifi scan 0.0.5

Scan and list nearby Wi-Fi access points

Usage:
    wifi scan [SWITCHES]

Hidden-switches
    -h, --help         Prints this help message and quits
    --help-all         Print help messages of all subcommands and quit
    -v, --version      Prints the program's version and quits

Switches
    --refresh          Force to refresh the Wi-Fi AP list
```


