/mvtui

A Terminal User Interface for Mullvad VPN

Primary LanguageNim


MvTUI - Mullvad Terminal UI

MvTUI is a terminal-based user interface for managing Mullvad VPN connections. MvTUI provides a convenient way to interact with Mullvad's VPN service directly from the terminal, eliminating the need for CLI commands.

🔭 Features

  • Connect / Disconnect: Quickly toggle your VPN connection on or off.
  • Change Relay: Switch between different Mullvad VPN relays.
  • Login: Login to your Mullvad account.
  • Account Information: View essential account details.

Planned Features

  • Device Management: Add or remove devices associated with your Mullvad account.
  • Settings: Configure fundamental settings such as connection preferences and encryption.

🔧 Installation

To install MvTUI, ensure you have mullvad, git, nim and nimble installed on your system. Then, clone this repository and install with the following commands:

git clone https://github.com/iinsertNameHere/mvtui
cd mvtui
nim release

The compiled binary can be found in the mvtui/bin/ folder.

📡 Usage

Start MvTUI by running it in your terminal:

./mvtui

📎 Keybindings

  • q: Quit MvTUI
  • Up Arrow: Move selection up
  • Down Arrow: Move selection down
  • Enter: Confirm selection
  • Backspace: Go back to the previous menu
  • h: Display the help menu with keybindings and feature info

‼️ Disclaimer

MvTUI is an independent project and is not affiliated with Mullvad. Use this software responsibly and follow Mullvad's terms of service.

♥️ Shoutout

🐛 Bugs

Feel free to reach out via Issues for questions, feature requests, or bug reports.