{"id":49884000,"url":"https://github.com/tailsmails/envelop","last_synced_at":"2026-05-28T12:30:37.296Z","repository":{"id":356913533,"uuid":"1232980346","full_name":"tailsmails/envelop","owner":"tailsmails","description":"Generates background HTTP HEAD requests to obfuscate real web traffic","archived":false,"fork":false,"pushed_at":"2026-05-18T13:07:26.000Z","size":35,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-18T14:40:46.393Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"V","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tailsmails.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-08T13:15:51.000Z","updated_at":"2026-05-18T13:08:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tailsmails/envelop","commit_stats":null,"previous_names":["tailsmails/envelop"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tailsmails/envelop","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailsmails%2Fenvelop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailsmails%2Fenvelop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailsmails%2Fenvelop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailsmails%2Fenvelop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tailsmails","download_url":"https://codeload.github.com/tailsmails/envelop/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailsmails%2Fenvelop/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33609237,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-15T17:00:45.923Z","updated_at":"2026-05-28T12:30:37.285Z","avatar_url":"https://github.com/tailsmails.png","language":"V","funding_links":[],"categories":["Applications"],"sub_categories":["Command-line"],"readme":"# Envelop\n\nEnvelop 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.\n\n## Features\n\n* **High Concurrency:** Utilizes lightweight concurrent workers to generate requests rapidly without blocking the main thread.\n* **Flexible Input Sources:** Load your target website lists and custom User-Agent lists from either local text files or remote URLs.\n* **Low Overhead:** Uses raw TCP sockets to send minimalistic `HEAD` requests, ensuring minimal bandwidth usage and faster execution compared to standard HTTP GET requests.\n* **Highly Customizable:** Offers command-line flags to easily adjust the number of concurrent workers, connection timeouts, and the total volume of requests generated.\n* **Focus Mode:** Simulates a real user focusing on a specific site by staying longer and visiting more related internal pages.\n* **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.\n\n## Prerequisites\n\nTo compile and run this project, you must have the [V programming language](https://vlang.io/) installed on your system.\n\n## Quick Install\n\n```sh\napt update -y \u0026\u0026 apt install -y git clang make \u0026\u0026 if ! command -v v \u003e/dev/null 2\u003e\u00261; then git clone --depth=1 https://github.com/vlang/v \u0026\u0026 cd v \u0026\u0026 make \u0026\u0026 ./v symlink \u0026\u0026 cd ..; fi \u0026\u0026 git clone --depth=1 https://github.com/tailsmails/envelop \u0026\u0026 cd envelop \u0026\u0026 v -enable-globals -prod envelop.v -o envelop \u0026\u0026 ln -sf $(pwd)/envelop $PREFIX/bin/envelop\n```\n\n## Build Instructions\n\n1. Clone or download the source code to your local machine.\n2. Open your terminal and navigate to the project directory.\n3. Compile the application using the V compiler. For the best performance, compile it with the production flag:\n\n```bash\nv -prod envelop.v -o envelop\n```\n\n---\n\n## Usage\n\nYou can run the compiled executable directly from your terminal. The only strictly required argument is the `--list` flag, which points to your target websites.\n\n```bash\n./envelop --list \u003cpath_or_url\u003e [options]\n```\n\n### Command-Line Arguments\n\n* `-l`, `--list` *(Required)*: Path or URL containing the site list. Each domain or URL must be on a new line.\n* `-u`, `--user-agents` *(Optional)*: Path or URL to a custom User-Agents list. Each User-Agent must be on a new line.\n* `-t`, `--timeout` *(Optional)*: Read and write timeout for HTTP requests in seconds. Default is `5`.\n* `-w`, `--workers` *(Optional)*: Number of concurrent workers (threads) to spawn. Default is `10`.\n* `-r`, `--redirect` *(Optional)*: Pass `0` to disable redirects, or any other integer to enable them. Default is `0`.\n* `-c`, `--count` *(Optional)*: Total number of random requests to generate across all workers before exiting. Default is `500`.\n* `-f`, `--focus` *(Optional)*: Enable focus mode. This simulates longer visits (15-45 seconds) and increases the frequency of related site visits.\n\n## Examples\n\n**Basic Usage**\nRead a local file named `sites.txt` and generate the default 500 requests using 10 workers:\n```bash\n./envelop --list sites.txt\n```\n\n**Remote Site List**\nFetch the target websites directly from a remote URL:\n```bash\n./envelop -l https://example.com/my_sites.txt\n```\n\n**Advanced Configuration**\nGenerate 5000 requests using 50 workers, a 10-second timeout, and a remote custom User-Agent list:\n```bash\n./envelop -l sites.txt -u https://example.com/user_agents.txt -w 50 -t 10 -c 5000\n```\n\n## Input File Format\n\nBoth the site list and the custom User-Agent list should be plain text files with one entry per line.\n\n**sites.txt:**\n```text\ngoogle.com\nhttps://github.com\nwikipedia.org\n```\n*(Note: If the `http://` or `https://` protocol is missing, the tool will automatically prepend `http://`)*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftailsmails%2Fenvelop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftailsmails%2Fenvelop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftailsmails%2Fenvelop/lists"}