/wlan

Connect to wireless networks with minimal keystrokes.

Primary LanguageShellGNU General Public License v3.0GPL-3.0

wlan

Simple nmcli wrapper script to switch between wireless networks with just a few keystrokes.

Usage

The script works with no arguments:

wlan

This will launch a fuzzy finder UI that allows you to quickly select a network and establish a connection.

If you are moving around, or your list of networks just happens to be omitting an SSID you know should be there:

wlan --rescan

To disconnect from a network:

wlan disconnect
# or for less typing:
wlan d

History

This script remembers your history, so you can navigate to previously-selected networks using key bindings:

  • Previous history: Ctrl-p or Ctrl-j
  • Next history: Ctrl-n or Ctrl-k

You can also set the initial network search query when invoking the command:

wlan -- My Network SSID

If "My Network SSID" only yields one (fuzzy) search result, the search UI won't even appear, and the connection will be established without any further interaction. This enables you to use your terminal's history search function to change networks even more quickly.

Dependencies

Installation

You can download the script, or clone the repository and run

sudo make install

Contributing

If you want to run tests, etc., there are two ways you can go: Install necessary dev dependencies on your computer, or install Podman.

Podman

Run make dev-env to start a Bash prompt inside a container with everything installed. Or use make ci if you want to run the continuous integration pipeline in the container on your computer.

Dev Dependencies

Check out the Dockerfile for the most up-to-date list of dev dependencies.