https://github.com/tailsmails/envelop
Generates background HTTP HEAD requests to obfuscate real web traffic
https://github.com/tailsmails/envelop
Last synced: 15 days ago
JSON representation
Generates background HTTP HEAD requests to obfuscate real web traffic
- Host: GitHub
- URL: https://github.com/tailsmails/envelop
- Owner: tailsmails
- Created: 2026-05-08T13:15:51.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-18T13:07:26.000Z (25 days ago)
- Last Synced: 2026-05-18T14:40:46.393Z (25 days ago)
- Language: V
- Homepage:
- Size: 34.2 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-v - envelop - Generates background HTTP HEAD requests to obfuscate real web traffic. (Applications / Command-line)
README
# 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.
* **Focus Mode:** Simulates a real user focusing on a specific site by staying longer and visiting more related internal pages.
* **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](https://vlang.io/) installed on your system.
## Quick Install
```sh
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:
```bash
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.
```bash
./envelop --list [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`.
* `-f`, `--focus` *(Optional)*: Enable focus mode. This simulates longer visits (15-45 seconds) and increases the frequency of related site visits.
## Examples
**Basic Usage**
Read a local file named `sites.txt` and generate the default 500 requests using 10 workers:
```bash
./envelop --list sites.txt
```
**Remote Site List**
Fetch the target websites directly from a remote URL:
```bash
./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:
```bash
./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:**
```text
google.com
https://github.com
wikipedia.org
```
*(Note: If the `http://` or `https://` protocol is missing, the tool will automatically prepend `http://`)*