Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nemmusu/free-vpn-downloader

This repository contains three Python scripts designed to simplify the process of downloading and configuring free VPN .ovpn files for use with OpenVPN.
https://github.com/nemmusu/free-vpn-downloader

automation crawler download downloader free freevpn openvpn ovpn ovpn-files vpn

Last synced: about 2 months ago
JSON representation

This repository contains three Python scripts designed to simplify the process of downloading and configuring free VPN .ovpn files for use with OpenVPN.

Awesome Lists containing this project

README

        

# Free VPN Downloader

This repository contains three Python scripts designed to download and configure free VPN `.ovpn` files for use with OpenVPN. The main script, `vpn-downloader.py`, downloads VPN files from multiple sources, while the other two scripts focus on single sources for more specific needs.

## Scripts Overview

1. **`vpn-downloader.py`**
- Downloads VPN configurations from both [VPNGate](http://www.vpngate.net/) and [VPNBook](https://www.vpnbook.com/freevpn).
- Processes, configures, and prepares `.ovpn` files automatically.

2. **`vpngate-downloader.py`**
- Downloads and configures `.ovpn` files exclusively from VPNGate's official API.

3. **`vpnbook-downloader.py`**
- Downloads and configures `.ovpn` files exclusively from the VPNBook website.

## Requirements

- Python 3.x
- Required Python libraries:
- `requests`
- `bs4` (BeautifulSoup)

Install the required libraries using:

```bash
pip install -r requirements.txt
```

## Usage

### `vpn-downloader.py`

Downloads VPN configurations from both VPNGate and VPNBook.

```bash
python3 vpn-downloader.py -o [-p ]
```

- **`-o`**: Specifies the output folder to save the `.ovpn` files.
- **`-p`**: (Optional) Sets a custom password for VPNBook.

Example:

```bash
python3 vpn-downloader.py -o vpn-configs
```

#### Output Example

```
[VPNGate] Starting configuration process...
[INFO] Credentials file created: vpn-dir/vpngate.txt
[VPNGate] Found 99 valid configurations.
[VPNGate] Progress: 100% completed
[VPNGate] Configuration process completed. Created 0 new files (99 existents).
[VPNBook] Starting configuration process...
[VPNBook] Found .zip files to download.
[VPNBook] Found 48 .ovpn files.
[INFO] Credentials file created: vpn-dir/vpnbook.txt
[VPNBook] Progress: 100% completed
[VPNBook] All configuration files already exist. No new files were created.
[VPNBook] Temporary folder cleaned up.

[INFO] Stored 147 configured .ovpn files
[INFO] If the VPNBook VPNs don't work, update the password by visiting: https://www.vpnbook.com/freevpn
[INFO] Use the --password option to specify a new password for VPNBook if needed.
```

### `vpngate-downloader.py`

Downloads VPN configurations exclusively from VPNGate.

```bash
python3 vpngate-downloader.py -o [-af ]
```

- **`-o`**: Specifies the output folder to save the `.ovpn` files.
- **`-af`**: (Optional) Sets a custom name for the authentication file (default: `vpngate.txt`).

Example:

```bash
python3 vpngate-downloader.py -o vpn-configs -af my_auth.txt
```

### `vpnbook-downloader.py`

Downloads VPN configurations exclusively from VPNBook.

```bash
python3 vpnbook-downloader.py -o [-p ] [-af ]
```

- **`-o`**: Specifies the output folder to save the `.ovpn` files.
- **`-p`**: (Optional) Sets a custom password for VPNBook.
- **`-af`**: (Optional) Sets a custom name for the authentication file (default: `vpnbook.txt`).

Example:

```bash
python3 vpnbook-downloader.py -o vpn-configs -p newpassword -af custom_auth.txt
```