Skip to content

NetScanner is a simple yet powerful network scanning tool built in Python using the Scapy library. This tool is designed to help network administrators, ethical hackers, and cybersecurity enthusiasts easily identify devices on a network by retrieving their IP and MAC addresses through ARP (Address Resolution Protocol) requests.

License

Notifications You must be signed in to change notification settings

anishalx/netscanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 

Repository files navigation

NetScanner

                )           (                   )    )     (     
             ( /(      *   ))\ )  (    (     ( /( ( /(     )\ )  
             )\())(  ` )  /(()/(  )\   )\    )\()))\())(  (()/(  
            ((_)\ )\  ( )(_))(_)|((_|(((_)( ((_)\((_)\ )\  /(_)) 
             _((_|(_)(_(_()|_)) )\___)\ _ )\ _((_)_((_|(_)(_))   
            | \| | __|_   _/ __((/ __(_)_\(_) \| | \| | __| _ \  
            | .` | _|  | | \__ \| (__ / _ \ | .` | .` | _||   /  
            |_|\_|___| |_| |___/ \___/_/ \_\|_|\_|_|\_|___|_|_\
  

Overview

Welcome to NetScanner, your go-to tool for effortlessly discovering devices on your local network! Built with Python and Scapy, NetScanner provides a clean and intuitive command-line interface for scanning IP addresses and retrieving essential information about connected devices.

Why Use NetScanner?

  • User-Friendly: Designed for both beginners and experienced users, making network scanning simple and efficient.
  • Versatile: Whether you’re a network administrator, security professional, or just a tech enthusiast, NetScanner meets your needs.
  • Real-Time Results: Quickly identify devices connected to your network, including their IP and MAC addresses.

Features

  • Cross-Platform Compatibility: Use NetScanner on Windows, macOS, and Linux systems.
  • Target Customization: Easily specify single IPs, ranges, or subnets to scan.
  • Detailed Output: View a comprehensive list of all detected devices in a clear format.
  • Guided Error Handling: Friendly error messages help you troubleshoot input issues.

Installation

Prerequisites

To run NetScanner, ensure you have:

  • Python 3.x installed on your machine.
  • The Scapy library. Install it via pip:
pip install scapy

Clone the Repository

  1. Open your terminal (Command Prompt on Windows, Terminal on macOS/Linux).
  2. Clone the repository:
git clone https://github.com/anishalx/netscanner.git
cd netscanner

Usage

To start scanning, run the script with your desired target IP or IP range:

python netscanner.py -t {your:IP eg.192.168.1.0/24}

Example Output

Demo

Watch the video

Need Help?

For a detailed list of options and usage instructions, simply run:

python netscanner.py -h

Operating Systems

NetScanner is compatible with:

  • Windows: Use Command Prompt or PowerShell.
  • macOS: Utilize Terminal for seamless execution.
  • Linux: Run in any terminal emulator of your choice.

Contributing

We welcome contributions from the community! If you have ideas for improvements or new features, please follow these steps:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/YourFeature).
  3. Make your changes and commit them (git commit -m 'Add some feature').
  4. Push your branch (git push origin feature/YourFeature).
  5. Open a pull request.

License

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

Acknowledgments

  • Special thanks to Scapy for powering this tool.
  • Inspired by various network scanning tools and the open-source community.

About

NetScanner is a simple yet powerful network scanning tool built in Python using the Scapy library. This tool is designed to help network administrators, ethical hackers, and cybersecurity enthusiasts easily identify devices on a network by retrieving their IP and MAC addresses through ARP (Address Resolution Protocol) requests.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages