Basic Attacksexample_01
Scan + Pixie Dust
Scan nearby WPS networks and select one for an authorized lab test.
$ sudo python main.py -i wlan0 -K Run only within an authorized lab
command examples / 69 workflows
One step at a time
Basic AttacksSetup & DiagnosticsUtilitiesPixie DustBruteforce & DictionaryTiming ControlsReconnaissanceEvasionSessionsReportingPlatform & SystemOutputPower Combinations
Basic Attacksexample_02
Direct Pixie Dust
Run a direct test against a known lab BSSID.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K Run only within an authorized lab
Basic Attacksexample_03
Manual PIN Test
Try one specific WPS PIN in an owned test environment.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -p 12345670 Run only within an authorized lab
Basic Attacksexample_04
Push Button Connect
Use the physical WPS button on the lab router.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF --pbc Run only within an authorized lab
Basic Attacksexample_05
Loop Until Stopped
Repeat a scoped assessment continuously in a supervised lab.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --loop Run only within an authorized lab
Setup & Diagnosticsexample_06
Show Version
Print the installed WIPWN version.
$ sudo python main.py --version Run only within an authorized lab
Setup & Diagnosticsexample_07
Environment Doctor
Run full environment diagnostics with JSON output.
$ sudo python main.py --doctor --json Run only within an authorized lab
Setup & Diagnosticsexample_08
Dependency Check
Verify required binaries are installed and reachable.
$ sudo python main.py --dependencies Run only within an authorized lab
Setup & Diagnosticsexample_09
Interface + WPS Info
List interfaces and confirm local WPS tool availability.
$ sudo python main.py --interfaces --wps-info Run only within an authorized lab
Setup & Diagnosticsexample_10
Pixiewps Compatibility
Confirm Pixiewps support before any lab session.
$ sudo python main.py --pixiewps-info Run only within an authorized lab
Setup & Diagnosticsexample_11
Fix Root Permissions
Run the documented fixroot helper on a permitted lab device.
$ sudo python main.py --fixroot Run only within an authorized lab
Setup & Diagnosticsexample_12
Install Pixiewps-Extend
Install the bundled Pixiewps-Extend build, dry run first.
$ sudo python main.py --install pixiewps-extend --dry-run Run only within an authorized lab
Setup & Diagnosticsexample_13
Force Reinstall
Force rebuild an existing Pixiewps-Extend install.
$ sudo python main.py --install-pixiewps --force --optimize Run only within an authorized lab
Setup & Diagnosticsexample_14
Update Pixiewps-Extend
Rebuild an existing WIPWN-managed Pixiewps-Extend source tree.
$ sudo python main.py --update-pixiewps Run only within an authorized lab
Setup & Diagnosticsexample_15
Uninstall Pixiewps-Extend
Remove the WIPWN-managed Pixiewps-Extend component.
$ sudo python main.py --uninstall-pixiewps Run only within an authorized lab
Setup & Diagnosticsexample_16
Check Pixiewps on Termux
Run the Termux-specific Pixiewps-Extend system check.
$ sudo python main.py --check-pixiewps Run only within an authorized lab
Utilitiesexample_17
Generate a Wi-Fi QR
Create a connection payload for an authorized lab network.
$ sudo python main.py --qr --ssid lab-network --password lab-password Run only within an authorized lab
Utilitiesexample_18
Debug Mode
Show full tracebacks while diagnosing an issue.
$ sudo python main.py --doctor --debug Run only within an authorized lab
Pixie Dustexample_19
Full Range Force
Use the documented full-range option for a partially patched lab router.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -F Run only within an authorized lab
Pixie Dustexample_20
Verbose Pixie Dust
Show detailed handshake output for debugging.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -v Run only within an authorized lab
Pixie Dustexample_21
Vulnerability Check
Report vulnerability indicators before the scoped test.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --check-vuln Run only within an authorized lab
Pixie Dustexample_22
Show Pixie Command
Display the underlying pixiewps command before running it.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -X Run only within an authorized lab
Pixie Dustexample_23
JSON Save
Save a structured result for review.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -F --json-output out.json Run only within an authorized lab
Bruteforce & Dictionaryexample_24
Bounded Bruteforce
Cap PIN attempts during an approved test.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -g 500 Run only within an authorized lab
Bruteforce & Dictionaryexample_25
Delay Between Attempts
Add a delay to reduce lockout risk during an approved test.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -d 2 Run only within an authorized lab
Bruteforce & Dictionaryexample_26
PIN Pattern Limit
Limit PIN bruteforce patterns tested in a scoped session.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B --pin-limit 5000 Run only within an authorized lab
Bruteforce & Dictionaryexample_27
Threaded Bruteforce
Increase bruteforce threads on a capable lab machine.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B --bruteforce-threads 8 Run only within an authorized lab
Bruteforce & Dictionaryexample_28
Online Bruteforce
Run the dedicated online bruteforce module.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -ob Run only within an authorized lab
Bruteforce & Dictionaryexample_29
Dictionary Attack
Run a consent-based dictionary validation with a documented wordlist.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -da --wordlist ./lab-wordlist.txt Run only within an authorized lab
Bruteforce & Dictionaryexample_30
Dictionary Threads
Run parallel dictionary testing threads.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -da --wordlist ./lab-wordlist.txt --dict-threads 8 Run only within an authorized lab
Bruteforce & Dictionaryexample_31
Password File Validation
Validate a single documented credential against an owned target.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF --password-file ./password.txt Run only within an authorized lab
Bruteforce & Dictionaryexample_32
Write Cracked Credentials
Persist successful credentials to a local file.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -w Run only within an authorized lab
Timing Controlsexample_33
Lock Wait
Wait after a WPS lock response instead of hammering the device.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -l 120 Run only within an authorized lab
Timing Controlsexample_34
Custom Receive Timeout
Extend the receive timeout for a slower lab access point.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -t 15 Run only within an authorized lab
Timing Controlsexample_35
M5/M7 Timeout Tuning
Fine-tune the M5/M7 handshake timeout for timing accuracy.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -T 0.6 Run only within an authorized lab
Timing Controlsexample_36
Recurring Delay
Sleep 5 seconds every 10 attempts to reduce load on the lab AP.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -r 10:5 Run only within an authorized lab
Timing Controlsexample_37
Fail Wait
Pause after repeated unexpected failures during a bounded test.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -x 30 Run only within an authorized lab
Timing Controlsexample_38
Ignore AP Locks
Keep testing through lock announcements only in a fully authorized lab.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -L Run only within an authorized lab
Reconnaissanceexample_39
Signal Analysis
Profile signal quality before testing.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --signal-analysis Run only within an authorized lab
Reconnaissanceexample_40
Detect Weak Algorithms
Highlight chipset and algorithm indicators for research.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF --detect-weak-algo Run only within an authorized lab
Reconnaissanceexample_41
Advanced Fingerprinting
Extract vendor and chipset details from a scoped access point.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF --advanced-recon Run only within an authorized lab
Reconnaissanceexample_42
Rate Limit Detection
Test whether a permitted target rate-limits failed attempts.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF --detect-rate-limit Run only within an authorized lab
Reconnaissanceexample_43
Full Recon Chain
Combine signal analysis, vulnerability checks, and verbose output.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --signal-analysis --check-vuln -v Run only within an authorized lab
Evasionexample_44
MAC Rotation
Rotate the local adapter identity only where explicitly permitted.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -M Run only within an authorized lab
Evasionexample_45
Spoof Random MAC
Apply advanced MAC spoofing evasion during a permitted test.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B --spoof-mac Run only within an authorized lab
Evasionexample_46
Custom MAC
Use a specific documented MAC address for a scoped lab test.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B --custom-mac AA:11:22:33:44:55 Run only within an authorized lab
Evasionexample_47
Channel Hopping
Hop channels during an authorized assessment.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B --channel-hop Run only within an authorized lab
Evasionexample_48
Rate Limit Bypass
Apply the combined rate-limit bypass toolkit in a fully permitted lab.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B --bypass-rate-limit Run only within an authorized lab
Sessionsexample_49
Start a Named Session
Save an auditable assessment session for later review.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -s classroom-lab Run only within an authorized lab
Sessionsexample_50
List Sessions
Show saved session progress.
$ sudo python main.py --list-sessions Run only within an authorized lab
Sessionsexample_51
Resume Session
Continue a previously saved lab session.
$ sudo python main.py --resume-session classroom-lab Run only within an authorized lab
Sessionsexample_52
Custom Session Directory
Store session files in a documented, non-default directory.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -s classroom-lab --session-dir ./sessions/ Run only within an authorized lab
Reportingexample_53
JSON Output
Write structured findings to JSON.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --json-output results.json Run only within an authorized lab
Reportingexample_54
CSV Output
Write findings to CSV.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --csv-output results.csv Run only within an authorized lab
Reportingexample_55
Activity Log
Keep a local activity log for review.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B --log-file activity.log Run only within an authorized lab
Reportingexample_56
Detailed HTML Report
Generate a detailed HTML report after a scoped session.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --html-report --detailed-report Run only within an authorized lab
Reportingexample_57
Report Format + Directory
Choose a report format and a documented output directory.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --report-format json --report-dir ./reports Run only within an authorized lab
Reportingexample_58
Auto Vulnerability List
Add a successfully validated lab AP to the local vulnerability list.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --auto-vuln-list --vuln-list ./vulnwsc.txt Run only within an authorized lab
Reportingexample_59
PCAP Handshake Review
Analyze a captured PCAP file for defensive handshake review.
$ sudo python main.py --pcap lab-capture.pcap --detailed-report Run only within an authorized lab
Platform & Systemexample_60
Handle rfkill
Auto-unblock a locally controlled Wi-Fi radio.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --handle-rfkill Run only within an authorized lab
Platform & Systemexample_61
MediaTek Driver
Enable documented MediaTek Wi-Fi support.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --mtk-wifi Run only within an authorized lab
Platform & Systemexample_62
Use NetworkManager
Control Wi-Fi through NetworkManager instead of wpa_supplicant.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --use-nm Run only within an authorized lab
Platform & Systemexample_63
Bring Interface Down After
Return the interface to a down state once finished.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --iface-down Run only within an authorized lab
Platform & Systemexample_64
Don't Touch Settings
Prevent WIPWN from modifying system Wi-Fi settings on Android/Termux.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --dts Run only within an authorized lab
Platform & Systemexample_65
Custom PIN Algorithm
Select a documented PIN generation algorithm for a lab audit.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --pin-algo mac_based Run only within an authorized lab
Outputexample_66
No Colors
Disable ANSI colors for log pipelines.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K --no-colors Run only within an authorized lab
Outputexample_67
Reverse Scan Order
Reverse the network list display for small terminals.
$ sudo python main.py -i wlan0 --reverse-scan Run only within an authorized lab
Power Combinationsexample_68
Single Target Maximum Effort
Bounded vulnerability check, full range, and verbose output.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -K -F -v --check-vuln Run only within an authorized lab
Power Combinationsexample_69
Documented Bruteforce Audit
A fully bounded, logged, and reported bruteforce audit.
$ sudo python main.py -i wlan0 -b AA:BB:CC:DD:EE:FF -B -g 500 -d 2 -w --html-report --log-file audit.log Run only within an authorized lab