mullvadrb

Ruby TUI for Mullvad VPN

This is a Terminal App I wrote for myself to use with Mullvad VPN on Linux. It makes it easier for me to choose servers when using Mullvad from the command line.

The app has two "backends", Mullvad CLI or WireGuard.

Most of the basic functionality is available for either backend: Select a server (random, by country, specific server), connect, disconnect and show the current status. You can use either backend. The first time you run the app, it's going to ask you which one you want to use, and save your preference in ~/.local/share/mullvadrb/mullvardrb.yml. You can switch backends from the Main Menu on the app at any time.

Requirements

You need to have a Mullvad VPN account to use the app.

[!WARNING] mullvad uses WireGuard, so if you change backends while connected to an OpenVPN server with wg, mullvad won't be able to disconnect from the OpenVPN connection. In general, it's a good idea to stick to one backend, and disconnect from the VPN before switching backends. This might potentially be fixed in the future.

For the WireGuard backend

You need to install WireGuard and follow the instructions on Mullvad: WireGuard on Linux terminal. The configuration script you are asked to run in this last link will download the WireGuard configuration files needed to /etc/wireguard.

The app is basically a layer on top of wg-quick. The scripts it runs are:

$ wg-quick up <connected server (e.g. uy-mma-wg-001)> # Connect with WireGuard
$ curl https://am.i.mullvad.net/connected # Check if you're connected to Mullvad
$ wg-quick down <connected server> # Disconnect

It uses sudo to read the files on /etc/wireguard and execute wg-quick for connecting and disconnecting.

For the Mullvad CLI backend

You need to install the Mullvad CLI to use this backend.

On first run, you need to log in (unless you've already run mullvad account login on your terminal before). The servers list will be updated and will be saved to ~/.local/share/mullvadrb.dump. You can update the server list at any time from the main menu.

Development

Run gem from the source:

$ irb -Ilib -rmullvadrb