Skip to main content

A Netsh Command Automation Script for Wi-Fi management

Project description

NCAS (Netsh Command Automation Script)

Python Platform License MIT

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.

Demo

🚀 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

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

ncas-1.2.0.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

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

ncas-1.2.0-py3-none-any.whl (10.2 kB view details)

Uploaded Python 3

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

Hashes for ncas-1.2.0.tar.gz
Algorithm Hash digest
SHA256 e4bf6bb4c4daba3aa6fc9249b7a952d44fcc9f5875e70e91753f13fa908a22e5
MD5 a5572761963808dada3896e2e6ab0f51
BLAKE2b-256 c47899fb9500bb6758160e6df67dbc42dc272a0db1e2726eefe4c4ace0d93c13

See more details on using hashes here.

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

Hashes for ncas-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 27cb4f4d799872020a2326e0a1fa26bf779a3713c1ac65ecd75cf44957d8ff71
MD5 be13d8879592fac05e9b3da89ca39e0f
BLAKE2b-256 9e301ca92e928511014d110a7a023f8c51337f0820e6199d006dd275a58c2417

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