Skip to content

xdrew87/NetSentinel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌐 NetworkPhantom - Advanced Network Analysis & IP Intelligence Tool

A comprehensive, feature-rich CLI tool for network professionals, cybersecurity specialists, and penetration testers. NetworkPhantom provides geolocation lookups, subnet analysis, network scanning, and advanced IP intelligence all in one powerful tool.

✨ Features

πŸ” IP Geolocation & Intelligence

  • IP Geolocation Lookup - Get comprehensive location data (country, city, coordinates, timezone)
  • Security Detection - Identify proxies, VPNs, data centers, and mobile connections
  • WHOIS Lookup - Retrieve ISP, organization, and AS number information
  • DNS Lookup - Resolve domain names to IP addresses
  • Reverse DNS - Find hostnames from IP addresses
  • MAC Address Lookup - Identify device vendors from MAC addresses
  • IP Reputation - Check if IP is blacklisted or suspicious

πŸ”§ Subnet & Network Analysis

  • Subnet Calculator - Calculate subnets from CIDR notation or netmask
  • Decimal Conversion - Convert between subnet masks, CIDR, binary, and hex
  • IP Range Generator - Generate all usable IPs in a CIDR block
  • Wildcard Mask Calculator - Perfect for ACL and firewall rules
  • Network Requirements - Calculate optimal subnet size based on host count
  • Subnet Breakdown - Divide large networks into smaller subnets
  • Supernet Calculation - Combine multiple subnets

πŸ“‘ Network Connectivity & Scanning

  • Ping Test - Test host reachability and response times
  • Port Scanner - Scan common ports (SSH, HTTP, HTTPS, MySQL, etc.)
  • Traceroute - Trace the network path to a destination
  • DNS Resolution - Check DNS propagation and resolution

πŸ“Š Utilities & Tools

  • Export Reports - Save analysis to JSON or CSV format
  • Batch Analysis - Analyze multiple IPs at once
  • Colorized Output - Beautiful, easy-to-read terminal UI
  • Animated Transitions - Smooth screen animations

🎨 User Interface

  • Advanced ASCII Art - Professional banner and styling
  • Color-coded Information - Easy to scan results
  • Interactive Menus - Intuitive navigation
  • Clear Screen Animations - Smooth visual feedback

πŸ“‹ Requirements

  • Python 3.7+
  • requests library
  • Internet connection (for geolocation and WHOIS lookups)

πŸš€ Installation

git clone https://github.com/xdrew87/NetSentinel.git
cd NetSentinel
pip3 install -r requirements.txt
python3 main.py

πŸ“¦ Dependencies

  • requests - HTTP library for API calls
  • Standard library: socket, subprocess, json, csv, etc.

πŸ’‘ Usage Examples

IP Geolocation Lookup

Option 1 β†’ Lookup IP & Geolocation Analysis
Enter IP: 8.8.8.8

Displays complete geolocation, ISP, security status, and more.

Subnet Calculation

Option 3 β†’ Advanced Network Tools β†’ Subnet Breakdown Calculator
Current CIDR: /16
Target CIDR: /24

Shows how to divide a /16 network into /24 subnets.

IP Range Generation

Option 4 β†’ Utility Tools β†’ IP Range Generator
IP: 192.168.1.0
CIDR: /24

Generates all usable IPs in the network (192.168.1.1 - 192.168.1.254).

Port Scanning

Option 5 β†’ Network Connectivity β†’ Port Scanner
IP: 192.168.1.1

Scans common ports and displays open services.

Export Report

Option 6 β†’ Advanced IP Intelligence β†’ Export IP Report
IP: 50.80.72.174
Format: JSON

Saves complete analysis to a timestamped JSON file.

πŸ”’ Security & Ethical Use

This tool is designed for authorized security testing and network administration only. Ensure you have permission before:

  • Scanning networks you don't own
  • Performing port scans on external systems
  • Accessing WHOIS information

Always comply with applicable laws and regulations.

πŸ“Š Main Menu Structure

NetSentinel Main Menu
β”œβ”€ 1. 🌐 Lookup IP & Geolocation Analysis
β”œβ”€ 2. πŸ”’ Convert Subnet to Decimal Representation
β”œβ”€ 3. πŸ“Š Advanced Network Tools
β”‚  β”œβ”€ Subnet Breakdown Calculator
β”‚  └─ More tools...
β”œβ”€ 4. πŸ› οΈ Utility Tools & Generators
β”‚  β”œβ”€ IP Range Generator
β”‚  β”œβ”€ Wildcard Mask Calculator
β”‚  └─ Network Requirements Calculator
β”œβ”€ 5. πŸ“‘ Network Connectivity & Scanning
β”‚  β”œβ”€ Ping Host
β”‚  β”œβ”€ Port Scanner
β”‚  β”œβ”€ DNS Lookup
β”‚  └─ Reverse DNS Lookup
β”œβ”€ 6. πŸ” Advanced IP Intelligence
β”‚  β”œβ”€ WHOIS Lookup
β”‚  β”œβ”€ MAC Address Lookup
β”‚  └─ Export IP Report
└─ 7. ❌ Exit

πŸ“ˆ Features Breakdown

Category Count Features
IP Intelligence 7 Geolocation, WHOIS, DNS, Reverse DNS, MAC Lookup, IP Rep, Security Detection
Subnet Tools 7 Subnet Calc, Decimal Conv, IP Range Gen, Wildcard Mask, Net Req, Breakdown, Supernet
Scanning 4 Ping, Port Scan, DNS, Traceroute
Utilities 3 Export, Batch Analysis, MAC Lookup
Total 21+ Comprehensive Network Analysis

🎯 Use Cases

  • Network Administration - Plan and manage network subnets
  • Penetration Testing - Scan networks and gather intelligence
  • SOC Operations - Quickly analyze suspicious IPs
  • Incident Response - Trace IP origins and determine threats
  • Security Research - Investigate IP reputation and hosting
  • Network Documentation - Generate reports for compliance

πŸ› οΈ Advanced Features

Geolocation Data Includes

  • Country, Region, City, District, ZIP Code
  • Latitude, Longitude, Timezone
  • ISP, Organization, AS Number
  • Connection Type, Reverse DNS
  • Currency and UTC Offset
  • Proxy/VPN Detection
  • Data Center Detection
  • Mobile Connection Detection

Subnet Analysis Includes

  • Network/Broadcast addresses
  • Usable host ranges
  • Binary and hex representations
  • CIDR notation
  • Number of networks/hosts
  • Subnet breakdown calculations

πŸ”„ Workflow Example

  1. Identify IP β†’ Use IP Geolocation Lookup
  2. Check Threat Level β†’ Review security detection results
  3. Scan Ports β†’ Run port scanner on the IP
  4. Analyze Network β†’ Use subnet tools to understand the network
  5. Export Report β†’ Save findings to JSON/CSV

πŸ“ Output Formats

  • JSON - Complete structured data export
  • CSV - Spreadsheet-compatible format
  • TXT - Plain text IP lists
  • Console - Beautiful colored terminal output

βš™οΈ Configuration

The tool uses the free ip-api.com API for geolocation (limited to 45 requests/minute). For production use, consider:

  • Setting up API rate limiting
  • Using premium APIs for higher limits
  • Implementing caching for repeated lookups

🀝 Contributing

Contributions are welcome! Areas for enhancement:

  • IPv6 support
  • Additional APIs for IP reputation
  • Advanced reporting templates
  • Performance optimizations
  • More port scanner options

πŸ“„ License

MIT License - Free for personal and commercial use

⚑ Performance Tips

  • Geolocation lookups: ~1-2 seconds
  • Port scans: ~10 seconds (10 ports)
  • DNS lookups: ~1 second
  • Subnet calculations: Instant
  • IP range generation: <1 second for typical ranges

πŸ› Troubleshooting

API Rate Limited?

  • Wait a few minutes or use a smaller batch
  • Consider purchasing API credits

Port Scan Slow?

  • Reduce number of ports scanned
  • Increase timeout threshold

DNS Lookup Failed?

  • Check internet connection
  • Verify domain name spelling
  • Try reverse DNS instead

πŸ“ž Support

For issues, questions, or feature requests, please open an issue on GitHub.

πŸ™ Acknowledgments

  • ip-api.com for geolocation data
  • Python community for excellent libraries
  • Security researchers and network professionals

Made with ❀️ for network professionals

Visit the project: GitHub Repository

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages