A Netsh Command Automation Script for Wi-Fi management
Project description
NCAS (Netsh Command Automation Script)
NCAS is a comprehensive Python tool designed to manage, retrieve, and share saved Wi-Fi profiles on Windows. It acts as a powerful wrapper around the native netsh command, offering both a CLI (Command Line Interface) and a user-friendly interactive menu.
🚀 Features
- Password Retrieval: Instantly view clear-text passwords for any Wi-Fi network previously connected to the computer.
- Profile Export: Back up your Wi-Fi configurations in multiple formats:
.xml(Native Windows format, used for importing).txt.csv.json
- Profile Import: Restore Wi-Fi profiles from XML files individually or in bulk.
- QR Code Generator: Generate QR codes to share Wi-Fi access easily with mobile devices.
- Signal Monitoring: Real-time visualization of Wi-Fi signal strength.
- Profile Management: Delete saved Wi-Fi profiles from the system.
- Diagnostics: Generate detailed WLAN system reports.
📥 Installation
Option 1: Standalone Executable (No Python required)
Download the latest executable from the GitHub Releases page.
Option 2: Pip install
If you have Python installed:
pip install ncas
Option 3: Run from Source
If you prefer to run the script in portable mode using Python:
git clone https://github.com/sub-limal/ncas.git
cd ncas-master
pip install -r requirements.txt
Usage
You can use NCAS via the interactive menu or directly with command-line arguments.
Interactive Mode
Simply run the script without arguments to enter the menu:
ncas
Command Line Arguments
| Argument | Description |
|---|---|
-a, --all |
Display all saved Wi-Fi profiles along with their passwords. |
--ssid [SSID] |
Display the password for a specific Wi-Fi SSID. |
-s [SSID], --search [SSID] |
Search and display all Wi-Fi profiles (and passwords) containing this keyword in their SSID. |
--si, --simple-interface |
Use a simplified version of the interactive interface. |
-e [SSID], --export [SSID] |
Export a specific profile (or all if no SSID provided) in XML. |
-i [FILE], --import [FILE] |
Import a specific profile (or all if no file provided) in XML. |
-d [SSID], --delete [SSID] |
Delete a specific Wi-Fi profile (or all if no SSID provided). |
--qr [SSID] |
Display a QR code in the terminal for the selected Wi-Fi. |
--qr-save [SSID] |
Display and save QR to SVG file. |
--et, --export-to |
Export all profiles to a format (txt, csv, or json). |
-l, --list-ssid |
List all saved SSIDs (names only, no passwords). |
-r, --remove |
Remove the content of the output directory. |
-b, --banner |
Display the NCA S banner and run the script. |
-c, --continue |
Execute the provided arguments, then enter interactive mode. |
-t, --table |
Display saved Wi-Fi profiles and passwords in table format. |
--li, --list-interfaces |
List all wireless network interfaces. |
--nc, --no-color |
Disable colored output in the terminal. |
--no-clear |
Disable console clearing between inputs in interactive mode. |
--wr, --wlanreport |
Generate a network report. |
--intensity |
Display the Wi-Fi signal strength. |
Example:
# Print all the SSIDs along with their passwords
ncas -a
# Get the password for "MyHomeWifi"
ncas --ssid "MyHomeWifi"
# Generate a QR Code for "OtherNetwork"
ncas --qr "OtherNetwork"
# Export all Wi-Fi profiles to a txt file
ncas --export-to txt
# Search for all SSIDs matching a keyword and display their passwords.
ncas -s "box"
✅ Compatibility
Tested and fully functional on:
- Windows 10
- Windows 11
🤝 Credits
- Exe Compilation: Built using auto-py-to-exe.
- Special Thanks: To Aishomeur for the signal intensity feature idea.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ncas-1.2.0.tar.gz.
File metadata
- Download URL: ncas-1.2.0.tar.gz
- Upload date:
- Size: 9.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4bf6bb4c4daba3aa6fc9249b7a952d44fcc9f5875e70e91753f13fa908a22e5
|
|
| MD5 |
a5572761963808dada3896e2e6ab0f51
|
|
| BLAKE2b-256 |
c47899fb9500bb6758160e6df67dbc42dc272a0db1e2726eefe4c4ace0d93c13
|
File details
Details for the file ncas-1.2.0-py3-none-any.whl.
File metadata
- Download URL: ncas-1.2.0-py3-none-any.whl
- Upload date:
- Size: 10.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
27cb4f4d799872020a2326e0a1fa26bf779a3713c1ac65ecd75cf44957d8ff71
|
|
| MD5 |
be13d8879592fac05e9b3da89ca39e0f
|
|
| BLAKE2b-256 |
9e301ca92e928511014d110a7a023f8c51337f0820e6199d006dd275a58c2417
|