voidsec-proxy

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

v3.0.0 | 18 modules | 50+ commands | zero dependencies

Not another script kiddie tool. This one actually does something.

Installation
Quick Start
Commands Reference
- proxy — SOCKS5 chain rotation
- scan — port scanner
- dns — DNS toolkit
- crack — hash cracking
- password — password generator
- mutate — wordlist mutator
- recon — network reconnaissance
- web — web fingerprinting
- exfil — covert channels & encoding
- encrypt — AES-GCM file encryption
- shred — secure file deletion
- stego — steganography
- shell — reverse shell generator
- forensic — file analysis
- anon — anonymization
- plugin — plugin management
- config — configuration
Proxies File Format
Plugin API
License

Installation

# 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]"

Requirements: Python 3.8+ | Zero mandatory dependencies

Quick Start

# 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

Commands Reference

proxy

SOCKS5 proxy chain with automatic rotation.

# 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

Multi-threaded TCP port scanner with banner grabbing.

# 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

dns

DNS resolution, reverse lookups, and subdomain enumeration.

# 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

Hash cracking with wordlist support.

# 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

password

Password generator with strength auditing.

# 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

mutate

Wordlist mutation engine.

# 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

recon

Full network reconnaissance.

# 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

web

Web application fingerprinting and directory brute-force.

# 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

exfil

Covert channels and data encoding.

# 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

AES-GCM file encryption.

# 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

Flag	Description
`-i, --input`	Input file (required)
`-o, --output`	Output file (required)

shred

Secure file deletion with multiple passes.

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

Flag	Description	Default
`-f, --file`	File to shred (required)	—
`-n, --passes`	Number of overwrite passes	`3`

stego

PNG steganography — hide and extract data in images.

# 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

Flag	Description
`-i, --image`	PNG image file
`-f, --secret`	Secret file to hide
`-o, --output`

shell

Reverse shell generator with payload encoding.

# 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

forensic

File analysis and forensics.

# 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

anon

Anonymization tools.

# 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

plugin

Plugin management.

# 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

config

Configuration management.

# 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

Flag	Description
`action`

Proxies File Format

# 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 API

Create a Python file in ~/.voidsec/plugins/:

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

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

Then run:

voidsec-proxy plugin execute -n myplugin

Windows Arsenal

Looking for Windows tools? We've got a separate repo with 8 PowerShell GUI tools:

→ VoidSec Windows Arsenal

License

MIT License — see LICENSE for details.

`-f, --file`	Proxies file (required)	—
`-l, --listen`	Listen address	`127.0.0.1`
`-p, --port`	Listen port	`9050`
`-s, --shuffle`	Shuffle proxy order	`false`

`-t, --target`	Target host (required)	—
`-p, --ports`	Comma-separated ports	common ports
`-r, --port-range`	Port range (e.g., `1-1000`)	—
`-o, --output`	Output file	stdout
`-f, --format`	Output format (`text`, `json`, `csv`)	`text`

`domain`	Target domain (required)	—
`-t, --type`	Record type (repeatable)	`A`
`-r, --reverse`	Reverse DNS lookup	`false`
`-e, --enumerate`	Subdomain enumeration	`false`
`-w, --wordlist`	Wordlist for enumeration	—

`--hash`	Hash to crack	—
`--hash-text`	Text to hash	—
`--hash-file`	File to hash	—
`-t, --type`	Hash type (`md5`, `sha1`, `sha256`, `sha512`)	`md5`
`-w, --wordlist`	Wordlist for cracking	—

`-l, --length`	Password length / word count	`16`
`-c, --count`	Number of passwords to generate	`5`
`-a, --audit`	Audit password strength	—
`--passphrase`	Generate passphrase instead	`false`
`--separator`	Passphrase word separator	`-`
`--no-upper`	Exclude uppercase	`false`
`--no-lower`	Exclude lowercase	`false`
`--no-digits`	Exclude digits	`false`
`--no-symbols`	Exclude symbols	`false`

`-w, --wordlist`	Input wordlist (required)	—
`-o, --output`	Output file (required)	—
`-m, --mutations`	Comma-separated: `leet`, `upper`, `append_num`, `prepend_num`, `dups`, `reverse`, `append_sym`	all

`-t, --target`	Target host for full recon
`--whois`	WHOIS lookup
`--geo`	IP geolocation
`--asn`	ASN lookup
`--traceroute`	Traceroute to target

`-u, --url`	Target URL
`--headers`	Fetch and analyze headers
`--fingerprint`	Technology fingerprint
`--dirbust`	Directory brute-force
`-w, --wordlist`	Wordlist for brute-force

`--encode`	Text to encode
`--decode`	Text to decode
`-m, --method`	`base32`, `base64`, `hex`, `morse`, `binary`, `rot13`, `caesar`, `dns`
`-s, --shift`	Caesar cipher shift
`--vigenere`	Vigenere cipher text
`--key`	Cipher key
`--decrypt`	Decrypt instead of encrypt

`--lhost`	Listener host (required)	—
`--lport`	Listener port (required)	—
`-t, --type`	Shell type: `python`, `bash`, `perl`, `php`, `ruby`, `java`, `powershell`, `netcat`, `socat`, `lua`, `c`	`python`
`-e, --encoding`	Payload encoding: `base64`, `hex`, `url`, `double_base64`, `base64_bash`, `base64_python`, `rot13`	—

`-f, --file`	Target file
`--entropy`	Calculate entropy
`--compare`	Compare with `--file2`
`--strings`	Extract printable strings
`--hexdump`	Hexdump first N bytes
`--min-length`	Minimum string length

`--spoof-mac`	Interface to spoof MAC on
`--new-mac`	Specific MAC address (random if omitted)
`--hostname`	Set random hostname
`--tor`	TOR operations
`--start`	Start TOR
`--stop`	Stop TOR
`--port`	TOR SOCKS port
`--clear`	Clear bash/zsh history, logs, /tmp
`--random-hostname`	Print random hostname
`--interface`	Network interface for full anon

VoidCrypt	AES-256-GCM file encryption
GhostProcess	Process viewer & manipulator
NetPhantom	Network reconnaissance
RegGhost	Registry analyzer
StealthLog	System track cleaner
HashVault	Password & hash toolkit
SysPhantom	System reconnaissance
AntiForensics	Evidence destruction

Most Popular

voidsec-proxy

voidsec-proxy

Table of Contents

Installation

Quick Start

Commands Reference

proxy

scan

dns

crack

password

mutate

recon

web

exfil

encrypt

shred

stego

shell

forensic

anon

plugin

config

Proxies File Format

Plugin API

Windows Arsenal

License