Skip to content
/ wifui Public

A lightweight, keyboard-driven Terminal User Interface (TUI) for managing Wi-Fi connections on Windows.

License

Notifications You must be signed in to change notification settings

sohamw03/wifui

Repository files navigation

WifUIBanner

WifUI

Downloads GitHub Actions Workflow Status WinGet Package Version Scoop Version Chocolatey Version Crates.io Version GitHub Repo stars

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
Home Search
Password Search
Password Search
Share
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 bucket add sohamw03 https://github.com/sohamw03/Scoop-Bucket
scoop install wifui
choco install wifui
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.