Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Netspector

A lightweight network inspection tool built from scratch for learning and experimentation.


📖 Overview

Netspector is a simple command-line tool for basic network reconnaissance.
It focuses on core networking concepts while staying fast, minimal, and dependency-free.

Use it for:

  • Learning networking fundamentals
  • Understanding how scanners work
  • Practicing Python
  • Building your cybersecurity portfolio

🚀 Features

  • TCP port scanning (single / range)
  • Basic UDP scanning
  • Host reachability (ping)
  • RTT (latency) measurement
  • Subnet enumeration (CIDR)
  • Private IP detection
  • Local listening ports discovery
  • Domain resolution
  • Interactive CLI
  • Colored output
  • No external dependencies

🗂️ Project Structure

image

⚙️ Installation

git clone https://github.com/Red-Warrior-hkg/Netspector.git
cd Netspector

Requirements

  • Python 3.6+
  • No additional packages required

🧑‍💻 Usage

Interactive Mode

python main.py

Commands:

  • help → show commands
  • exit → quit

One-shot Mode

python main.py <command> [options]

📚 Cheat Sheet

image

⚙️ How It Works

  • TCP Scan → Full 3-way handshake
  • UDP Scan → Packet-based detection
  • Ping → Uses system commands
  • RTT → Measures connection time
  • Subnet → Expands CIDR ranges
  • Listening Ports → Uses system tools

⚠️ Limitations

  • Uses full TCP connect (no SYN scan)
  • UDP scanning may be unreliable
  • No OS fingerprinting
  • Not intended to replace advanced tools

🔮 Future Improvements

  • Web interface + HTML cheat sheet
  • Command explanations & quick reference
  • Visual scan output
  • Export results (JSON / TXT)

⭐ Support

If you like this project, consider starring it.

About

Netspector is a lightweight network scanner built from scratch to explore port scanning, host discovery, and subnet analysis. It’s designed for learning networking concepts and practicing Python in real-world scenarios.

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages