Skip to content

gryszzz/IP_scanner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

IP Scanner

IP Scanner is a Windows batch-based network utility for quickly scanning a local IP range and writing the results to a report file.

It is designed for simple LAN troubleshooting and visibility, not stealth scanning or deep network enumeration.

Demo

IP Scanner demo preview

What It Does

For each IP in the range you provide, the script:

  • sends a ping request
  • attempts hostname resolution
  • checks the local ARP table for a MAC address
  • appends a local netstat listening snapshot
  • appends local network interface details from ipconfig
  • runs tracert
  • writes everything into ip_scan_results.txt

Repo Contents

  • ip_scanner.bat - main scanner workflow
  • ascii_art.py - startup banner displayed before the scan begins
  • ipscannerv1.exe - packaged executable build

Platform Requirements

  • Windows
  • Command Prompt
  • Python 3.x available in PATH

Python is required because the batch script calls ascii_art.py before starting the scan.

Quick Start

git clone https://github.com/gryszzz/IP_scanner.git
cd IP_scanner

Run the scanner:

ip_scanner.bat

You will be prompted for:

  • the first three octets of the network, such as 10.0.0
  • the starting host octet
  • the ending host octet

Example input:

Network prefix: 10.0.0
Start host: 1
End host: 25

Output

Results are written to:

ip_scan_results.txt

The report includes the scan timestamp and the collected output for each target address.

Important Behavior Notes

  • This project is best suited for small internal network checks.
  • The netstat -an | findstr "LISTENING" output reflects listening ports on the local machine running the script, not verified open ports on each remote host.
  • MAC address discovery depends on whether the target appears in the local ARP cache.
  • Hostname resolution depends on what ping -a can resolve in your environment.
  • tracert can make larger scans take noticeably longer.

Suggested Use Cases

  • quick LAN diagnostics
  • checking host reachability across a subnet slice
  • generating a rough network activity report for troubleshooting
  • collecting basic command-line evidence before deeper analysis

License

No license file is currently included in this repository. Add one if you want to make reuse terms explicit.

About

The code snippet is a batch script that scans a range of IP addresses by pinging each one, retrieving the hostname and MAC address, listing open ports, and performing a traceroute. Results are saved to an output file, providing a summary of the network status for each IP address.

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

Packages

 
 
 

Contributors