https://github.com/dynosol/airport-cli
Python CLI for macOS wireless management | Replaces deprecated `airport` utility with commands for network info, quality, scanning, and SSID.
https://github.com/dynosol/airport-cli
airport cli macos networking scan wifi wireless
Last synced: 4 months ago
JSON representation
Python CLI for macOS wireless management | Replaces deprecated `airport` utility with commands for network info, quality, scanning, and SSID.
- Host: GitHub
- URL: https://github.com/dynosol/airport-cli
- Owner: Dynosol
- License: mit
- Created: 2025-03-14T03:07:51.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-14T03:38:08.000Z (7 months ago)
- Last Synced: 2025-03-23T10:23:11.584Z (7 months ago)
- Topics: airport, cli, macos, networking, scan, wifi, wireless
- Language: Python
- Homepage:
- Size: 15.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
```
_____ _____ ___________
______ ____(_)________________ ______ __________ /___________ /___(_)
_ __ `/__ / __ ___/___ __ \_ __ \__ ___/_ __/_ ___/__ / __ /
/ /_/ / _ / _ / __ /_/ // /_/ /_ / / /_ / /__ _ / _ /
\__,_/ /_/ /_/ _ .___/ \____/ /_/ \__/ \___/ /_/ /_/
/_/
```
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://github.com/Dynosol/airport-cli/issues)
[](https://github.com/Dynosol/airport-cli/stargazers)
A Python-based command line interface for AirPort wireless on macOS, designed to replace the `airport` utility, depricated in macOS Sonoma 14.4.
## Usage
```
Usage:
airportcli info [-l|--long]
airportcli -I | -getinfo [-l|--long]
airportcli join
airportcli quality
airportcli off
airportcli on
airportcli scan []
airportcli -s []
airportcli ssid
airportcli -h | --help | help
airportcli --version
Add -v or --verbose to any command for detailed logging output.
```
### Subcommands
| Command | Description |
|---------|-------------|
| `info`, `-I`, `-getinfo` | Print the current network SSID and quality percentage. Use the `-l` or `--long` options to print detailed information about the connection. |
| `join` | Join the specified network. (deprecated) |
| `quality` | Show the wireless quality as a percentage. |
| `off` | Turn wireless off. (deprecated) |
| `on` | Turn wireless on. (deprecated) |
| `scan`, `-s` | Perform a scan for wireless networks. |
| `ssid` | Print the current network's SSID. |
| `help` | Display help information. |
### Options
| Option | Description |
|--------|-------------|
| `-h`, `--help` | Display help information. |
| `--version` | Display version information. |
| `-v`, `--verbose` | Enable verbose logging output. |
## Installation
### pip
To install with pip:
```bash
pip install git+https://github.com/Dynosol/airportcli.git
```
### PyPI (coming soon, or probably never)
```bash
pip install airportcli
```
### Homebrew (coming soon, or also probably never)
```bash
brew install airportcli
```
### Manual
To install manually, clone the repository and install:
```bash
git clone https://github.com/Dynosol/airportcli.git
cd airportcli
pip install -e .
```
## Development
1. Clone the repository
2. Create a virtual environment: `python -m venv venv`
3. Activate the virtual environment: `source venv/bin/activate` (Unix) or `venv\Scripts\activate` (Windows)
4. Install development dependencies: `pip install -e .`
## Compatibility
- macOS Sonoma 14.4 and later
- Python 3.6+
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Acknowledgments
- Inspired by the original `airport` utility in macOS
- Special thanks to [@xwmx](https://github.com/xwmx) for the original airport utility