expressvpn-python-cli 1.0.7

Fork of the expressvpn-python library by Philippe Remy, with CLI support

ExpressVPN - Python Wrapper (LINUX) CLI Version

This fork supports cli version of Express VPN

This software is a modified version of the original developed by Philip Remy . It is adapted to work with current version of Express VPN for linux, in particular with CLI version.

Full bash documentation: https://www.expressvpn.com/support/vpn-setup/app-for-linux-cli/

This will not work on Windows!

Installation with PyPI

If the command expressvpn is already installed on your Ubuntu then just run this:

pip install expressvpn-python-cli

Download/Install the package on the official website

Refer to official site to download the official linux release: https://www.expressvpn.com/vpn-download/vpn-linux

Change your public IP every x seconds

Check the script: vpn.sh.

Set up expressvpn

You can find your activation key here: https://www.expressvpn.com/setup.

echo '[your activation code]' > activationCodeFile
expressvpnctl login activationCodeFile 

You can help improve ExpressVPN by sharing anonymized diagnostic reports. Enter Y to accept or n to decline.

After login and to logout, simply run:

expressvpnctl logout

NOTE that you will have to activate expressvpn again if you log out. NOTE To use connection commands in the CLI, either the ExpressVPN GUI client must be running, or background mode must be enabled.

Python bindings

Set Background mode enabled

Bash

    expressvpnctl background enable

Python

from expressvpn_cli import background_enabled
background_enabled()

Connect

Bash

expressvpnctl connect

Python

from expressvpn_cli import connect
connect()

Connect with alias

Bash

expressvpnctl connect "[ALIAS]"

Python

from expressvpn_cli import connect_alias
connect_alias("alias")

Random connect(From the fastest servers)

Python

from expressvpn_cli import random_connect
random_connect()

Random connect(From all servers)

Python

from expressvpn_cli import random_connect
random_connect(True)

Disconnect

Bash

expressvpnctl disconnect

Python

from expressvpn_cli import disconnect
disconnect()

IP auto switching

Sometimes websites like Amazon or Google will ban you after too many requests. It's easy to detect because your script will fail for some obscure reason. Most of the time, if the HTML contains the word captcha or if the websites returns 403, it means that you probably got banned. But don't panic, you can use a VPN coupled with IP auto switching. Here's an example of a scraper doing IP auto switching:

import logging

from expressvpn_cli import *


class BannedException(Exception):
    pass


def main():
    background_enabled()
    while True:
        try:
          # scrape() or any code you wish
          return 
        except BannedException as be:
            logging.info('BANNED EXCEPTION in __MAIN__')
            logging.info(be)
            logging.info('Lets change our PUBLIC IP GUYS!')
            change_ip()
        except Exception as e:
            logging.error('Exception raised.')
            logging.error(e)


def change_ip():
    max_attempts = 10
    attempts = 0
    while True:
        attempts += 1
        try:
            logging.info('GETTING NEW IP')
            wrapper.random_connect()
            logging.info('SUCCESS')
            return
        except Exception as e:
            if attempts > max_attempts:
                logging.error('Max attempts reached for VPN. Check its configuration.')
                logging.error('Browse https://github.com/philipperemy/expressvpn-python.')
                logging.error('Program will exit.')
                exit(1)
            logging.error(e)
            logging.error('Skipping exception.')