nachovizzo / expressvpn-python

ExpressVPN - Python Wrapper (public IP auto fetch)

ExpressVPN - Python Wrapper (LINUX)

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

Download the package on the official website

The package DEB for Ubuntu 64bits 1.2.0 is already part of the repository. For the other OS, please refer to: https://www.expressvpn.com/support/vpn-setup/app-for-linux/#download

git clone [e-mail]:philipperemy/expressvpn-python.git evpn
cd evpn
sudo dpkg -i expressvpn_1.2.0_amd64.deb # will install the binaries provided by ExpressVPN
sudo pip install . # will install it as a package

Set up expressvpn

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

expressvpn activate # paste your activate key and press ENTER.
expressvpn preferences set send_diagnostics false

To logout, simply run:

expressvpn logout

NOTE that you will have to activate expressvpn again if you logout.

Python bindings

expressvpn connect

Binding is connect().

expressvpn connect [ALIAS]

Binding is connect_alias(alias).

expressvpn disconnect

Binding is 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:

from expressvpn import wrapper
import logging

def main():
    while True:
        try:
            scrape()
        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.')