IP Fetch
| Property |
Value |
| Binary Name |
ip-fetch |
| Version |
9.0.1 |
| File Size |
3.1MB |
| Author |
Warith Al Maawali |
| License |
Proprietary |
| Category |
Network & Routing |
| Description |
IP Geolocation data fetcher for Kodachi OS - Fetches and displays IP address information including g... |
| JSON Data |
View Raw JSON |
SHA256 Checksum
3b7ca0c5dc6b24f077b332247b2cedd2b509328c1efe4b7da96712611939d4cb
Key Features
IP Detection & Geolocation
| Feature |
Description |
| Multi-Source Fallback |
Automatically switches between multiple IP services if one fails |
| Dual Stack Support |
Full IPv4 and IPv6 address detection and geolocation |
| Smart Caching |
Reduces network requests while maintaining fresh data |
| Tor Verification |
Confirms if your traffic is properly routed through Tor |
Why IP Fetch is Essential
| Use Case |
Description |
| Anonymity Verification |
Quickly check if your real IP is hidden |
| Network Monitoring |
Track IP changes when switching between VPN/Tor |
| Authentication Gateway |
Verifies Kodachi service authentication status |
| Offline Capability |
Works even without internet using cached data |
TL;DR - Essential Commands
# Get your current IP with full geolocation data
ip-fetch fetch
# or simply
ip-fetch
# Get just your IP address (plain text for scripts)
ip-fetch plain-ip
# Check if your connection is using Tor
ip-fetch check-tor
# Look up multiple IP addresses (bulk mode)
ip-fetch 8.8.8.8 1.1.1.1 9.9.9.9
# Force refresh cache and get latest IP data
ip-fetch --refresh-cache
# JSON outputs
ip-fetch --json
ip-fetch --json-pretty
ip-fetch --json-human
ip-fetch --ipv4
ip-fetch --ipv6
ip-fetch --both
# DNS-based IP resolution
ip-fetch dns ipv4
# Get plain text IPv4 address
ip-fetch plain-ip ipv4
# Test geolocation APIs
ip-fetch geo
Understanding IP Fallback System
How Multi-Source Fallback Works
IP Fetch uses an intelligent fallback system that ensures you always get IP information:
# Primary lookup with automatic fallback
ip-fetch fetch
# Test all fallback sources
ip-fetch test-fallback ipv4
# Verify multiple sources match
ip-fetch verify-multi
Fallback Chain:
| Priority |
Source |
Description |
| 1 |
Kodachi Cloud |
Primary - Fastest, most reliable |
| 2 |
Secondary APIs |
Multiple backup services |
| 3 |
DNS Resolution |
Uses DNS queries for IP detection |
| 4 |
Cached Data |
Last resort using stored information |
Tor Network Verification
# Check if connection is using Tor and show IP
ip-fetch check-tor
# Get just the IP address
ip-fetch check-tor --ip-only
# Get just the Tor status
ip-fetch check-tor --status-only # Tor status without printing IP
# Get Tor status and IP in JSON format
ip-fetch check-tor --json
# Pretty-printed JSON output
ip-fetch check-tor --json-pretty
# Colorized JSON output (like jq)
ip-fetch check-tor --json-human
Authentication Integration
# Check authentication status
ip-fetch auth-status
# (Tip) Keep auth alive when running long checks:
online-auth authenticate --keep-alive
# Create debug script for auth issues
ip-fetch debug-auth
This creates a diagnostic script to troubleshoot authentication problems with other Kodachi services.
Caching System
# Force refresh (bypass cache)
ip-fetch --refresh-cache
# Manage cache
ip-fetch cache status # Show cache status
ip-fetch cache clear # Clear all cache
ip-fetch cache clear <IP> # Clear specific IP cache
Cache Warning
Cache data may not reflect IP changes when switching VPN/Tor connections. Always use --refresh-cache after connecting to VPN/Tor to get accurate current IP information.
Advanced Commands
For advanced users who need access to all available commands and options, please refer to the auto-generated command reference which includes:
| Feature |
Description |
| Bulk Operations |
Bulk IP lookup operations |
| DNS Resolution |
DNS-based IP resolution |
| Server Testing |
Random server selection testing |
| Cache Management |
Cache management commands |
| Custom Config |
Custom server configuration |
| IPv6 Operations |
IPv6-specific operations |
| JSON Formatting |
JSON output formatting options |
| CLI Reference |
All command-line flags and parameters |
IP Fetch works closely with other Kodachi tools for complete privacy protection:
| Tool |
Integration |
| Tor Switch |
Use ip-fetch check-tor to verify Tor connectivity after enabling torrification |
| DNS Leak |
Combine with DNS leak testing for complete anonymity verification |
| Routing Switch |
Verify IP changes after VPN/proxy connections |
| Online Auth |
Authentication required for enhanced geolocation features |
Security Notes
Important Security Practices:
| Practice |
Description |
| IP Verification |
Always verify IP changes after connecting to VPN/Tor using ip-fetch check-tor |
| Comprehensive Testing |
Use test-all command to run comprehensive functionality tests |
| Auth Check |
Check authentication with ip-fetch auth-status before using other Kodachi services |
| Quick Tor Check |
Use ip-fetch check-tor --status-only to quickly verify Tor connectivity |
| Cache Management |
Clear cache using ip-fetch cache clear if concerned about data persistence |
| Privacy Mode |
Use --nohistory flag to prevent saving lookup results to history |
| Metric |
Value |
Description |
| Lookup Time |
< 2 seconds |
Typical response time |
| Memory Usage |
~20MB active, < 5MB idle |
Resource consumption |
| CPU Usage |
< 5% active, 0% idle |
Processing overhead |
| Cache Duration |
5 minutes |
Default cache lifetime |
| Network Traffic |
< 5KB |
Per lookup bandwidth |
Support