airctl

KO | EN

gitlite — search

#react #ai #typescript #android #machine-learning #deep-learning #linux #macos #nodejs #awesome #awesome-list #pytorch #openai #mcp

(★ 114)

AIRCTL, a modern WiFi management tool for Linux built with GTK4 and Python. It provides a clean interface to scan, connect, and manage wireless networks.

airctl Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

---

<br/>

<p align="center">
    <i>A modern WiFi management tool for Linux built with GTK4 and Python.</i>
    <br/>
    <i>AIRCTL provides a clean interface to scan, connect, and manage wireless networks.</i>
  </p>

---

<br/>

[![GitHub stars](https://img.shields.io/github/stars/pshycodr/airctl?style=social)](https://github.com/pshycodr/airctl/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/pshycodr/airctl?style=social)](https://github.com/pshycodr/airctl/network/members)
[![GitHub watchers](https://img.shields.io/github/watchers/pshycodr/airctl?style=social)](https://github.com/pshycodr/airctl/watchers)

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Python](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
[![GTK](https://img.shields.io/badge/GTK-4.0-green.svg)](https://www.gtk.org/)
[![Arch Linux](https://img.shields.io/badge/Arch-AUR-blue.svg)](https://aur.archlinux.org/packages/airctl-bin)
[![Downloads](https://img.shields.io/endpoint?url=https://badge.dl.aroy.site/%3Fuser=pshycodr%26repo=airctl%26asset=airctl.bin)](https://dl.aroy.site/pshycodr/airctl)

![AIRCTL Demo](https://raw.githubusercontent.com/pshycodr/airctl/main/assets/demo.png)

</div>

## Features

* Scan available WiFi networks
* Connect to secured and open networks
* View detailed network information
* Manage saved connections
* Disconnect and forget networks
* Auto-refresh network list
* Modern GTK4 interface
* Powerful command-line interface
* Distributed via AUR (`airctl-bin`)

## Installation

### Arch Linux (Recommended)

Install directly from AUR:

```bash
yay -S airctl-bin
```

OR

```bash
curl -fsSL https://raw.githubusercontent.com/pshycodr/airctl/main/scripts/install.sh | bash
```

After installation, launch it from your app launcher or run:

```bash
airctl
```

---

### From Source

Clone the repository:

```bash
git clone https://github.com/pshycodr/airctl.git
cd airctl
```

Install dependencies using uv:

```bash
uv sync
```

Run the application:

```bash
uv run airctl/main.py
```

Build the application

```bash
# activate the venv
source .venv/bin/activate

# run the build script
./scripts/build.sh
```

## Requirements

* Python 3.12 or higher
* GTK 4
* NetworkManager
* nmcli

## Usage

### GUI Mode

Launch AIRCTL and toggle WiFi on or off using the switch at the top.

* The connected network appears as a highlighted card.
* Available networks are listed below.
* Click any network to connect.
* For secured networks, enter the password when prompted.
* Use the settings icon on a connected network to view details or disconnect.

### CLI Mode

AIRCTL includes a powerful command-line interface for managing WiFi networks.

```bash
airctl <command> [options]

# run to get all the commands
airctl -h
```

## Dependencies

* PyGObject (gi)
* nmcli
* rich (for CLI output)

All dependencies are defined in `pyproject.toml` and handled via `uv`.

---

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.

## License

This project is licensed under the GPL-3.0 License. See the [LICENSE](LICENSE) file for details.

## Credits

Built by [pshycodr](https://github.com/pshycodr)

Special thanks to the NetworkManager team, GTK developers, and the open source community.

## Show Your Support

If you found this project useful, consider giving it a star ⭐

[![Star this repo](https://img.shields.io/github/stars/pshycodr/airctl?style=social)](https://github.com/pshycodr/airctl)

Found a bug or have a feature request? Open an issue on GitHub.

airctl

airctl Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

airctl

airctl Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README