Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A Python 3 CLI tool for automating the management of NordVPN OpenVPN servers through NetworkManager.

Project description

Build Status

This tool removes the need for manually handling OpenVPN configurations from NordVPN. It will synchronise the best servers from chosen countries into the NetworkManager VPN list. A synchronised VPN can then be chosen to auto-connect to, whenever NetworkManager brings an network connection up.

More documentation will be available when this tool is out of Alpha releases.

Warning: This tool is still highly under development and is not yet robust enough to use reliably. I take no responsibility for any unforseen problems it may cause.

Features:

  • Uses the latest NordVPN OpenVPN configuration files.
  • Imports the ‘best’ server of each available type (country, category, protocol), based on latency and server load.
  • Provides humanly readable connection names, so you can easily tell what each option offers.
  • Provides settings for whitelisting or blacklisting certain countries from being synchronised.
  • Automatically adds user credentials to the imported configurations.
  • Uses the NordVPN DNS servers to prevent DNS request leaks.
  • Disables IPv6 by default, to avoid IPv6 leaks.
  • Sets the auto connect server of your choice for all NetworkManager connections, instead of per connection. (optional)

1. Requirements

Debian/Ubuntu

sudo apt update && sudo apt install openvpn network-manager network-manager-gnome network-manager-openvpn-gnome

Arch

sudo pacman -S networkmanager openvpn networkmanager-openvpn

2. Installation

Please note: This tool requires Python 3.5 or later. (May change in the future)

sudo -H pip3 install nordnm

3. Usage

Setup/Update Configuration

sudo nordnm --update

This will download the latest openvpn configuration files, prompt you for your account credentials and also create a settings file ($HOME/.nordnm/settings.conf). Currently, you will need to manually edit the settings file with your desired configuration.

If you experience connections failing, you may want to run the update parameter again, since the configuration files may have been updated.

Synchronising

sudo nordnm --sync

This option will use your current settings to find the best server for each country, category and protocol combination that you have enabled. The configurations will then be added to NetworkManager automatically, ready to use.

Auto-Connect to a Server

sudo nordnm --auto-connect <country_code> <category> <protocol>

Auto-connect allows you to choose a server from your already synchronised configurations to automatically connect to whenever an Internet enabled network interface (e.g. wifi/ethernet) connects to a network.

Remove All Connections

sudo nordnm --purge

Removes all of the synchronised VPN configurations from NetworkManager and any enabled auto-connection setup.

Update Credentials

sudo nordnm --credentials

Allows you to re-enter your account credentials via the terminal, instead of editing files manually.

Update Settings

sudo nordnm --settings

Allows you to re-enter synchronisation settings.

Help

sudo nordnm --help

Simply display all the options above with a short description.

Suggestions/Bugs

If you have any feature suggestions or find an interesting bug, please let me know. More intuitive options and fixes will be coming in the future.

Project details


Release history Release notifications

History Node

0.5.4

History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.0

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.1

History Node

0.2.0

History Node

0.1.0

History Node

0.0a15

History Node

0.0a14

History Node

0.0a13

History Node

0.0a12

History Node

0.0a11

History Node

0.0a10

History Node

0.0a9

History Node

0.0a8

History Node

0.0a7

This version
History Node

0.0a6

History Node

0.0a5

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
nordnm-0.0a6.tar.gz (26.5 kB) Copy SHA256 hash SHA256 Source None Sep 14, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page