Prompt user to select a WPS PIN from the suggested list. BUG FIX: always returns a string, not a dict.

Prompt user for a location label (non-blocking, empty is fine).

Execute the confidence-ordered automated WPS attack pipeline. Stages (in order, abort-on-success): 1. Pixie Dust (-K) 2. SSID-hint PI

Try to auto-detect a suitable wireless interface. Tries five methods in order (most reliable first): 1. iw dev -- standard Linux

Print the FireSoft-style OS info line shown once at startup.

Replace every character with '*'.

Replace the first half of the string with '*'.

Return the wiphy (phy0, phy1 ...) for the given interface, or None.

Return a mapping of {pid: cmdline} for processes that hold netlink sockets. These processes (e.g. NetworkManager, wpa_supplicant instances) can

Kill processes that may interfere with wpa_supplicant. Strategy (in order): 1. systemctl stop -- cleanly stops NetworkManager / iwd servic

Decode, verify, and return the coloured banner string.

Load cracked networks from legacy stored.txt/csv format.

Return deduplicated, confidence-ordered WPS PIN candidates.

Run and display a full system health check panel.

Fallback plain-text report (no ANSI colors).

Attempt to unblock wifi via /sys/class/rfkill sysfs entries.

Comprehensive system readiness check for WPS attacks. Returns a dict with keys: root, tools, interface, files, nm_running, overall. All check

Run full analysis and print the formatted vulnerability report.

Load static PINs from pins.csv for the given MAC prefix. The file is read and parsed only once per unique path; subsequent calls use

Load static PINs from pins.csv for the given MAC prefix.

Check if WPS is enabled on a specific AP.

Unblock WiFi via rfkill tool (with sysfs fallback). Retries once after 1 second if the first attempt fails so that a briefly busy RF-

Get all suggested WPS pin's for single MAC

Get all suggested WPS pin's for single MAC as list. CSV-backed (ALGO_STATIC_DB) entries are expanded directly; computed algos

Get channel and frequency info for a BSSID.

Return True if any WiFi RF-Kill switch is software-blocked.

Parsing iw scan results

Load saved attack session.

Write a .OSP_Complete log file for the cracked AP. Returns the path to the written file, or None on failure.

Print credentials with FireSoft-style masking (FS_HIDE_* settings).

Persist a cracked AP to NetworkManager (Linux) or Android WiFi (Android). Linux : nmcli connection add type wifi con-name <essid> ssid <essi

Append cracked credentials to the persistent crack-data store file. Always writes regardless of --write flag. Errors are reported to stderr

Saves the provided username, pin, password, and timestamp to the specified file. :param username: The username to save. :param pin: The p

Scan and print results without prompting for a target.

Return an existing .OSP_Complete filename for this BSSID, or None. Accepts both raw (AA:BB:CC:DD:EE:FF) and pre-normalised (uppercase)

Sends command to wpa_supplicant and returns the reply

Sends command to wpa_supplicant

Configure and return the module-wide 'farhan_shot' logger. Creates two RotatingFileHandlers in *log_dir* (defaults to the directory containin

Prompt the user to run termux-setup-storage if /sdcard is not accessible.