Envelop

Envelop is a lightweight, concurrent web traffic obfuscation tool written in the V programming language. It is designed to generate background HTTP HEAD requests to a specified list of websites. By creating randomized network noise, Envelop helps mask your actual web browsing activity and enhances your privacy.

Features

• High Concurrency: Utilizes lightweight concurrent workers to generate requests rapidly without blocking the main thread.
• Flexible Input Sources: Load your target website lists and custom User-Agent lists from either local text files or remote URLs.
• Low Overhead: Uses raw TCP sockets to send minimalistic HEAD requests, ensuring minimal bandwidth usage and faster execution compared to standard HTTP GET requests.
• Highly Customizable: Offers command-line flags to easily adjust the number of concurrent workers, connection timeouts, and the total volume of requests generated.
• Automatic Fallbacks: Includes a built-in list of common, up-to-date User-Agents in case a custom list is not provided or fails to load.

Prerequisites

To compile and run this project, you must have the V programming language installed on your system.

Quick Install

apt update -y && apt install -y git clang make && if ! command -v v >/dev/null 2>&1; then git clone --depth=1 https://github.com/vlang/v && cd v && make && ./v symlink && cd ..; fi && git clone --depth=1 https://github.com/tailsmails/envelop && cd envelop && v -enable-globals -prod envelop.v -o envelop && ln -sf $(pwd)/envelop $PREFIX/bin/envelop

Build Instructions

1. Clone or download the source code to your local machine.
2. Open your terminal and navigate to the project directory.
3. Compile the application using the V compiler. For the best performance, compile it with the production flag:

v -prod envelop.v -o envelop

---

Usage

You can run the compiled executable directly from your terminal. The only strictly required argument is the --list flag, which points to your target websites.

./envelop --list <path_or_url> [options]

Command-Line Arguments

• -l, --list (Required): Path or URL containing the site list. Each domain or URL must be on a new line.
• -u, --user-agents (Optional): Path or URL to a custom User-Agents list. Each User-Agent must be on a new line.
• -t, --timeout (Optional): Read and write timeout for HTTP requests in seconds. Default is 5.
• -w, --workers (Optional): Number of concurrent workers (threads) to spawn. Default is 10.
• -r, --redirect (Optional): Pass 0 to disable redirects, or any other integer to enable them. Default is 0.
• -c, --count (Optional): Total number of random requests to generate across all workers before exiting. Default is 500.

Examples

Basic Usage Read a local file named sites.txt and generate the default 500 requests using 10 workers:

./envelop --list sites.txt

Remote Site List Fetch the target websites directly from a remote URL:

./envelop -l https://example.com/my_sites.txt

Advanced Configuration Generate 5000 requests using 50 workers, a 10-second timeout, and a remote custom User-Agent list:

./envelop -l sites.txt -u https://example.com/user_agents.txt -w 50 -t 10 -c 5000

Input File Format

Both the site list and the custom User-Agent list should be plain text files with one entry per line.

sites.txt:

google.com
https://github.com
wikipedia.org

(Note: If the http:// or https:// protocol is missing, the tool will automatically prepend http://)