vesper

vesper — Professional OSINT Username Scanner

A high-performance username investigation tool that searches across 2000+ social networks and websites. Built in Rust with async concurrency, a polished CLI, and professional-grade logging.

✨ Features

• 🔎 Comprehensive Coverage: Search across 2000+ social networks and platforms
• ⚡ Blazing Fast: Async concurrent scanning with configurable worker pools (32 workers default)
• 🎨 Beautiful CLI: Professional OSINT-style output with colors, progress tracking, and structured logging
• 🔒 Privacy-Focused: Optional Tor proxy support for anonymous scanning
• 📸 Screenshot Capture: Automated headless Chrome screenshots of found profiles
• 📥 Content Download: Download profile data from supported sites (Instagram, etc.)
• 🧾 JSON Reports: Save scan results to a machine-readable report file
• 🧪 Site Validation: Built-in test mode to verify site configurations

🚀 Installation

Prerequisites

• Rust 1.70+ - Install Rust
• Chrome/Chromium (optional, for screenshots) - Version 60+

Build from Source

git clone https://github.com/krishpranav/vesper
cd vesper
cargo build --release

The compiled binary will be available at ./target/release/vesper

Install Globally

cargo install --path .

📖 Usage

Basic Scan

vesper krishpranav

Scan Multiple Usernames

vesper krishpranav blue red

Verbose Output (Show Not Found Sites)

vesper user -v

Specific Site Only

vesper user --site github

With Tor Proxy

Requires Tor running on 127.0.0.1:9050

vesper user --tor

Capture Screenshots

vesper user --screenshot

Screenshots will be saved to screenshots/<username>/

Download Content

vesper user --download

Update Database

vesper user --update

Save JSON Report

vesper user --output report.json

Test Mode (Validate Site Configurations)

vesper --test

All Options

vesper --help

🎯 Example Output

    ██╗   ██╗ ███████╗ ██████╗ ██████╗ ███████╗ ██████╗ 
    ██║   ██║ ██╔════╝██╔════╝ ██╔══██╗ ██╔════╝ ██╔══██╗
    ██║   ██║ █████╗  ╚█████╗  ██████╔╝ █████╗  ██████╔╝
    ╚██╗ ██╔╝ ██╔══╝   ╚═══██╗ ██╔═══╝  ██╔══╝  ██╔══██╗
     ╚████╔╝  ███████╗ ██████╔╝ ██║      ███████╗ ██║  ██║
      ╚═══╝   ╚══════╝ ╚═════╝  ╚═╝      ╚══════╝ ╚═╝  ╚═╝
    
    🔎 vesper — Professional OSINT Username Scanner

🔎 Investigating user on:

[+] GitHub: https://www.github.com/user
[+] Instagram: https://www.instagram.com/user
[+] Twitter: https://twitter.com/user
[-] Pinterest: Not Found!

═══════════════════════════════════════
  🧠 SCAN COMPLETE
═══════════════════════════════════════
  Found: 12
  Checked: 2300
  Time: 3.2s
═══════════════════════════════════════

🛠️ CLI Flags

Flag	Short	Description
--help	-h	Show help message
--version	-V	Show version
--no-color		Disable colored output
--verbose	-v	Show not found sites
--tor	-t	Use Tor proxy (127.0.0.1:9050)
--screenshot	-s	Take screenshots of found profiles
--download	-d	Download profile content
--output <FILE>	-o	Save scan results as JSON
--update		Update site database from Sherlock
--database <PATH>		Use custom database file
--site <SITE>		Check specific site only
--test		Run site validation tests

🔧 Configuration

Worker Pool Size

• Default: 32 concurrent workers
• With Screenshots: 8 workers (automatically reduced)

Tor Proxy

Default proxy address: socks5://127.0.0.1:9050

To use Tor:

1. Install and start Tor service
2. Run vesper with --tor flag

📊 Performance

The Rust implementation provides:

• Async I/O: Non-blocking concurrent requests using Tokio
• Memory Efficient: Minimal allocations with zero-copy where possible
• Fast Startup: Compiled binary with instant execution
• Resource Control: Configurable concurrency limits

🎨 Technology Stack

• Runtime: Tokio - Async runtime
• HTTP: Reqwest - HTTP client with SOCKS5 support
• CLI: Clap - Command-line argument parsing
• Logging: Tracing - Structured logging
• UI: Indicatif + Console + Colored - Beautiful terminal output
• Screenshots: Headless Chrome - Browser automation
• Regex: Fancy Regex - Advanced pattern matching

📝 Data Files

The following files are unchanged from upstream:

• data.json - Site database (2000+ sites)
• sites.md - Site documentation
• generate_sites_md.py - Site list generator

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📜 License

MIT License - see LICENSE file for details

🔗 Related Projects

• Sherlock - Python OSINT tool
• WhatsMyName - Username enumeration

---

Made with ❤️ and Rust