██╗   ██╗ ██████╗ ██╗██████╗ ███████╗███████╗ ██████╗
 ██║   ██║██╔═══██╗██║██╔══██╗██╔════╝██╔════╝██╔════╝
 ██║   ██║██║   ██║██║██║  ██║███████╗█████╗  ██║     
 ╚██╗ ██╔╝██║   ██║██║██║  ██║╚════██║██╔══╝  ██║     
  ╚████╔╝ ╚██████╔╝██║██████╔╝███████║███████╗╚██████╗
   ╚═══╝   ╚═════╝ ╚═╝╚═════╝ ╚══════╝╚══════╝ ╚═════╝

# Clone the repository
git clone https://github.com/VoidSecSoftwares/voidsec-proxy.git

# Enter the directory
cd voidsec-proxy

# Install (basic)
pip install -e .

# Install with crypto support (AES-GCM, ChaCha20, steganography)
pip install -e ".[crypto]"

# Start a SOCKS5 proxy chain
voidsec-proxy proxy -f proxies.txt

# Scan a target
voidsec-proxy scan -t 10.0.0.1

# Resolve DNS
voidsec-proxy dns example.com

# Generate a password
voidsec-proxy password -l 20 -c 5

# Full recon on a target
voidsec-proxy recon -t 10.0.0.1

# Basic usage
voidsec-proxy proxy -f proxies.txt

# Custom listen address and port
voidsec-proxy proxy -f proxies.txt -l 0.0.0.0 -p 1080

# Shuffle proxy order on start
voidsec-proxy proxy -f proxies.txt -s

# Scan common ports
voidsec-proxy scan -t 10.0.0.1

# Scan specific ports
voidsec-proxy scan -t 10.0.0.1 -p 22,80,443,3389

# Scan port range, export to JSON
voidsec-proxy scan -t 10.0.0.1 -r 1-1000 -o results.json -f json

# Resolve A records
voidsec-proxy dns example.com

# Multiple record types
voidsec-proxy dns example.com -t A -t MX -t TXT

# Reverse DNS lookup
voidsec-proxy dns 8.8.8.8 -r

# Subdomain enumeration
voidsec-proxy dns example.com -e -w wordlist.txt

# Crack MD5 hash
voidsec-proxy crack --hash 5f4dcc3b5aa765d61d8327deb882cf99 -t md5 -w rockyou.txt

# Hash text with SHA256
voidsec-proxy crack --hash-text "hello" -t sha256

# Hash file
voidsec-proxy crack --hash-file secret.bin -t sha512

# Generate 5 passwords, 20 chars each
voidsec-proxy password -l 20 -c 5

# Audit a password
voidsec-proxy password -a "MyP@ssw0rd"

# Generate 6-word passphrase
voidsec-proxy password --passphrase -l 6

# Apply all mutations
voidsec-proxy mutate -w wordlist.txt -o mutated.txt -m leet,upper,append_num,dups

# Leet speak + numbers
voidsec-proxy mutate -w wordlist.txt -o out.txt -m leet,append_num

# Full recon (IP, geo, ASN, open ports)
voidsec-proxy recon -t 10.0.0.1

# WHOIS lookup
voidsec-proxy recon --whois example.com

# IP geolocation
voidsec-proxy recon --geo 8.8.8.8

# ASN lookup
voidsec-proxy recon --asn 8.8.8.8

# Traceroute
voidsec-proxy recon --traceroute 8.8.8.8

# Full fingerprint
voidsec-proxy web -u https://target.com

# Header analysis
voidsec-proxy web --headers https://target.com

# Directory brute-force
voidsec-proxy web --dirbust https://target.com -w wordlist.txt

# Encode data
voidsec-proxy exfil --encode "secret data" -m base64
voidsec-proxy exfil --encode "secret data" -m morse
voidsec-proxy exfil --encode "secret data" -m dns

# Decode data
voidsec-proxy exfil --decode "dGVzdA==" -m base64

# Vigenere cipher
voidsec-proxy exfil --vigenere "encrypted" --key "secret"

# Encrypt a file
voidsec-proxy encrypt -i secret.txt -o secret.enc -p "mypassword"

# Decrypt a file
voidsec-proxy encrypt -i secret.enc -o secret.txt -p "mypassword" -d

# Shred file with 5 passes
voidsec-proxy shred -f file.txt -n 5

# Hide data in image
voidsec-proxy stego -i image.png -f secret.txt -o stego.png

# Extract hidden data
voidsec-proxy stego -i stego.png -e -o extracted.txt

# Python reverse shell
voidsec-proxy shell --lhost 10.0.0.1 --lport 4444 -t python

# Bash with base64 encoding
voidsec-proxy shell --lhost 10.0.0.1 --lport 4444 -t bash -e base64

# PowerShell reverse shell
voidsec-proxy shell --lhost 10.0.0.1 --lport 4444 -t powershell

# Full file metadata
voidsec-proxy forensic -f suspicious.exe

# Entropy analysis
voidsec-proxy forensic --entropy unknown_file

# Extract strings
voidsec-proxy forensic --strings binary.bin

# Hexdump
voidsec-proxy forensic --hexdump file.bin

# Compare two files
voidsec-proxy forensic --compare file1.txt --file2 file2.txt

# Spoof MAC address
voidsec-proxy anon --spoof-mac eth0

# Set random hostname
voidsec-proxy anon --hostname

# Start TOR proxy
voidsec-proxy anon --tor --start --port 9050

# Clear system tracks
voidsec-proxy anon --clear

# Full anonymization
voidsec-proxy anon --interface eth0

# List installed plugins
voidsec-proxy plugin list

# Create example plugin
voidsec-proxy plugin create -n myplugin

# Execute a plugin
voidsec-proxy plugin execute -n myplugin

# Show all config
voidsec-proxy config show

# Set a value
voidsec-proxy config set -k scanner.threads 200

# Get a value
voidsec-proxy config get -k listen

# Reset to defaults
voidsec-proxy config reset

# One proxy per line
# Format: host:port

10.0.0.1:1080
proxy.example.com:9050

# With authentication: user:pass:host:port

admin:secret:192.168.1.5:9050

PLUGIN_NAME = "myplugin"
PLUGIN_DESC = "My custom plugin"
PLUGIN_VERSION = "1.0"

def run(*args, **kwargs):
    print("Hello from my plugin!")
    return "Success"

voidsec-proxy plugin execute -n myplugin