IPFinder 🌐

🇺🇸 English | 🇪🇸 Español

IPFinder is a lightweight, cross-platform CLI tool written in Python that allows you to retrieve detailed information about any IPv4 address. It is designed for OSINT, networking, security research, and general IP reconnaissance, with a clean output and easy installation.

---

✨ Features

• 🌍 Geolocation data (country, region, city)
• 🏢 ISP & ASN information
• 🔁 Reverse DNS (hostname)
• 🔢 Decimal IP conversion
• 🛰️ Latitude & longitude
• 🎨 Colored output (optional)
• ⌛ Loading animation
• 💻 Works on Windows, Linux, and macOS
• 📦 Simple installer that adds the command to PATH

---

📸 Example Output

---

🚀 Installation

Clone the repository:

git clone https://github.com/URDev4ever/IPFinder.git
cd IPFinder

Run the installer:

python installer.py

The installer will:

• Detect your operating system
• Install required dependencies
• Create a launcher (ipfinder)
• Add it to your system PATH (if possible)

After installation, you can run IPFinder from anywhere.

---

🧪 Usage

Interactive mode:

ipfinder

Analyze a specific IP:

ipfinder 8.8.8.8

Analyze your own public IP:

ipfinder -i

Disable colored output:

ipfinder -n

Show help:

ipfinder -h

---

⚙️ Command-Line Options

Option	Description
IP	Target IPv4 address
-i	Use your own public IP
-n	Disable colored output
-h	Show help menu

---

🛠️ How It Works

IPFinder retrieves IP intelligence using public IP information services and processes the data to display:

• Network ownership (ASN / ISP)
• Reverse DNS hostname
• Geographical location
• Decimal representation of the IP

No intrusive scanning is performed. This is a passive information-gathering tool.

---

⚠️ VPN / Proxy Detection

Detecting VPNs or proxies reliably is not guaranteed without specialized paid APIs.

IPFinder currently focuses on:

• Transparency
• Accuracy of raw IP data
• OSINT-friendly output

Future versions may include heuristic or reputation-based detection.

---

📦 Requirements

• Python 3.8+
• Internet connection

All required Python dependencies are installed automatically by the installer.

---

🧠 Use Cases

• OSINT investigations
• Network diagnostics
• Security research
• Educational purposes
• Quick IP lookups from terminal

⭐ If you find this project useful, consider giving it a star on GitHub!

---

Made with <3 by URDev.