Skip to main content

Cross-platform CLI to dump saved WiFi credentials from Linux, Windows, and macOS

Project description

๐Ÿ“ก wifi-passview

Cross-platform CLI to dump all saved WiFi credentials in one command โ€” Linux, Windows, and macOS.

CI PyPI Python License: MIT


Features

  • ๐Ÿง Linux โ€” reads NetworkManager, wpa_supplicant, and iwd configs
  • ๐ŸชŸ Windows โ€” uses netsh wlan to extract all profiles and passwords
  • ๐ŸŽ macOS โ€” queries Keychain via security find-generic-password
  • ๐Ÿ“Š Multiple output formats โ€” terminal (Rich), JSON, CSV
  • ๐Ÿ”’ Redact mode โ€” partially mask passwords in output (my***23)
  • ๐Ÿ” Search โ€” filter profiles by SSID name

Installation

pip install wifi-passview

Or from source:

git clone https://github.com/ExploitCraft/wifi-passview
cd wifi-passview
pip install -e .

Linux note: Reading NetworkManager configs in /etc/NetworkManager/system-connections/ requires root. Run with sudo for full results.


Quick Start

# Dump all saved WiFi profiles
wifi-passview dump

# Redact passwords in output (safe for screenshots)
wifi-passview dump --redact

# Hide passwords entirely
wifi-passview dump --no-password

# Export to JSON
wifi-passview dump --format json --output wifi.json

# Export to CSV
wifi-passview dump --format csv --output wifi.csv

# Search for a specific network
wifi-passview search "HomeNetwork"

Example Output

โ•ญโ”€ wifi-passview โ€” saved WiFi credential dumper โ”€โ•ฎ

SSID                  PASSWORD           AUTH       BAND    AUTO
CoffeeShopWifi        latteplease        WPA-PSK    โ€”       yes
HomeNetwork           (none / open)      โ€”          2.4GHz  yes
OfficeWifi5G          Su93r$ecret!       WPA2-PSK   5GHz    yes
GuestNetwork          abc123             WPA-PSK    โ€”       no

โ•ญโ”€ Summary โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
  Platform        linux
  Total profiles  4
  With password   3
  Without pass    1
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

Platform Notes

Linux

Reads from (in order):

  1. /etc/NetworkManager/system-connections/ โ€” requires sudo
  2. /etc/wpa_supplicant/wpa_supplicant.conf
  3. /var/lib/iwd/*.psk
  4. nmcli fallback (SSID list only, no passwords)

Windows

Uses netsh wlan show profiles + netsh wlan show profile name=X key=clear. No admin required for saved profiles in the current user context.

macOS

Uses networksetup -listpreferredwirelessnetworks + security find-generic-password. May prompt for Keychain access on first run.


CLI Reference

Usage: wifi-passview [OPTIONS] COMMAND [ARGS]...

Commands:
  dump    Dump all saved WiFi profiles and passwords
  search  Search saved profiles by SSID name

Options for dump:
  --format     terminal | json | csv   (default: terminal)
  --output     Write output to file
  --redact     Partially mask passwords
  --no-password  Hide passwords entirely
  --ssid       Filter to a specific SSID (partial match)

Part of the LeakHound Ecosystem

wifi-passview is part of LeakHound โ€” a unified secret hunting toolkit.

Tool Description
envleaks Codebase & git history secret scanner
gitdork Google/Shodan dork generator
wifi-passview Cross-platform WiFi credential dumper (this repo)
leakhound Unified CLI wrapping all three

Disclaimer

This tool is intended for use on your own systems only. Only dump credentials from devices you own or have explicit permission to audit. The author is not responsible for misuse.


License

MIT ยฉ ExploitCraft

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wifi_passview-0.1.0.tar.gz (11.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wifi_passview-0.1.0-py3-none-any.whl (13.8 kB view details)

Uploaded Python 3

File details

Details for the file wifi_passview-0.1.0.tar.gz.

File metadata

  • Download URL: wifi_passview-0.1.0.tar.gz
  • Upload date:
  • Size: 11.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for wifi_passview-0.1.0.tar.gz
Algorithm Hash digest
SHA256 eb31a17e95a89e85aea0e6497f96142e6713443643440c9e8a775ecbb9ea8fa5
MD5 b3fb125d31286be18a14b08775abf432
BLAKE2b-256 9a283e7c5170f149d7f2b22f66e5dbbe3d06afaa9c497082526f2c2e3fa22c0c

See more details on using hashes here.

File details

Details for the file wifi_passview-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: wifi_passview-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 13.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for wifi_passview-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 23d9b782db7b517481b06c2b572ed86a73232dfb91b284ab014f3143b115dcf4
MD5 3e54b803f885485a8fc3212b5bbfed4d
BLAKE2b-256 b71ebf0d9ba2b14fc11b0000ef58eedcf44729ef28f5fea5442c02772e6c2ebd

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page