NordVPN Status in Tmux
When using a VPN it’s easy to lose track of whether you’re connected or which server you’re on.
tmux-nordvpn displays NordVPN connection information directly in the tmux status bar.
Installation
Using TPM
set -g @plugin 'maxrodrigo/tmux-nordvpn'
Press prefix + I to install.
Manual
git clone https://github.com/maxrodrigo/tmux-nordvpn ~/.tmux/tmux-nordvpn
# .tmux.conf
run-shell ~/.tmux/tmux-nordvpn/nordvpn.tmux
Reload with tmux source-file ~/.tmux.conf.
Usage
Add format strings to your status line:
set -g status-right 'VPN: #{nordvpn_status_color}#{nordvpn_status} (#{nordvpn_country})'
Format Strings
| Format | Description |
|---|---|
#{nordvpn_status} |
Connection status |
#{nordvpn_server} |
Current server |
#{nordvpn_country} |
Connection country |
#{nordvpn_city} |
Connection city |
#{nordvpn_ip} |
Connection IP address |
#{nordvpn_status_color} |
Dynamic color based on status |
Customization
set -g @nordvpn_connected_text "c"
set -g @nordvpn_connecting_text "…"
set -g @nordvpn_disconnected_text "d"
set -g @nordvpn_connected_fg_color "green"
set -g @nordvpn_connecting_fg_color "yellow"
set -g @nordvpn_disconnected_fg_color "red"
Update Interval
The plugin refreshes according to status-interval. Lower values mean faster updates:
set -g status-interval 5
Requirements
Requires the NordVPN CLI to be installed.