🎯 GhostTrace - Advanced IP Intelligence Platform

Professional-Grade OSINT Tool for IP Geolocation & Network Intelligence Powered by VIPHacker100

GhostTrace is an advanced IP intelligence gathering tool designed for cybersecurity professionals, penetration testers, and OSINT researchers. It provides comprehensive geolocation data, network information, threat analysis, and visual mapping capabilities.

✨ Features

🔍 Core Intelligence Gathering

Multi-Source Data Aggregation - Queries 7+ geolocation APIs simultaneously
Real-Time Geolocation - Accurate city, region, and country identification
ISP/Organization Detection - Identifies network providers and ASN information
Reverse DNS Lookup - Discovers hostnames associated with target IPs
Proxy/VPN Detection - Identifies anonymization services and hosting providers
Device Type Recognition - Distinguishes between mobile and desktop connections

🛡️ Advanced Security Features

Port Scanning - Multi-threaded scanning of common service ports (21, 22, 80, 443, etc.)
Threat Intelligence - Security risk assessment and threat indicators
Network Fingerprinting - Detailed ASN and organization profiling

🗺️ Visual Intelligence

Automatic Satellite Mapping - Launches Google Maps, Google Earth, and Bing Maps
HTML Intelligence Reports - Professional reports with embedded interactive maps
Coordinate Verification - GPS coordinates with multiple map service links

📊 Reporting & Documentation

JSON Export - Machine-readable intelligence reports
HTML Reports - Human-friendly visual reports with embedded maps
Timestamped Archives - Organized file naming with date/time stamps
Session Logging - Complete audit trail of all operations

🎨 User Experience

Interactive Menu System - Easy-to-use control panel
Loading Animations - Professional progress indicators
Color-Coded Output - Enhanced readability with syntax highlighting
ASCII Art Banner - Distinctive branding and version information

📋 Requirements

System Requirements

Python: 3.7 or higher
Operating Systems: Windows, Linux, macOS
Internet Connection: Required for API queries
Web Browser: For automatic map launching

Python Dependencies

requests
colorama

🚀 Installation

1. Clone or Download

# Clone the repository
git clone https://github.com/viphacker-100/ghosttrace.git
cd ghosttrace

# Or download the script directly
wget https://raw.githubusercontent.com/viphacker-100/ghosttrace/main/ghosttrace.py

2. Install Dependencies

pip install -r requirements.txt

Or install manually:

pip install requests colorama

3. Run the Tool

python ghosttrace.py

💻 Usage

Basic Usage

Option 1: Interactive Menu

python ghosttrace.py

Then select from the menu:

[1] Trace Single IP
[2] Trace Your Public IP
[3] Batch IP Scan (Coming Soon)
[0] Exit

Option 2: Direct IP Trace

# Trace a specific IP
python ghosttrace.py
>>> Enter target IP: 8.8.8.8

# Trace your own public IP (leave blank)
python ghosttrace.py
>>> Enter target IP: [press ENTER]

Example Output

╔══════════════════════════════════════════════════════════╗
║               🎯 TARGET INTELLIGENCE ACQUIRED 🎯           ║
╠══════════════════════════════════════════════════════════╣
║ TARGET IP           : 8.8.8.8                             ║
║ HOSTNAME            : dns.google                          ║
║ LOCATION            : Mountain View, California           ║
║ COUNTRY             : United States [US]                  ║
║ ISP/ORGANIZATION    : Google LLC                          ║
║ ASN                 : AS15169                             ║
║ DEVICE TYPE         : 💻 Desktop                          ║
║ PROXY/VPN STATUS    : ✓ CLEAN                            ║
║ COORDINATES         : 37.4056, -122.0775                  ║
║ TIMEZONE            : America/Los_Angeles                 ║
║ POSTAL CODE         : 94043                               ║
╠══════════════════════════════════════════════════════════╣
║ GOOGLE MAPS         : maps.google.com?q=37.4056,-122.0775║
║ SATELLITE VIEW      : [LAUNCHING VISUAL CONFIRMATION]     ║
╚══════════════════════════════════════════════════════════╝

📂 Output Files

Generated Files

GhostTrace creates the following files in your working directory:

JSON Reports - GHOSTTRACE_{IP}_{TIMESTAMP}.json
- Complete intelligence data in machine-readable format
- Includes all geolocation, network, and threat data
HTML Reports - GHOSTTRACE_TARGET_{IP}_{TIMESTAMP}.html
- Professional visual reports
- Embedded Google Maps with target coordinates
- Quick access links to satellite imagery

Example File Structure

ghosttrace/
├── ghosttrace.py
├── requirements.txt
├── README.md
├── GHOSTTRACE_8.8.8.8_20250109_143052.json
└── GHOSTTRACE_TARGET_8.8.8.8_20250109_143052.html

🔧 Advanced Configuration

Custom Port Scanning

Edit the port list in the script:

common_ports = [21, 22, 23, 25, 80, 443, 3306, 3389, 8080, 8443]

API Timeout Settings

Adjust timeout values for slower connections:

r = requests.get(api_url, timeout=15)  # Default: 8 seconds

Threading Configuration

Modify concurrent port scanning threads:

with ThreadPoolExecutor(max_workers=20) as executor:  # Default: 10

🛡️ Legal & Ethical Usage

⚠️ IMPORTANT DISCLAIMER

GhostTrace is designed for LEGAL and ETHICAL purposes ONLY:

✅ Authorized Use Cases:

Network administration and troubleshooting
Security auditing with proper authorization
OSINT research for legitimate purposes
Educational and learning purposes
Personal IP address verification

❌ Prohibited Activities:

Unauthorized network scanning or reconnaissance
Stalking, harassment, or invasion of privacy
Any illegal surveillance activities
Attacking or compromising systems without permission
Any activities violating local, state, or federal laws

Legal Responsibility

Users are solely responsible for ensuring their use complies with applicable laws
Always obtain proper authorization before scanning networks you don't own
Respect privacy laws and regulations in your jurisdiction
Follow terms of service of all APIs and services used

Ethical Guidelines

Obtain Permission - Always get authorization before scanning third-party networks
Respect Privacy - Don't use this tool to track individuals without consent
Report Responsibly - If you discover vulnerabilities, follow responsible disclosure
Educational Purpose - Use for learning and improving cybersecurity knowledge

🔍 API Sources

GhostTrace aggregates data from multiple free geolocation APIs:

ipapi.co
ip-api.com
ipwho.is
ip.sb
ipinfo.io
freegeoip.app
Custom API endpoints

Note: API rate limits may apply. The tool automatically falls back to alternative sources if one fails.

🐛 Troubleshooting

Common Issues

"No module named 'colorama'"

pip install colorama

"Connection timeout" errors

Check your internet connection
Increase timeout values in the script
Try again after a few minutes (API rate limit)

Port scanning not working

Ensure you have necessary permissions
Some ISPs block certain ports
Try running with administrator/sudo privileges

Maps not opening automatically

Check your default web browser settings
Files are saved locally - open HTML files manually
Verify browser is installed and accessible

🚀 Roadmap

Upcoming Features (v3.0)

🤝 Contributing

Contributions are welcome! Here's how you can help:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

Contribution Guidelines

Follow PEP 8 style guidelines
Add comments for complex logic
Test thoroughly before submitting
Update documentation as needed

📝 License

This project is licensed under the MIT License - see below for details:

MIT License

Copyright (c) 2025 VIPHacker100

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

📞 Support & Contact

Get Help

Issues: Report bugs or request features via GitHub Issues
Discussions: Join community discussions
Documentation: Check the wiki for detailed guides

Stay Updated

⭐ Star the repository to show support
👁️ Watch for updates and new releases
🔔 Enable notifications for important announcements

🙏 Acknowledgments

Thanks to all open-source geolocation API providers
Python community for excellent libraries
Security researchers for best practices and guidelines
Contributors and users for feedback and improvements

⚡ Quick Start Checklist

Python 3.7+ installed
Dependencies installed (pip install -r requirements.txt)
Internet connection active
Web browser available
Authorization obtained (if scanning third-party IPs)
Ready to launch! (python ghosttrace.py)

🔥 GhostTrace - Invisible. Precise. Unstoppable. 🔥

Developed with 💚 by VIPHacker100

⬆ Back to Top

Name		Name	Last commit message	Last commit date
LICENSE		LICENSE
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation