Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/philipperemy/expressvpn-python
ExpressVPN - Python Wrapper (IP auto switch).
https://github.com/philipperemy/expressvpn-python
python vpn vpn-client vpn-connections wrapper
Last synced: about 6 hours ago
JSON representation
ExpressVPN - Python Wrapper (IP auto switch).
- Host: GitHub
- URL: https://github.com/philipperemy/expressvpn-python
- Owner: philipperemy
- License: mit
- Created: 2017-02-21T06:43:41.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-03-19T05:49:07.000Z (over 1 year ago)
- Last Synced: 2024-09-08T12:10:06.632Z (25 days ago)
- Topics: python, vpn, vpn-client, vpn-connections, wrapper
- Language: Python
- Homepage:
- Size: 27.4 MB
- Stars: 183
- Watchers: 6
- Forks: 49
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ExpressVPN - Python Wrapper (LINUX)
[](https://pepy.tech/project/expressvpn-python)
[](https://pepy.tech/project/expressvpn-python)
Full bash documentation: [https://www.expressvpn.com/support/vpn-setup/app-for-linux/](https://www.expressvpn.com/support/vpn-setup/app-for-linux/)
This will not work on Windows!
## Installation with PyPI
If the command `expressvpn` is already installed on your Ubuntu then just run this:
```bash
pip install expressvpn-python
```
## Download/Install the package on the official website
The package DEB for Ubuntu 64bits 2.3.4 is already part of the repository. For another OS, please refer to:
[https://www.expressvpn.com/support/vpn-setup/app-for-linux/#download](https://www.expressvpn.com/support/vpn-setup/app-for-linux/#download)
```bash
git clone [email protected]:philipperemy/expressvpn-python.git evpn && cd evpn
sudo dpkg -i expressvpn_2.3.4-1_amd64.deb # will install the binaries provided by ExpressVPN
sudo pip install . # will install it as a package. Or install it within a virtualenv (better option).
```
## Change your public IP every x seconds
Check the script: [vpn.sh](vpn.sh).
## Set up expressvpn
You can find your activation key here: [https://www.expressvpn.com/setup](https://www.expressvpn.com/setup).
```bash
expressvpn activate # paste your activate key and press ENTER.
expressvpn preferences set send_diagnostics false
```
After login and to logout, simply run:
```bash
expressvpn logout
```
NOTE that you will have to activate `expressvpn` again if you logout.
## Python bindings
### Connect
Bash
```bash
expressvpn connect
```
Python
```python
from expressvpn import connect
connect()
```
### Connect with alias
Bash
```bash
expressvpn connect [ALIAS]
```
Python
```python
from expressvpn import connect_alias
connect_alias(alias: str)
```
### Random connect(From fastest servers)
Python
```python
from expressvpn.wrapper import random_connect
random_connect()
```
### Random connect(From all servers)
Python
```python
from expressvpn.wrapper import random_connect
random_connect(True)
```
###
### Disconnect
Bash
```bash
expressvpn disconnect
```
Python
```python
from expressvpn 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:
```python
import logging
from expressvpn import wrapper
class BannedException(Exception):
pass
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.')
```