|
1 | | -# Wi-Fi QR Code generator |
| 1 | +# Wi-Fi QR Code Generator |
| 2 | + |
2 | 3 | <img src="docs/images/qr.png" align='right'/> |
3 | 4 |
|
4 | 5 | [](https://github.com/reugn/wifiqr/actions?query=workflow%3ATest) |
5 | | -[](https://pkg.go.dev/github.com/reugn/wifiqr?tab=doc) |
| 6 | +[](https://pkg.go.dev/github.com/reugn/wifiqr) |
6 | 7 | [](https://goreportcard.com/report/github.com/reugn/wifiqr) |
| 8 | +[](https://codecov.io/gh/reugn/wifiqr) |
7 | 9 |
|
8 | 10 | Create a QR code with your Wi-Fi login details. |
9 | 11 |
|
10 | 12 | Use Google Lens or other application to scan it and connect automatically. |
11 | 13 |
|
12 | 14 | ## Installation |
13 | | -Pick a binary from the [releases](https://github.com/reugn/wifiqr/releases). |
14 | 15 |
|
15 | | -### Build from source |
16 | | -Download and install Go https://golang.org/doc/install. |
| 16 | +Choose a binary from the [releases](https://github.com/reugn/wifiqr/releases). |
| 17 | + |
| 18 | +### Build from Source |
| 19 | + |
| 20 | +Download and [install Go](https://golang.org/doc/install). |
17 | 21 |
|
18 | 22 | Get the package: |
| 23 | + |
19 | 24 | ```sh |
20 | 25 | go get github.com/reugn/wifiqr |
21 | 26 | ``` |
22 | 27 |
|
23 | 28 | Read this [guide](https://golang.org/doc/tutorial/compile-install) on how to compile and install the application. |
24 | 29 |
|
25 | 30 | ## Usage |
| 31 | + |
26 | 32 | ```text |
27 | | -Usage of ./wifiqr: |
28 | | - -enc string |
29 | | - The wireless network encryption protocol (WEP, WPA, WPA2). (default "WPA2") |
30 | | - -file string |
31 | | - A png file to write the QR Code (prints to stdout if not set). |
32 | | - -hidden |
33 | | - Hidden SSID. |
34 | | - -key string |
35 | | - A pre-shared key (PSK). You'll be prompted to enter the key if not set. |
36 | | - -size int |
37 | | - Size is both the image width and height in pixels. (default 256) |
38 | | - -ssid string |
39 | | - The name of the wireless network. You'll be prompted to enter the SSID if not set. |
40 | | - -version |
41 | | - Show version. |
| 33 | +$ wifiqr --help |
| 34 | +wifiqr is a WiFi QR code generator |
| 35 | +
|
| 36 | +It is used to create a QR code containing the login details such as |
| 37 | +the name, password, and encryption type. This QR code can be scanned |
| 38 | +using Google Lens or other QR code reader to connect to the network. |
| 39 | +It is Android and iOS compatible. |
| 40 | +
|
| 41 | +If the options necessary for creating the QR code are not given on |
| 42 | +the command line, the user will be prompted for the information. |
| 43 | +
|
| 44 | +Usage: |
| 45 | + wifiqr [flags] |
| 46 | +
|
| 47 | +Flags: |
| 48 | + -h, --help help for wifiqr |
| 49 | + --hidden Hidden SSID |
| 50 | + -k, --key string Wireless password (pre-shared key / PSK) |
| 51 | + -o, --output string PNG file for output (default stdout) |
| 52 | + -p, --protocol string Wireless network encryption protocol (WPA2, WPA, WEP, NONE). (default "WPA2") |
| 53 | + -s, --size int Image width and height in pixels (default 256) |
| 54 | + -i, --ssid string Wireless network name |
| 55 | + -v, --version version for wifiqr |
42 | 56 | ``` |
43 | 57 |
|
44 | | -## Usage example |
| 58 | +## Usage Example |
| 59 | + |
45 | 60 | ```sh |
46 | | -./wifiqr -ssid some_ssid -key 1234 -file qr.png -size 128 |
| 61 | +./wifiqr --ssid some_ssid --key 1234 --output qr.png --size 128 |
47 | 62 | ``` |
48 | 63 |
|
49 | 64 | ## License |
50 | | -MIT |
| 65 | + |
| 66 | +MIT |
0 commit comments