nmrs-tui 🦀

A fast, keyboard-first TUI for NetworkManager — built in Rust.

Demo

demo.mp4

---

nmrs-tui is a terminal user interface for nmrs, inspired from impala.

✨ Features

• Available Networks: Real-time scanning and listing of WiFi networks.
• Known Networks: Easily manage and connect to your saved profiles.
• Device Management: View and control your network interfaces.
• Customizable: colors, borders, layout, and table widths are all configurable via a RON config file
• Vim-like Keybindings: Navigate your networks with Vim-like keybinds.

🚀 Installation

Prerequisites

• NetworkManager must be installed and running.
• Rust if you are building from source.

📦 Cargo

cargo install nmrs-tui

The binary will be available at ~/.cargo/bin/nmrs-tui. Make sure ~/.cargo/bin is on your PATH:

export PATH="$HOME/.cargo/bin:$PATH"

Build from Source

git clone https://github.com/y2w8/nmrs-tui.git
cd nmrs-tui
cargo build --release

The binary will be available at ./target/release/nmrs-tui.

🛠️ Debugging & Logs

If you encounter issues, nmrs-tui provides detailed logging. You can set the log level using the NMRS_LOG environment variable:

NMRS_LOG=trace nmrs-tui

Logs are stored in your cache directory ~/.cache/nmrs-tui/nmrs-tui.log, fallback to cwd.

🤝 Contributing

Contributions are welcome! Whether it's a bug report, a new feature idea, or a pull request, feel free to open an issue or submit a PR.