ip-fetch
IP Geolocation data fetcher for Kodachi OS - Fetches and displays IP address information including geolocation, ISP, and network details
Version: 9.0.1 | Size: 10.4MB | Author: Warith Al Maawali
License: Proprietary | Website: https://www.digi77.com
File Information
| Property | Value |
|---|---|
| Binary Name | ip-fetch |
| Version | 9.0.1 |
| Build Date | 2025-09-23T19:20:07.298883446Z |
| Rust Version | 1.82.0 |
| File Size | 10.4MB |
| JSON Data | View Raw JSON |
SHA256 Checksum
Features
| Feature | Description |
|---|---|
| Feature | Multi-source IP geolocation with fallback support |
| Feature | IPv4 and IPv6 dual-stack support |
| Feature | Bulk IP lookup with optimized performance |
| Feature | Offline mode with cached data |
| Feature | VPN and proxy detection |
| Feature | ISP and organization information |
| Feature | Secure API communication with certificate pinning |
| Feature | Rate limiting and retry logic |
| Feature | Comprehensive error handling |
Security Features
| Feature | Description |
|---|---|
| Authentication | Secure authentication with certificate pinning |
| Encryption | TLS 1.3 for all network communications |
| Inputvalidation | All inputs are validated and sanitized |
| Ratelimiting | Built-in rate limiting for network operations |
System Requirements
| Requirement | Value |
|---|---|
| OS | Linux (Debian-based) |
| Privileges | root/sudo for system operations |
| Dependencies | OpenSSL, libcurl |
Global Options
| Flag | Description |
|---|---|
-h, --help |
Print help information |
-v, --version |
Print version information |
-n, --info |
Display detailed information |
-e, --examples |
Show usage examples |
--json |
Output in JSON format |
--json-pretty |
Pretty-print JSON output with indentation |
--json-human |
Enhanced JSON output with improved formatting (like jq) |
--verbose |
Enable verbose output |
--quiet |
Suppress non-essential output |
--no-color |
Disable colored output |
--config <FILE> |
Use custom configuration file |
--timeout <SECS> |
Set timeout (default: 30) |
--retry <COUNT> |
Retry attempts (default: 3) |
Commands
Authentication
auth-status
Check authentication status
Usage:
Basic Operations
plain-ip
Simple plain text IP address retrieval
Usage:
Cache Management
cache
Manage IP cache for improved performance
Usage:
Comprehensive Testing
test-all
Complete test suites for all functionality
Usage:
DNS Operations
dns
DNS-based IP resolution and testing
Usage:
Debugging
debug-auth
Create authentication debug script
Usage:
Geolocation Services
geo
Geolocation API testing with various IPs
Usage:
IP Operations
fetch
Fetch IP geolocation information (default command)
Usage:
Network Testing
tor
Test IP lookup through Tor SOCKS proxy
Usage:
check-tor
Check if connection is using Tor network
Usage:
Testing Operations
test-fallback
Test fallback mechanisms and multiple source verification
Usage:
verify-multi
Verify multiple sources
Usage:
random
Test random server selection functionality
Usage:
Examples
Usage Examples
Common usage patterns for ip-fetch
Get your current public IP
Expected Output: Current IP with geolocation dataShow usage examples
Expected Output: Display all usage patternsBasic Usage
Common IP lookup operations
Get your current public IP from Kodachi Cloud (primary) with automatic fallback
Expected Output: Current IP with geolocation dataLook up specific IP address
Expected Output: Geolocation data for 8.8.8.8Look up multiple IP addresses
Expected Output: Bulk lookup resultsNote
Automatically uses bulk mode for better performance
Force refresh cache and get latest IP data
Expected Output: Fresh IP data bypassing cacheOutput Formats
Different ways to format output
Get your current IP in JSON format from primary source with fallback
Expected Output: JSON object with complete IP informationFormatted JSON with indentation
Expected Output: Pretty-printed JSON outputEnhanced human-readable JSON output with colors (like jq)
Expected Output: Colorized JSON output for better readabilityBasic IP Lookups
Own IP lookup and single IP lookup operations
Explicitly request IPv4 from primary source with fallback
Expected Output: Shows your IPv4 address with geolocation dataGet your current public IPv6 from Kodachi Cloud (primary) with automatic fallback
Expected Output: Shows your IPv6 address with geolocation dataGet your IPv6 in JSON format from primary source with fallback
Expected Output: JSON object with IPv6 geolocation dataGet both IPv4 and IPv6 information from primary sources with fallback
Expected Output: Shows both IPv4 and IPv6 with full detailsGet both IPs in JSON format from primary sources with fallback
Expected Output: JSON object with both IPv4 and IPv6 dataFallback and Multi-Source Testing
Testing fallback mechanisms and multiple source verification
Test IPv4 JSON sources with automatic fallback
Expected Output: IPv4 JSON fallback test resultsTest IPv6 JSON sources with automatic fallback
Expected Output: IPv6 JSON fallback test results in JSON formatTest IPv4 plain text sources with automatic fallback
Expected Output: IPv4 plain text fallback resultsTest IPv6 plain text sources with automatic fallback
Expected Output: IPv6 plain text fallback resultsTest ALL IPv4 sources to verify consistency
Expected Output: IPv4 multi-source verification reportTest ALL IPv6 sources with JSON output
Expected Output: JSON IPv6 multi-source verificationTor Detection
Check if your connection is using Tor
Check if connection is using Tor and show IP
Expected Output: Tor status and current IP addressGet just the IP address
Expected Output: Your current IP addressGet just the Tor status
Expected Output: true or falseGet Tor status and IP in JSON format
Expected Output: JSON object with IsTor and IP fieldsPretty-printed JSON output
Expected Output: Formatted JSON with Tor statusColorized JSON output (like jq)
Expected Output: Colored JSON with Tor statusTor Network Testing
Testing IP lookup through Tor SOCKS proxy
Get IPv4 through Tor SOCKS5 proxy from ONE random source
Expected Output: IP address via Tor proxyTest ALL IPv4 sources through Tor SOCKS5 proxy
Expected Output: Comprehensive Tor IPv4 test resultsTest ALL IPv6 sources through Tor SOCKS5 proxy with JSON output
Expected Output: JSON array with all Tor IPv6 resultsGet IPv4 JSON response through Tor SOCKS5 proxy
Expected Output: JSON IPv4 data via TorRandom source through Tor SOCKS5 proxy
Expected Output: Random IP source via TorUse custom Tor port with ONE random IPv4 source
Expected Output: IPv4 via custom Tor portUse custom Tor port with ALL IPv4 sources
Expected Output: All IPv4 sources via custom Tor portDNS Resolution Testing
DNS-based IP resolution and testing
Test DNS-based IPv4 resolution using ONE random DNS query
Expected Output: IPv4 address from DNS queryTest DNS-based IPv6 resolution using ONE random DNS query
Expected Output: IPv6 address from DNS queryTest specific DNS query by index
Expected Output: IPv4 from specific DNS queryTest ALL available IPv6 DNS queries with JSON output
Expected Output: JSON array with all IPv6 DNS resultsComprehensive Testing Suite
Complete test suites for all functionality
Complete test suite results
Expected Output: Full functionality test reportComplete test suite including Tor tests
Expected Output: Comprehensive test results with TorComplete test suite including Tor tests using custom SOCKS port 9150
Expected Output: JSON formatted test results with custom Tor portJSON formatted complete test results
Expected Output: Structured test suite resultsRandom Source Testing
Test random IP sources for reliability
Test ONE random IPv4 plain text source
Expected Output: Random IPv4 source test resultTest ONE random IPv4 JSON source with JSON output
Expected Output: Random IPv4 JSON source test resultTest ONE random DNS IPv4 query
Expected Output: Random DNS IPv4 query resultTest ONE random DNS IPv6 query with JSON output
Expected Output: Random DNS IPv6 query result in JSONGeolocation API Testing
Test geolocation APIs with various IPs
Test geo APIs with current IP
Expected Output: Geolocation test results for your IPTest geo APIs with specific IP
Expected Output: Geolocation test results for 8.8.8.8Show raw JSON responses
Expected Output: Detailed geo API responsesGeo data for IP in JSON
Expected Output: JSON geolocation data for 1.1.1.1Plain Text IP Retrieval
Get IP addresses in plain text format
Get IPv4 plain text
Expected Output: Your IPv4 address as plain textGet IPv6 plain text
Expected Output: Your IPv6 address as plain textUse specific server by index
Expected Output: IPv4 from server index 5Authentication Commands
Authentication and API status commands
Check authentication status
Expected Output: Current authentication statusAuth status in JSON format
Expected Output: JSON authentication statusCreate authentication debug script
Expected Output: Debug script createdBulk Operations
Efficient bulk IP lookups
Efficient bulk lookup of multiple IPs
Expected Output: Bulk results for all IPsBulk lookup with JSON output
Expected Output: JSON array with all IP dataDisable bulk mode for individual lookups
Expected Output: Individual lookup resultsBulk IPv4-only lookups
Expected Output: Bulk IPv4 resultsBulk lookup without saving to history
Expected Output: Bulk results (not saved)Basic Usage
Common IP lookup operations
Get your current public IP from Kodachi Cloud (primary) with automatic fallback
Expected Output: Current IP with geolocation dataLook up specific IP address
Expected Output: Geolocation data for 8.8.8.8Look up multiple IP addresses
Expected Output: Bulk lookup resultsNote
Automatically uses bulk mode for better performance
Force refresh cache and get latest IP data
Expected Output: Fresh IP data bypassing cacheOutput Formats
Different ways to format output
Get your current IP in JSON format from primary source with fallback
Expected Output: JSON object with complete IP informationFormatted JSON with indentation
Expected Output: Pretty-printed JSON outputEnhanced human-readable JSON output with colors (like jq)
Expected Output: Colorized JSON output for better readabilityBasic IP Lookups
Own IP lookup and single IP lookup operations
Explicitly request IPv4 from primary source with fallback
Expected Output: Shows your IPv4 address with geolocation dataGet your current public IPv6 from Kodachi Cloud (primary) with automatic fallback
Expected Output: Shows your IPv6 address with geolocation dataGet your IPv6 in JSON format from primary source with fallback
Expected Output: JSON object with IPv6 geolocation dataGet both IPv4 and IPv6 information from primary sources with fallback
Expected Output: Shows both IPv4 and IPv6 with full detailsGet both IPs in JSON format from primary sources with fallback
Expected Output: JSON object with both IPv4 and IPv6 dataFallback and Multi-Source Testing
Testing fallback mechanisms and multiple source verification
Test IPv4 JSON sources with automatic fallback
Expected Output: IPv4 JSON fallback test resultsTest IPv6 JSON sources with automatic fallback
Expected Output: IPv6 JSON fallback test results in JSON formatTest IPv4 plain text sources with automatic fallback
Expected Output: IPv4 plain text fallback resultsTest IPv6 plain text sources with automatic fallback
Expected Output: IPv6 plain text fallback resultsTest ALL IPv4 sources to verify consistency
Expected Output: IPv4 multi-source verification reportTest ALL IPv6 sources with JSON output
Expected Output: JSON IPv6 multi-source verificationRandom Source Testing
Test random IP sources for reliability
Test ONE random IPv4 plain text source
Expected Output: Random IPv4 source test resultTest ONE random IPv4 JSON source with JSON output
Expected Output: Random IPv4 JSON source test resultTest ONE random DNS IPv4 query
Expected Output: Random DNS IPv4 query resultTest ONE random DNS IPv6 query with JSON output
Expected Output: Random DNS IPv6 query result in JSONTor Network Testing
Testing IP lookup through Tor SOCKS proxy
Get IPv4 through Tor SOCKS5 proxy from ONE random source
Expected Output: IP address via Tor proxyTest ALL IPv4 sources through Tor SOCKS5 proxy
Expected Output: Comprehensive Tor IPv4 test resultsTest ALL IPv6 sources through Tor SOCKS5 proxy with JSON output
Expected Output: JSON array with all Tor IPv6 resultsGet IPv4 JSON response through Tor SOCKS5 proxy
Expected Output: JSON IPv4 data via TorRandom source through Tor SOCKS5 proxy
Expected Output: Random IP source via TorUse custom Tor port with ONE random IPv4 source
Expected Output: IPv4 via custom Tor portUse custom Tor port with ALL IPv4 sources
Expected Output: All IPv4 sources via custom Tor portTor Detection
Check if your connection is using Tor
Check if connection is using Tor and show IP
Expected Output: Tor status and current IP addressGet just the IP address
Expected Output: Your current IP addressGet just the Tor status
Expected Output: true or falseGet Tor status and IP in JSON format
Expected Output: JSON object with IsTor and IP fieldsPretty-printed JSON output
Expected Output: Formatted JSON with Tor statusColorized JSON output (like jq)
Expected Output: Colored JSON with Tor statusDNS Resolution Testing
DNS-based IP resolution and testing
Test DNS-based IPv4 resolution using ONE random DNS query
Expected Output: IPv4 address from DNS queryTest DNS-based IPv6 resolution using ONE random DNS query
Expected Output: IPv6 address from DNS queryTest specific DNS query by index
Expected Output: IPv4 from specific DNS queryTest ALL available IPv6 DNS queries with JSON output
Expected Output: JSON array with all IPv6 DNS resultsGeolocation API Testing
Test geolocation APIs with various IPs
Test geo APIs with current IP
Expected Output: Geolocation test results for your IPTest geo APIs with specific IP
Expected Output: Geolocation test results for 8.8.8.8Show raw JSON responses
Expected Output: Detailed geo API responsesGeo data for IP in JSON
Expected Output: JSON geolocation data for 1.1.1.1Plain Text IP Retrieval
Get IP addresses in plain text format
Get IPv4 plain text
Expected Output: Your IPv4 address as plain textGet IPv6 plain text
Expected Output: Your IPv6 address as plain textUse specific server by index
Expected Output: IPv4 from server index 5Comprehensive Testing Suite
Complete test suites for all functionality
Complete test suite results
Expected Output: Full functionality test reportComplete test suite including Tor tests
Expected Output: Comprehensive test results with TorComplete test suite including Tor tests using custom SOCKS port 9150
Expected Output: JSON formatted test results with custom Tor portJSON formatted complete test results
Expected Output: Structured test suite resultsAuthentication Commands
Authentication and API status commands
Check authentication status
Expected Output: Current authentication statusAuth status in JSON format
Expected Output: JSON authentication statusCreate authentication debug script
Expected Output: Debug script createdBulk Operations
Efficient bulk IP lookups
Efficient bulk lookup of multiple IPs
Expected Output: Bulk results for all IPsBulk lookup with JSON output
Expected Output: JSON array with all IP dataDisable bulk mode for individual lookups
Expected Output: Individual lookup resultsBulk IPv4-only lookups
Expected Output: Bulk IPv4 resultsBulk lookup without saving to history
Expected Output: Bulk results (not saved)Custom Server Options
Use custom servers for IP lookup
Use custom server for IP lookup
Expected Output: IP from custom serverCustom server with JSON output
Expected Output: JSON from custom serverCustom IPv4 server
Expected Output: IPv4 from custom serverCustom IPv6 server
Expected Output: IPv6 from custom serverOutput Formatting Options
Various output formatting options
Bulk lookup in JSON
Expected Output: JSON array with IP dataLookup without saving to history
Expected Output: IP data (not saved)No History Operations
Operations without saving to history
Get own IP without saving to history
Expected Output: Your IP (not saved)IPv6 multi-source verification without history
Expected Output: IPv6 verification results (not saved)DNS resolution without saving to history
Expected Output: DNS results (not saved)Tor test (ONE random source) without saving results to history
Expected Output: Tor test result (not saved)Tor test (ALL sources) without saving results to history
Expected Output: All Tor test results (not saved)Random IP test without history in JSON
Expected Output: Random test JSON (not saved)Geo lookup without saving to history
Expected Output: Geo data (not saved)Comprehensive test without saving any results to history
Expected Output: Full test results (not saved)Environment Variables
| Variable | Description | Default | Values |
|---|---|---|---|
RUST_LOG |
Set logging level | info | error |
NO_COLOR |
Disable all colored output when set | unset | 1 |
Exit Codes
| Code | Description |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Invalid arguments |
| 3 | Permission denied |
| 4 | Network error |
| 5 | File not found |