NAME
wifui — A lightweight, keyboard-driven Terminal User Interface (TUI) for managing Wi-Fi connections on Windows.
SYNOPSIS
cargo install wifuiINFO
DESCRIPTION
A lightweight, keyboard-driven Terminal User Interface (TUI) for managing Wi-Fi connections on Windows.
README
WifUI
WifUI is a blazing fast, lightweight Terminal User Interface (TUI) for managing Wi-Fi connections on Windows. Built with Rust and ratatui, it offers a keyboard-centric way to scan, connect, and monitor your network status without leaving the terminal.
🚀 Features
- Network Scanning: Instantly discover available Wi-Fi networks.
- Seamless Connection: Connect to open or secured networks.
- Network Management: View detailed network info (SSID, Signal Strength, Security Type, Channel).
- Share WiFi: Generate QR codes to share saved network credentials.
- Keyboard Driven: Efficient navigation with Vim-like keybindings.
📸 Screenshots
| Home | Add Network |
|---|---|
 |  |
| Password | Search |
 |  |
| Share | |
 |
📦 Installation
Note: For the best experience, Nerd Fonts are recommended. However, you can use the --ascii flag if you prefer standard text-based icons.
Winget
winget install wifui
Scoop
scoop bucket add sohamw03 https://github.com/sohamw03/Scoop-Bucket
scoop install wifui
Chocolatey
choco install wifui
Crates.io
cargo install wifui
From Source
Ensure you have the Rust toolchain installed.
winget install Rustlang.Rustup
winget install --id Microsoft.VisualStudio.2022.BuildTools --override "--passive --wait --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows11SDK.22621"
git clone https://github.com/sohamw03/wifui.git
cd wifui
cargo install --path .
🎮 Usage
Run the application:
wifui
Command Line Arguments
| Flag | Description |
|---|---|
--ascii | Use ASCII icons (no Nerd Fonts required) |
--show-keys | Show key logger for debugging |
-v, --version | Print version information |
Keybindings
| Key | Action |
|---|---|
↑ / k | Move Selection Up |
↓ / j | Move Selection Down |
g / Home | Go to Top |
G / End | Go to Bottom |
Enter | Connect / Disconnect |
n | Add New Network Manually |
r | Refresh Network List |
f | Forget Network |
a | Toggle Auto Connect |
s | Share WiFi (QR Code) |
/ | Search Networks |
q / Ctrl + c | Quit |
Esc | Back / Clear Search / Quit |
Input Navigation (Search & Password)
| Key | Action |
|---|---|
Esc / Ctrl + [ | Clear Input |
Ctrl / Alt + Backspace | Delete Word |
Ctrl / Alt + ← / → | Move Cursor by Word |
Home / End | Move Cursor to Start / End |
🤝 Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request on GitHub.
📄 License
This project is licensed under the MIT License.