GUI Installation

Arch Linux (AUR)

The easiest way to install on Arch Linux:

yay -S nmrs
# or
paru -S nmrs

Nix/NixOS

Nix Shell

nix-shell -p nmrs

NixOS Configuration

Add to your NixOS configuration:

environment.systemPackages = with pkgs; [
  nmrs
];

Nix Flake

nix run github:cachebag/nmrs

From Source

Dependencies

Install build dependencies for your distribution:

Arch Linux:

sudo pacman -S gtk4 libadwaita rust

Ubuntu/Debian:

sudo apt install libgtk-4-dev libadwaita-1-dev build-essential

Fedora:

sudo dnf install gtk4-devel libadwaita-devel rust cargo

Build

git clone https://github.com/cachebag/nmrs.git
cd nmrs
cargo build --release -p nmrs-gui

Install

sudo cp target/release/nmrs-gui /usr/local/bin/nmrs

Verification

After installation, launch nmrs-gui:

nmrs

The window should appear showing available Wi-Fi networks.

System Requirements

  • Rust: 1.94.0+ (for building from source)
  • GTK4: 4.0+
  • NetworkManager: running and accessible via D-Bus
  • Display: Wayland or X11
  • Linux: any modern distribution

Desktop Entry

If you installed from source, you may want to create a desktop entry:

[Desktop Entry]
Name=nmrs
Comment=NetworkManager GUI
Exec=nmrs
Icon=network-wireless
Type=Application
Categories=Network;Settings;

Save as ~/.local/share/applications/nmrs.desktop.

Next Steps