betternmtui

A modern terminal UI for NetworkManager, built with React and OpenTUI. Manage Wi-Fi, Ethernet, and network connections without leaving the terminal.

Features

• Connections -- View, toggle, edit, delete, import/export saved connections
• Wi-Fi -- Scan networks, connect with password prompt, join hidden SSIDs
• Devices -- Inspect network interfaces and their states
• Details -- View full connection properties with inline editing
• Live updates -- Polls NetworkManager for external changes automatically
• Notifications -- Toast messages and a persistent notification log
• Vi-style navigation -- j/k, h/l, Tab/Shift+Tab between panels

Requirements

• Linux with NetworkManager installed (nmcli must be available)
• Bun >= 1.0.0

Installation

bun install -g betternmtui

Then run:

betternmtui

Run from source

git clone https://github.com/anipr2002/betternmtui.git
cd betternmtui
bun install
bun run start

Keybindings

| Key | Action | |---|---| | Tab / Shift+Tab | Switch tabs | | j / k or arrows | Navigate lists | | Enter | Toggle connection / connect to network | | e | Edit selected connection | | d | Delete selected connection | | r | Refresh data | | s | Scan Wi-Fi networks | | h | Connect to hidden network | | / | Search / filter | | n | Open notification log | | q / Ctrl+C | Quit |

Environment variables

| Variable | Default | Description | |---|---|---| | NMTUI_POLL_INTERVAL | 5000 | Polling interval in ms for connection state | | NMTUI_WIFI_REFRESH | 30000 | Wi-Fi scan refresh interval in ms |

License

MIT