wifui 0.1.1

A lightweight, keyboard-driven Terminal User Interface (TUI) for managing Wi-Fi connections on Windows.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

<!-- ![WifUIBanner](Banner Placeholder) -->


# WifUI


[![Downloads](https://img.shields.io/github/downloads/sohamw03/wifui/total)](https://github.com/sohamw03/wifui/releases)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/sohamw03/wifui/release.yml)
![WinGet Package Version](https://img.shields.io/winget/v/sohamw03.wifui)
![Crates.io Version](https://img.shields.io/crates/v/wifui)
![GitHub Repo stars](https://img.shields.io/github/stars/sohamw03/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).
- **Keyboard Driven**: Efficient navigation with Vim-like keybindings.

## 📸 Screenshots


| Home Screen | Password Prompt |
|:---:|:---:|
| ![Home Screen](images/main.png) | ![Password Prompt](images/password.png) |

## 📦 Installation


### Winget (Coming Soon)


```sh
winget install wifui
```

### Crates.io (Coming Soon)


```sh
cargo install wifui
```

### From Source


Ensure you have the [Rust toolchain](https://www.rust-lang.org/tools/install) installed.

```sh
git clone https://github.com/sohamw03/wifui.git
cd wifui
cargo run --release
```

## 🎮 Usage


Run the application:

```sh
wifui
```

### Keybindings


| Key | Action |
| :--- | :--- |
| `↑` / `k` | Move Selection Up |
| `↓` / `j` | Move Selection Down |
| `Enter` | Connect / Disconnect |
| `r` | Refresh Network List |
| `f` | Forget Network |
| `a` | Toggle Auto Connect |
| `q` / `Esc` | Quit |

## 🤝 Contributing


Contributions are welcome! Feel free to open an issue or submit a pull request on [GitHub](https://github.com/sohamw03/wifui).

## 📄 License


This project is licensed under the MIT License.