A modern and intuitive desktop application to find and manage your public and local IP addresses, with advanced geolocation features and system integration.
- Public IP: Automatically detects your public IP address using multiple services for reliability
- Local IP: Instantly displays your local IP address on your home/corporate network
- Multi-Service Backup: Fallback system using different providers (ipify.org, httpbin.org, myip.com)
- Geographic Information: Get complete details about your public IP location
- ISP Data: View information about your internet service provider
- GPS Coordinates: Precise latitude and longitude coordinates
- Timezone: Time zone associated with your location
- Dark Theme Design: Elegant interface with modern dark theme
- Responsive UI: Optimized layout for better user experience
- Hover Animations: Interactive effects on buttons and elements
- Semantic Color Coding: Distinctive colors for success, error, and information
- Quick Copy: Instantly copy IP addresses to clipboard
- Visual Feedback: Immediate confirmation of copy operations
- Cross-platform Compatibility: Clipboard support for all operating systems
# Windows
start.bat
# Linux/macOS
python start.py# 1. Install dependencies
pip install -r requirements.txt
# 2. Launch the application
python main.pyip-address-finder/
├── 📄 main.py # Main application with GUI
├── 🚀 start.py # Automatic startup script
├── 💾 start.bat # Windows launcher
├── 📋 requirements.txt # Python dependencies
├── 📖 README.md # Project documentation
└── 🖼️ ico/ # Icons directory (optional)
└── app_icon.ico # Application icon
The heart of the application containing:
AdvancedIPFinder: Main class managing the entire user interface- GUI Components: Graphical interface built with Tkinter
- IP Detection: Logic for detecting public and local IPs
- Network Services: Integration with web services for IP and geolocation
- Clipboard Management: Clipboard copy functionality
- Threading: Asynchronous operations to prevent UI blocking
Technical Features:
- 🎨 Design System: Consistent and modern color scheme
- 🔄 Multi-threading: Non-blocking network requests
- 🛡️ Error Handling: Robust network error management
- 📱 Responsive Layout: Adaptive and centered interface
Intelligent startup system including:
- Dependency Checker: Automatic Python dependency verification
- Auto-installer: Automatic installation of missing packages
- Environment Validation: Execution environment checks
- Colored Output: Colored output for better user experience
- Error Recovery: Intelligent installation error handling
Features:
- ✅ Auto-setup: Automatically configures the environment
- 🔍 Smart Detection: Detects Python and required libraries
- 🎨 Colored CLI: Colored command line interface
- ⏱️ Timeout Handling: Installation timeout management
Simplified launcher for Windows users:
- Double-click launch
- Custom window title
- Final pause to view any errors
List of essential dependencies:
requests: For HTTP calls to IP detection servicespyperclip: For advanced cross-platform clipboard management
- Click the "🔍 Get Public IP" button
- Wait for loading (progress indicator)
- View the result with additional options
- Local IP is automatically displayed on startup
- Use the "📋 Copy" button to copy it
- After getting the public IP, click "🌍 Geo Info"
- View complete details about:
- 🌍 Country and city
- 📍 Region and coordinates
- 🌐 Internet provider (ISP)
- 🕐 Time zone
- Use "📋 Copy" buttons to quickly copy IPs
- Get immediate operation confirmation
- Python: 3.7 or higher
- Operating System: Windows 10+, macOS 10.14+, Linux (Ubuntu 18.04+)
- Internet Connection: Required for public IP detection
- RAM: Minimum 512 MB available
- Storage: 50 MB free space
- Display: Minimum resolution 800x600
- ✅ No Data Storage: No data is saved locally
- ✅ No Tracking: No behavior or preferences tracking
- ✅ HTTPS Only: All communications use secure protocols
- ✅ Local Processing: Completely local data processing
The following external services are used exclusively for IP detection:
- 🔗 ipify.org: Primary service for public IP
- 🔗 httpbin.org: Backup service
- 🔗 myip.com: Alternative service
- 🔗 ip-api.com: For geolocation information
Possible causes:
- No internet connection or unstable connection
- Firewall blocking HTTP requests
- IP detection services temporarily unavailable
Solutions:
- Check internet connection
- Try again after a few seconds
- Check firewall settings
Possible causes:
- Network configuration issues
- Network interfaces disabled
Solutions:
- Restart the application
- Check active network connections
- Restart network adapter if necessary
Possible causes:
- Invalid public IP
- Geolocation service unavailable
- Corporate network restrictions
Solutions:
- Verify you have a valid public IP
- Try again after a few minutes
- Contact network administrator if in corporate environment
- 🌐 Multi-language Support: Support for multiple languages
- 📊 Network Monitoring: Continuous connection monitoring
- 🕐 History Tracking: History of detected IPs
- 🔄 Auto-refresh: Periodic automatic updates
- 🛡️ VPN Detection: VPN/Proxy connection detection
- 🌍 Extended Geo Info: Extended geographic information
- 📧 Export Features: Data export in various formats
- 🎨 Theme Customization: Theme and color customization
Developed by: EventExecutor
Year: 2025
Current Version: 1.0
For bug reports, feature requests, or general support, please open an issue in the project repository.
This project is distributed under the MIT License. See the LICENSE file for complete details.
🌟 If this project was useful to you, consider leaving a star! 🌟
Made with ❤️ and Python