nmwrap 0.1.0

An interactive terminal user interface (TUI) written in Rust and Ratatui for scanning and managing Wi-Fi connections using nmcli
nmwrap-0.1.0 is not a library.

📡 nmwrap

An interactive terminal user interface (TUI) written in Rust using Ratatui, designed as a wrapper for nmcli (NetworkManager).

This application allows you to easily scan available Wi-Fi networks and connect to them directly from your terminal, eliminating the need to memorize long and complex nmcli commands.

✨ Features

  • Interactive Wi-Fi Scanning: Displays a clean, real-time list of available Wi-Fi networks around you.
  • Modern TUI: Built using the ratatui ecosystem for a responsive, clean, and intuitive terminal experience.
  • Instant Connection: Select a target network and input the password via a secure prompt directly inside the application.
  • Blazing Fast: Written entirely in Rust, ensuring minimal memory footprint and near-instant execution.

📋 Prerequisites

Before installing and running this application, ensure your Linux system has the following dependencies:

  1. Rust & Cargo: Required to build the application. You can install them via rustup.rs.
  2. NetworkManager (nmcli): Must be installed and running on your system, as the application interacts with nmcli under the hood.

🚀 Installation

  1. Clone this repository to your local machine:
git clone git@github.com:Pakelzz/nmwrap.git
cd nmwrap
  1. Build application in release mode:
cargo build --release
  1. Move the compiled binary to your local path (Optional, to run it from anywhere):
sudo cp target/release/nmwrap /usr/local/bin/

💻 Usage

If you installed the binary globally, simply run the following command in your terminal:

nmwrap

(Alternatively, run cargo run if you are still in the development environment).

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.