https://github.com/basemax/wifi-scanner
Wi-Fi Scanner is a cross-platform Python tool for scanning and displaying available Wi-Fi networks. It supports Windows, Linux, and macOS platforms and provides detailed information such as SSID, signal strength, authentication type, encryption type, channel, and band.
https://github.com/basemax/wifi-scanner
py python python-wifi scan-wifi wifi wifi-manager wifi-network wifi-password wifi-python wifi-scan wifi-scanner wifi-scanning
Last synced: 7 months ago
JSON representation
Wi-Fi Scanner is a cross-platform Python tool for scanning and displaying available Wi-Fi networks. It supports Windows, Linux, and macOS platforms and provides detailed information such as SSID, signal strength, authentication type, encryption type, channel, and band.
- Host: GitHub
- URL: https://github.com/basemax/wifi-scanner
- Owner: BaseMax
- License: mit
- Created: 2025-01-10T22:36:46.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-01-17T12:30:58.000Z (9 months ago)
- Last Synced: 2025-01-20T19:40:09.036Z (9 months ago)
- Topics: py, python, python-wifi, scan-wifi, wifi, wifi-manager, wifi-network, wifi-password, wifi-python, wifi-scan, wifi-scanner, wifi-scanning
- Language: Python
- Homepage:
- Size: 12.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wi-Fi Scanner
**Wi-Fi Scanner** is a cross-platform Python tool for scanning and displaying available Wi-Fi networks. It supports Windows, Linux, and macOS platforms and provides detailed information such as SSID, signal strength, authentication type, encryption type, channel, and band (if available).
## Features
- Scans and displays available Wi-Fi networks.
- Provides detailed network information (SSID, signal strength, authentication, encryption, channel, and band).
- Supports Windows, Linux, and macOS platforms.
- Customizable timeout and retry settings.
## Prerequisites
### Windows
1. Ensure Wi-Fi is enabled on your system.
2. **Required Tool**: `netsh` (pre-installed on Windows).
### Linux
1. Ensure Wi-Fi is enabled on your system.
2. **Required Tool**: `nmcli` (NetworkManager CLI).
### macOS
1. Ensure Wi-Fi is enabled on your system.
2. **Required Tool**: `airport` (built into macOS).
## Installation
1. Clone this repository:
```bash
git clone https://github.com/BaseMax/wifi-scanner.git
cd wifi-scanner
```
2. Ensure Python 3.6+ is installed.
## Usage
Run the script using Python:
```bash
python wifi_scanner.py [-t TIMEOUT] [-r RETRIES]
```
### Options
- `-t, --timeout`: Timeout duration between scans in seconds (default: 3).
- `-r, --retries`: Number of retries for scanning (default: 2).
### Example
```bash
python wifi_scanner.py -t 5 -r 3
```
This will scan Wi-Fi networks 3 times with a 5-second delay between each scan.
## Output Example
The program displays information about available Wi-Fi networks:
```
Scan attempt 1/3
Available Wi-Fi Networks:
SSID: MyWiFi
Signal Strength: 80%
Authentication: WPA2-Personal
Encryption: AES
Channel: 11
Band: 2.4 GHz
SSID: GuestWiFi
Signal Strength: 60%
Authentication: Open
Encryption: None
Channel: None
Band: None
```
## Notes
1. On Linux, `nmcli` is required.
2. On macOS, `airport` must be accessible.
3. Ensure proper permissions to execute commands on your platform.
## Author
**Max Base**
- GitHub: [BaseMax](https://github.com/BaseMax)
- Copyright 2025
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.