mac-wifi-password

A command-line tool to retrieve Wi-Fi passwords stored in the macOS Keychain.

Description

mac-wifi-password allows you to easily fetch saved Wi-Fi passwords from your macOS Keychain. It can automatically detect the currently connected Wi-Fi network or accept a specific SSID as an argument.

Installation

From Crates.io

Once published, you can install it using Cargo:

cargo install mac-wifi-password

From Source

Clone the repository and build:

git clone https://github.com/alipiry/mac-wifi-password.git
cd mac-wifi-password
cargo build --release

Usage

mac-wifi-password [OPTIONS] [SSID]

Options

• SSID: The Wi-Fi network name (SSID). If omitted, the tool will attempt to detect the currently connected network.
• -d, --debug: Show debug information (commands run and stderr).
• -c, --copy: Copy the resulting password to the clipboard using pbcopy.

Examples

Get the password for the currently connected Wi-Fi network:

mac-wifi-password

Get the password for a specific network:

mac-wifi-password "MyHomeNetwork"

Copy the password to clipboard:

mac-wifi-password -c

Show debug information:

mac-wifi-password -d "MyHomeNetwork"

Requirements

• macOS (uses system security, airport, and networksetup commands)
• Rust (for building from source)

Security Note

This tool accesses the macOS Keychain, which may prompt for authentication. Ensure you have the necessary permissions to read Keychain entries.

License

MIT License