Diagnostics · safe
--version
Show version information.
Loading WIPWN
Skip to contentTelegram channel@anbuSoft
argument reference
Every flag. Clear intent.
Browse each WIPWN argument and what it does. Full runnable command combinations live on the Examples page.
79 of 79 arguments
Output · safe
--debug
Show debug output and tracebacks.
Diagnostics · safe
--doctor
Run environment diagnostics.
Diagnostics · safe
--interfaces
Show detected interfaces.
Diagnostics · safe
--dependencies
Check dependencies.
Setup · lab
--fixroot
Fix root permissions.
Diagnostics · safe
--wps-info
Show WPS tool availability info.
Diagnostics · safe
--pixiewps-info
Show Pixiewps compatibility info.
Output · safe
--json
Emit JSON output for diagnostics.
Setup · lab
--install
Install the bundled pixiewps-extend component.
- value
- {pixiewps-extend}
- default
- pixiewps-extend
Setup · lab
--install-pixiewps
Install Pixiewps-Extend from source (Termux).
Setup · lab
--update-pixiewps
Update existing Pixiewps-Extend source and rebuild.
Setup · lab
--uninstall-pixiewps
Uninstall WIPWN-managed Pixiewps-Extend.
Setup · safe
--check-pixiewps
Run system check for Pixiewps-Extend on Termux.
Setup · lab
--force
Force reinstallation/overwrite.
Setup · safe
--dry-run
Dry run the installation without modifying system.
Setup · lab
--optimize
Enable -O3 compilation optimization.
Utilities · safe
--ssid
SSID for Wi-Fi QR generation.
- value
- SSID
Utilities · safe
--password
Password for Wi-Fi QR generation.
- value
- PASSWORD
Utilities · safe
-qr, --qr
Show a Wi-Fi QR payload for Android/Termux-assisted connection.
Required · safe
-i, --interface
Name of the interface to use.
- value
- INTERFACE
Required · lab
-b, --bssid
BSSID of the target AP.
- value
- AA:BB:CC:DD:EE:FF
Required · lab
-p, --pin
Use the specified pin (4/8 digit pin or blank for Null Pin attack).
- value
- PIN
Required · lab
--loop
Run in a loop.
Required · lab
--audit
Run advanced authorized Wi-Fi access-security audit.
Required · lab
--password-file
File containing password for authorized credential validation.
- value
- FILE
Required · lab
--pcap
PCAP file for defensive handshake analysis.
- value
- FILE.pcap
WPS Assessment · lab
-K, -k, --pixie-dust
Run Pixie Dust attack.
WPS Assessment · lab
-F, -f, --pixie-force
Run Pixiewps with --force option (bruteforce full range).
WPS Assessment · lab
--pbc, --push-button-connect
Run WPS push button connection.
Credential Audit · lab
-ob, --online-bruteforce
Run online bruteforce attack.
Credential Audit · lab
-da, --dictionary-attack
Run dictionary-based password attack.
Timing · lab
-d, --delay
Set the delay between pin attempts.
- value
- SECONDS
- default
- 0
Timing · lab
-l, --lock-delay
Wait time after AP locks WPS. Increase if needed.
- value
- SECONDS
- default
- 60
Timing · lab
-t, --timeout
Receive timeout for WPS responses.
- value
- SECONDS
- default
- 10
Timing · lab
-T, --m57-timeout
M5/M7 timeout. Fine-tune for timing attacks.
- value
- SECONDS
- default
- 0.40
Timing · lab
-r, --recurring-delay
Sleep Y seconds every X attempts (format: "10:5"). Evade detection.
- value
- X:Y
Timing · lab
-x, --fail-wait
Sleep after 10 unexpected failures.
- value
- SECONDS
- default
- 0
Credential Audit · lab
-B, --bruteforce
Run online bruteforce attack.
Safety Controls · lab
-g, --max-attempts
Maximum PIN attempts before giving up (default: unlimited).
- value
- NUM
- default
- 0
Safety Controls · lab
--pin-limit
Limit PIN bruteforce patterns to test.
- value
- NUM
- default
- 10000
Credential Audit · lab
--bruteforce-threads
Threads for bruteforce. More = faster but uses more resources.
- value
- NUM
- default
- 4
Safety Controls · lab
-L, --ignore-locks
Ignore AP lock announcements and keep attacking (risky).
Evasion · lab
-M, --mac-changer
Change MAC address for each PIN attempt - evade per-MAC rate limiting.
Credential Audit · lab
--wordlist
Custom wordlist for dictionary attacks. Default: ~/.Wipwn/wordlists/common.txt
- value
- /path/to/wordlist.txt
Credential Audit · lab
--dict-threads
Parallel threads for dictionary testing.
- value
- NUM
- default
- 4
Reconnaissance · lab
--advanced-recon
Advanced network fingerprinting - extract vendor/chipset/beacon info.
Reconnaissance · lab
--detect-weak-algo
Detect routers using weak WPS algorithms - priority targets.
Reconnaissance · lab
--signal-analysis
Analyze signal strength patterns - detect AP type from transmission power.
Reconnaissance · lab
--detect-rate-limit
Test if target implements rate limiting on failed attempts.
Vulnerability Review · lab
--check-vuln
Check target against known vulnerability list.
Evasion · lab
--bypass-rate-limit
Apply rate-limit bypass (MAC spoofing, channel hopping, timing).
Evasion · lab
--spoof-mac
Spoof random MAC each attempt - advanced evasion.
Evasion · lab
--custom-mac
Use specific custom MAC address for spoofing.
- value
- AA:BB:CC:DD:EE:FF
Evasion · lab
--channel-hop
Hop between WiFi channels during attack - evade detection.
Sessions · safe
-s, --session
Save/resume session with this ID. Pick up where you left off.
- value
- SESSION_ID
Sessions · safe
--resume-session
Resume specific previous session from ~/.Wipwn/sessions/.
- value
- SESSION_ID
Sessions · safe
--list-sessions
List all saved sessions with progress.
Sessions · safe
--session-dir
Custom directory for session files.
- value
- /path/to/sessions/
- default
- ~/.Wipwn/sessions/
Reporting · safe
-w, --write
Write cracked credentials to file on success.
Vulnerability Review · safe
--auto-vuln-list
Auto-add successfully cracked APs to vulnerability list (vulnwsc.txt).
Vulnerability Review · safe
--vuln-list
Vulnerability list file.
- value
- /path/to/vulnwsc.txt
- default
- ./vulnwsc.txt
Reporting · safe
--html-report
Generate HTML penetration test report with findings.
Reporting · safe
--detailed-report
Include detailed metrics in reports.
Reporting · safe
--report-format
Report output format.
- value
- {txt,csv,json}
- default
- txt
- choices
- txt / csv / json
Reporting · safe
--report-dir
Directory to save reports.
- value
- /path/to/reports/
- default
- reports
Reporting · safe
--json-output
Save results as JSON file.
- value
- FILE.json
Reporting · safe
--csv-output
Save results as CSV file.
- value
- FILE.csv
Reporting · safe
--log-file
Log all activity and events to file.
- value
- FILE.log
Advanced · lab
--pin-algo
PIN generation algorithm: default (recommended), pin_generation, or mac_based.
- value
- ALGO
- default
- default
- choices
- default / pin_generation / mac_based
Advanced · safe
-X, --show-pixie-cmd
Always display pixiewps command before execution (debugging).
Platform · lab
--mtk-wifi
Control MediaTek WiFi driver on Android devices.
Platform · lab
--handle-rfkill
Auto-handle WiFi radio enable/disable (RF-Kill).
Platform · lab
--use-nm
Use NetworkManager for WiFi control instead of wpa_supplicant.
Platform · lab
--iface-down
Bring down WiFi interface when finished.
Safety Controls · safe
--dts, --dont-touch-settings
Do not modify system WiFi settings (useful for Android/Termux).
Output · safe
-v, --verbose
Verbose output - show detailed debug information.
Output · safe
--no-colors
Disable colored terminal output (for logs/pipes).
Output · safe
--reverse-scan
Reverse network list order (for small terminal displays).