README.md

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:

   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:

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

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
• Copyright 2025

License

This project is licensed under the MIT License. See the LICENSE file for details.