Skip to content

A simple tool to track location information based on IP address. Created for educational purposes and to raise awareness about the importance of maintaining online privacy.

Notifications You must be signed in to change notification settings

dcodemaxz/IP-LOC

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

🌐 IP-LOC: TRACK IP LOCATION.

IP-LOC Banner

GitHub stars Version Python Platform

⚠️ Legal and Ethical Warning

IMPORTANT: IP Tracking Ethical Guidelines

  • 🚨 This tool is strictly for educational purposes only
  • 🔒 Obtain explicit consent before tracking any IP
  • 📜 Comply with all local and international privacy laws
  • 🛡️ Unauthorized IP tracking may be illegal

Potential Legal Consequences:

  • Violation of privacy rights
  • Potential criminal charges
  • Civil liability

🚀 Overview

IP-LOC is an advanced IP geolocation tracking tool designed for cybersecurity research, network analysis, and educational understanding of IP intelligence.

🔍 IP Tracking Commands & Usage

Basic IP Tracking

python main.py
# or
python3 main.py

Tracking Scenarios

  1. Public IP Lookup
Enter IP to track: 8.8.8.8  # Example Public IP
  1. Local Network IP
Enter IP to track: 192.168.1.1

Advanced IP Tracking Methods

1. Single IP Tracking

  • Interactive prompt
  • Real-time location data
  • Detailed network information

2. Batch IP Processing (Future Feature)

  • Multiple IP tracking
  • CSV/TXT file input support

🕵️ What Information Can Be Retrieved?

  • 🌍 Geographical Location

    • Country
    • Region/Province
    • City
  • 🌐 Network Details

    • Hostname
    • Internet Service Provider (ISP)
    • Timezone
    • Geographical Coordinates

🛡️ Consent and Privacy Principles

Ethical IP Tracking Checklist

  1. Always Obtain Consent

    • Explicit permission from IP owner
    • Clear communication of tracking purpose
  2. Respect Privacy

    • Never use for malicious intent
    • Protect personal information
    • Delete data after analysis
  3. Legal Compliance

    • Understand local cybercrime laws
    • Maintain professional standards

🔒 Tracking Limitations

  • Only works with IPv4 addresses
  • Requires active internet connection
  • Accuracy depends on IP database
  • Some IPs might have limited information

🚨 Potential Misuse Scenarios to Avoid

❌ DO NOT:

  • Track personal IPs without permission
  • Use for stalking or harassment
  • Violate terms of service
  • Breach organizational policies

✅ RECOMMENDED USE:

  • Network administration
  • Cybersecurity research
  • Educational demonstrations
  • Authorized security assessments

🛠️ System Requirements

Minimum Configuration

  • Python 3.7+
  • 50MB Disk Space
  • Active Internet Connection

Supported Platforms

  • ✅ Linux (Ubuntu, Debian, Fedora)
  • ✅ Termux (Android)
  • ✅ WSL (Windows Subsystem for Linux)

🔧 Installation Guide

Termux Installation

pkg update && pkg upgrade -y
pkg install python git -y
git clone https://github.com/Maxz-09/IP-LOC.git
cd IP-LOC
pip install -r requirements.txt

Linux Installation

sudo apt update
sudo apt install python3 python3-pip git -y
git clone https://github.com/Maxz-09/IP-LOC.git
cd IP-LOC
pip3 install -r requirements.txt

🤝 Contribution & Reporting

Responsible Disclosure

  • Report ethical concerns
  • Suggest privacy improvements
  • Help maintain tool's integrity

🌐 Connect


Version 1.5 | Crafted Responsibly 🌐

About

A simple tool to track location information based on IP address. Created for educational purposes and to raise awareness about the importance of maintaining online privacy.

Resources

Stars

Watchers

Forks