Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ewen-lbh/wifiqr

Create a QR code to share a WiFi hotspot with friends
https://github.com/ewen-lbh/wifiqr

qr qrcode qrcode-generator wifi wifi-qr wifi-qrcode

Last synced: about 1 month ago
JSON representation

Create a QR code to share a WiFi hotspot with friends

Awesome Lists containing this project

README

        

# wifiqr

> Generate QR codes of Wi-Fi networks

## Required software

_Eventually, all dependencies should become optional_

- the fish shell (will make a shell-agnostic binary later, in Go)

- ImageMagick (the `display` command)

- The `qrcode` command, install it like this:

```shell
$ go install github.com/skip2/go-qrcode/qrcode@latest
```

## Optional software

- To leave out some arguments

- _NetworkManager_ as the system's network manager

If you don't have this, you can still use _wifiqr_, but you'll have to provide all arguments (the name, password and "WPA" or "WEP")

## Installation

0. Make sure your current shell is _fish_:
```shell
$ echo $SHELL
/usr/bin/fish
```
1. Install `qrcode` and put the qrwifi function in your fish config:
```shell
$ go install github.com/skip2/go-qrcode/qrcode@latest
$ git clone https://github.com/ewen-lbh/wifiqr
$ cp wifiqr/wifiqr.fish ~/.config/fish/functions/
$ rm -rf wifiqr
```

## Usage

```
wifiqr [ [ [WPA|WEP]]]
```

Any unspecified argument will be auto-detected from `/etc/NetworkManager/system-connections/.nmconnection`.

If `` is not specified, it is assumed to be the currently in-use network (see `nmcli dev wifi`)