nettui

nettui is a unified terminal UI for Wi-Fi and Ethernet.

It is a clean-room project inspired by the UX direction of tools like impala and ethtui, with one app shell and switchable Wi-Fi/Ethernet panels.
This project was inspired by and builds upon ideas from Impala by pythops.

✨ Features

• One TUI with two transport tabs: Wi-Fi and Ethernet
• Startup tab policy: prefer active transport (Ethernet if active, else Wi-Fi if active)
• Wi-Fi workflow with split sections: Known Networks, New Networks, Device
• Non-blocking scan/connect with spinner feedback
• Connect/disconnect, forget, autoconnect toggle, hidden SSID connect
• Passphrase fallback flow when iwd reports No Agent registered
• Ethernet details + link up/down + DHCP renew
• Configurable keybinds via ~/.config/nettui/keybinds.toml
• Toast/error popups and terminal size guard (119x35 minimum)

💡 Prerequisites

• Linux
• iwd running and reachable on D-Bus
• systemd-networkd + networkctl available
• Nerd Fonts recommended for icon rendering

[!IMPORTANT] To avoid network stack conflicts, keep one wireless manager in control. If iwd is your backend, avoid running overlapping managers for Wi-Fi (for example NetworkManager or wpa_supplicant) at the same time.

🚀 Installation

crates.io

cargo install nettui

Arch Linux (AUR source build)

yay -S nettui

Arch Linux (AUR prebuilt binary)

yay -S nettui-bin

🪄 Usage

nettui

⌨️ Controls

Global:

• h/l or ←/→: switch transport tab (Wi-Fi / Ethernet)
• j/k or ↓/↑: move selection
• r: refresh (shows info toast)
• q or Esc: quit

Wi-Fi tab:

• Tab / Shift+Tab: switch focus (Known / New / Device)
• s: scan
• Enter: connect/disconnect selected network
• a: show/hide extra entries (Known: unavailable, New: hidden)
• d: forget selected known network
• t: toggle autoconnect for selected known network
• n: connect hidden network (in New)
• i: toggle Wi-Fi details popup
• Empty New Networks list shows - no new networks -

Ethernet tab:

• Enter: toggle selected interface link (up/down)
• n: renew DHCP on selected interface

⚙️ Keybind config

Config file path:

~/.config/nettui/keybinds.toml

On first launch, nettui auto-creates this file with defaults.

To reset from template:

mkdir -p ~/.config/nettui
cp /usr/share/doc/nettui/keybinds.toml.example ~/.config/nettui/keybinds.toml

Edit this file directly and restart nettui after changes.

🔄 Restart / control

nettui is not a systemd service, so systemctl does not apply.

Quick restart:

pkill -x nettui || true
omarchy-launch-or-focus-tui nettui

🧩 Omarchy integration

Official Omarchy dev launcher (bin/omarchy-launch-wifi) is:

rfkill unblock wifi
omarchy-launch-or-focus-tui impala

So installing ethtui alone does not replace Wi-Fi handling automatically.

To use nettui instead of impala in your local Omarchy install:

sed -i 's/omarchy-launch-or-focus-tui impala/omarchy-launch-or-focus-tui nettui/g' ~/.local/share/omarchy/bin/omarchy-launch-wifi

Verify:

sed -n '1,120p' ~/.local/share/omarchy/bin/omarchy-launch-wifi

Optional Hyprland size rule for org.omarchy.nettui:

grep -q "match:class org.omarchy.nettui" ~/.config/hypr/apps/system.conf || echo "windowrule = size 1190 735, match:class org.omarchy.nettui" >> ~/.config/hypr/apps/system.conf
hyprctl reload

🛠️ Build

cargo build
cargo test
cargo clippy --all-targets --all-features -- -D warnings

📦 Maintainer Release Asset

Always build the GitHub release tarball with:

./scripts/build-release-asset.sh

This script enforces the archive layout expected by nettui-bin AUR:

• nettui-v<version>-x86_64/nettui
• nettui-v<version>-x86_64/README.md
• nettui-v<version>-x86_64/LICENSE
• nettui-v<version>-x86_64/config/keybinds.toml.example

⚖️ License

nettui is licensed under GPL-3.0-only. See LICENSE.