____            _           __     ______  _   _   _____ _   _ ___
|  _ \ _ __ ___ | |_ ___  _ _\ \   / /  _ \| \ | | |_   _| | | |_ _|
| |_) | '__/ _ \| __/ _ \| '_ \ \ / /| |_) |  \| |   | | | | | || |
|  __/| | | (_) | || (_) | | | \ V / |  __/| |\  |   | | | |_| || |
|_|   |_|  \___/ \__\___/|_| |_|\_/  |_|   |_| \_|   |_|  \___/|___|

ProtonVPN TUI

A minimal, TUI and keyboard friendly wrapper for proton-vpn-cli.

• Features
• Installation
• Configuration

⚠️ DISCLAIMER This project is NOT affiliated with, endorsed by, or connected to Proton AG or ProtonVPN in any way. It is an unofficial, community-driven tool.

Features

• Server selection: Connect to any ProtonVPN server
• Filters: Filter servers by Secure Core, P2P, Tor, and more
• Free account compatible: Works with free ProtonVPN accounts
• Mouse support: Navigate and interact using your mouse
• Settings editor: Edit settings such as Kill Switch, NetShield, and more

Installation

Go install

go install github.com/anotherhadi/proton-vpn-tui/cmd/proton-vpn-tui@latest

Requires Go 1.22+. The binary will be placed in $GOPATH/bin (or ~/go/bin).

NUR (Nix/NixOS)

Available via NUR, under the anotherhadi repo:

# configuration.nix / home.nix
environment.systemPackages = [ nur.repos.anotherhadi.proton-vpn-tui ];

Configuration

Proton-VPN-TUI is fully configured via a YAML file at ~/.config/proton-vpn-tui/config.yaml. Check the default configuration with all the options here

Colors and styles can be customized using ilovetui, which applies theme changes across all compatible TUI applications at once.

---

github | gitlab (mirror) | gitea (mirror)