Skip to content
A python application with gui to connect automatically to the recommended NordVPN server of a certain type
Python Shell
Branch: master
Clone or download

README.md

NordPy

release 1.1 contributions welcome contributions welcome

A python application with gui to connect automatically to the recommended NordVPN server (as of NordVPN site) of a certain type, in a certain country or to the specific chosen server (stats for each server are shown in the relative window).

All server types on NordVPN site are available to be selected in the window.

KDE Plasma users can also find the relative plasmoid.

Tested against DNS leaks (NetworkManager use is discouraged (and disabled by default) as it may leak DNS)

NOTE : ikev2 support is tested on Debian, Arch and derivatives (if something's not right button won't show up)

Features

  • Automatic connection to recommended server (according to nordvpn.com)
  • TCP, UDP and IKEv2/IPsec protocols are available
  • Connection (TCP and UDP) can be established with either openvpn or NetworkManager-openvpn (will show connection in the system interface)
  • No DNS leak (when using openvpn)
  • Killswitch (when using openvpn)
  • Quick connection/disconnection from command line (according to last chosen server type)
  • Easy to setup for autoconnection at startup
  • Integrated with its own plasmoid

Installation and requirements

Arch Linux users can find this project on the AUR.

For Debian/Ubuntu, Fedora/Red Hat users:

To install all dependencies, download config files and to add a desktop entry in the main menu just run install.sh

For other distros:

install the following packages:

python3 python3-tk python3-requests openvpn wget unzip net-tools

and

strongswan strongswan-ikev2 libstrongswan-standard-plugins libstrongswan-extra-plugins libcharon-extra-plugins

to support ikev2 (facultative)

networkmanager-openvpn

to support Network Manager (facultative).

Then run install.sh

Installing with support for obfuscated servers

At the launch of the installation script you will be asked

Do you want to install support for obfuscated servers (it will reinstall openvpn)?[y/n] (Recommended: n)

if you answer is y then openvpn will be built from source (version 2.4.4) applying patch for obfuscation. If you do not run Debian/Ubuntu, Fedora or Arch, you should provide the following packages and then run install.sh

automake autoconf perl gnupg quilt libtool openssl-devel lzo-devel pam-devel net-tools

Note: Installing support for obfuscated servers breaks Network Manager openvpn support in some distros (in that case you should disable it in the advanced options)

Usage

Open the application, select your preferred server type (also manually) and protocol and just press connect. Once you are connected you can even close the application and reopen it when you want to disconnect the VPN. If the size of the window does not fit entirely the gui components change the scale factor in the advanced settings.

Additional info

  • The button "Reset settings" resets only the settings of the connection (each time a VPN connection is established the used options are saved and restored at the next start).
  • The percent associated to each server in the window for manual choice is the load (a big load implies a slower connection)
  • Advanced Settings

    Alt text

  • Scale Factor: this parameter affects the size of a window (will be restored at each start)
  • Network Manager: if checked NordPy will try to connect through networkmanager-openvpn plugin (disabled by default). Works only if network manager is enabled. It is discouraged the use, as it leaks DNS.
  • Command line interface

    nordpy can be called with 3 different commands (in this case the gui isn't opened):

    • --quick-connect starts a connection according to the last chosen preferences (you must first start a connection using the gui)
    • --quick-disconnect shuts down any connection that nordpy previously started
    • --status checks if any VPN is already running

    All options can be listed with nordpy --help

    Autostart

    You can easily configure nordpy to establish VPN connection at the start of your system. You just need to

    1. Install a cron implementation (I usually use cronie)
    2. Edit the root crontab (sudo crontab -e) and add the following line to it
    @reboot PATH/TO/nordpy.py --quick-connect --wait-connection
    

    (you can easily obtain your path to nordpy with which nordpy).

    You can disable it just by deleting the line you added to the crontab.

    Previews

    Alt text

    When pressed "Select":

    Alt text

    After connection has been established:

    Alt text

    Once closed and restarted:
    Alt text

    Caveat

    NordPy will not work on Fedora 29 since launching a tkinter.OptionMenu will cause the application to crash with Floating point exception (core dumped).

    For more info and bug progress see the bug I reported and the entire discussion on the issues page.

    You can’t perform that action at this time.