wiretui

June 3, 2026 ยท View on GitHub

Summary

A minimal keyboard-driven TUI to manage WireGuard VPN connections, heavily inspired by bluetui and impala.

Demo

animation

Prerequisites

You will need to use a Linux based operating system using the NetworkManager.

(Planned) features

  • list all imported connections
  • activate a connection
  • deactivate a connection
  • import a new connection from a config file
  • remove an existing connection
  • search connection list (#13)

Installation

Currently the only option to install is building from source, but it is planned to add pre-built binaries that you can download from releases (#3).

git clone https://github.com/robin-thoene/wiretui.git
cd wiretui
cargo install --path ./crates/tui/

Usage

Starting

wiretui

Keybindings

j: move down

k: move up

SPACE: toggle the selected connection

?: open the help menu

ESC: close a menu

q: quit application

i: open the menu to import a new connection

CTRL+d: delete the selected connection

Local development

CLI

Run the application

cargo run --bin wiretui-bin

Run the tests

cargo test

Check if you violated the hexagonal architecture dependency rules

./scripts/lint_architecture.sh

Check the workspace rules (using cargo-deny)

cargo deny check

Debugging

This project contains a debugger configuration using .vscode files.

Logging

This application uses the log crate in combination with the env_logger crate to set the log level. By default the logs are written to a file, which is overridden every time you run the application.

You can see it's current content with

cat ~/.local/state/wiretui/log.txt

To override the log level when running the application use

RUST_LOG=debug cargo run

Valid log level are trace, debug, info, warn and error.

Contributing

As of now this project is publicly available but not actively asking for or accepting pull requests until I finished my desired MVP state. This is due to the fact that the project is part of a university module as well as a learning opportunity for myself.

For the moment you can contribute best by:

  • submitting bug reports
  • reviewing code to be idiomatic, secure and performant

License

See the LICENSE