Features

Clean and minimal GTK4 interface
Uses nmcli for backend operations
Fast and lightweight
Available as a prebuilt binary (no Python setup required)

Installation

Arch Linux

Install the binary version from AUR:

yay -S nmgui-bin

Other Distributions

Download the latest binary from Releases:

# Download and install
sudo curl -L https://github.com/s-adi-dev/nmgui/releases/download/v1.0.0/main.bin -o /usr/bin/nmgui
sudo chmod +x /usr/bin/nmgui

# Install desktop entry (optional)
curl -sL https://raw.githubusercontent.com/s-adi-dev/nmgui/main/nmgui.desktop | sudo tee /usr/share/applications/nmgui.desktop > /dev/null

Note: Only requires NetworkManager to be installed on your system.

Building from Source

If you prefer to build from source, ensure the ensure the following dependencies are installed:

Dependencies

Python 3.10 or newer
python-gobject
python-nmcli
gtk4
NetworkManager

Clone the repository and run:

git clone https://github.com/s-adi-dev/nmgui.git
cd nmgui

# Run the application
python3 app/main.py

Usage

Launch from your application menu or terminal:

nmgui

Hyprland Users

Add this to your config for floating window:

windowrulev2 = float, title:^(.*Network Manager.*)$

Contributing

This application is still under development and may contain bugs. If you encounter issues or errors, please open an issue or submit a pull request with a fix.

For problems related to python-nmcli, note that this project uses a fork maintained here: python-nmcli-fork

Pull requests to this fork are welcome, and relevant changes will be forwarded to the original repository.

Contributions of any kind (bug fixes, improvements, or new features) are appreciated.

License

GNU General Public License v3.0 - see LICENSE file for details.

Nmgui

Install / Use

README