Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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.
- Host: GitHub
- URL: https://github.com/nemmusu/free-vpn-downloader
- Owner: nemmusu
- Created: 2024-11-24T20:40:15.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-11-24T20:56:23.000Z (2 months ago)
- Last Synced: 2024-11-24T21:29:23.527Z (2 months ago)
- Topics: automation, crawler, download, downloader, free, freevpn, openvpn, ovpn, ovpn-files, vpn
- Language: Python
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
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
```