_                       __
      ____ _(_)________  ____  _____/ /_
     / __ `/ / ___/ __ \/ __ \/ ___/ __/
    / /_/ / / /  / /_/ / /_/ / /  / /_
    \__,_/_/_/  / .___/\____/_/   \__/
               /_/

# airport cli

A command line interface for AirPort wireless on macOS / OS X up to
macOS Sonoma 14.4.

**NOTE: Airport command line access is no longer available as of
macOS Sonoma 14.4.**

## Usage

```text
Usage:
  airport info [-l|--long]
  airport join <SSID>
  airport quality
  airport off
  airport on
  airport scan [<query>]
  airport ssid
  airport -h | --help | help
  airport --version

Subcommands:
  info     Print the current network SSID and quality. Use the -l or --long
           options to print detailed information.
  join     Join the specified network.
  quality  Show the wireless quality as a percentage.
  off      Turn wireless off.
  on       Turn wireless on.
  scan     Perform a scan for wireless networks.
  ssid     Print the current network's SSID.
  help     Display this help information.

Options:
  -h --help  Display this help information.
  --version  Display version information.
```

## Installation

### Homebrew

To install with [Homebrew](http://brew.sh/):

```bash
brew tap xwmx/taps
brew install airport
```

### npm

To install with [npm](https://www.npmjs.com/package/airport-cli):

```bash
npm install --global airport-cli
```

### bpkg

To install with [bpkg](http://www.bpkg.io/):

```bash
bpkg install xwmx/airport
```

### Manual

To install manually, simply add the `airport` script to your `$PATH`. If
you already have a `~/bin` directory, you can use the following command:

```bash
curl -L https://raw.github.com/xwmx/airport/master/airport \
  -o ~/bin/airport && chmod +x ~/bin/airport
```