Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pythops/impala
🛜 TUI for managing wifi on Linux.
https://github.com/pythops/impala
iwd linux ratatui tui wifi
Last synced: 9 days ago
JSON representation
🛜 TUI for managing wifi on Linux.
- Host: GitHub
- URL: https://github.com/pythops/impala
- Owner: pythops
- Created: 2024-06-09T22:00:04.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-09-08T07:46:59.000Z (2 months ago)
- Last Synced: 2024-10-11T18:54:51.027Z (28 days ago)
- Topics: iwd, linux, ratatui, tui, wifi
- Language: Rust
- Homepage:
- Size: 198 KB
- Stars: 712
- Watchers: 4
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: Readme.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- awesome-ratatui - impala - TUI for managing wifi on Linux. (💻 Apps / 🌐 Networking and Internet)
README
TUI for managing wifi
## 📸 Demo
## 💡 Prerequisites
A Linux based OS with [iwd](https://iwd.wiki.kernel.org/) installed.
> [!NOTE]
> You might need to install [nerdfonts](https://www.nerdfonts.com/) for the icons to be displayed correctly.
## 🚀 Installation
### 📥 Binary release
You can download the pre-built binaries from the release page [release page](https://github.com/pythops/impala/releases)
### 📦 crates.io
You can install `impala` from [crates.io](https://crates.io/crates/impala)
```shell
cargo install impala
```
### 🐧Arch Linux
You can install `impala` from the [official repositories](https://archlinux.org/packages/extra/x86_64/impala/) with using [pacman](https://wiki.archlinux.org/title/pacman).
```bash
pacman -S impala
```
### Nixpkgs
```shell
nix-env -iA nixpkgs.impala
```
### ⚒️ Build from source
Run the following command:
```shell
git clone https://github.com/pythops/impala
cd impala
cargo build --release
```
This will produce an executable file at `target/release/impala` that you can copy to a directory in your `$PATH`.
## 🪄 Usage
### Global
`Tab` or `Shift + Tab`: Switch between different sections.
`j` or `Down` : Scroll down.
`k` or `Up`: Scroll up.
`ctrl+r`: Switch adapter mode.
`?`: Show help.
`esc`: Dismiss the different pop-ups.
`q` or `ctrl+c`: Quit the app.
### Device
`i`: Show device information.
`o`: Toggle device power.
### Station
`s`: Start scanning.
`Space`: Connect/Disconnect the network.
### Known Networks
`a`: Enable/Disable auto-connect.
`d`: Remove the network from the known networks list.
### Access Point
`n`: Start a new access point.
`x`: Stop the running access point.
## Custom keybindings
Keybindings can be customized in the config file `$HOME/.config/impala/config.toml`
```toml
switch = "r"
mode = "station"
[device]
infos = "i"
toggle_power = "o"
[access_point]
start = 'n'
stop = 'x'
[station]
toggle_scanning = "s"
toggle_connect = " "
[station.known_network]
toggle_autoconnect = "a"
remove = "d"
```
## ⚖️ License
GPLv3