ipwhoami
v1.2.1
Published
IP geolocation lookup from your terminal. Query multiple providers, compare results side-by-side.
Maintainers
Readme
$ ipwhoami 8.8.8.8
[ipinfo]
IP 8.8.8.8
City Mountain View
Region California
Country US
Org AS15169 Google LLC
Location 37.4056,-122.0775
Timezone America/Los_AngelesQuick Start
# Install globally
npm install -g ipwhoami
# Or run instantly without installing
npx ipwhoami 8.8.8.8Why ipwhoami?
- Zero dependencies — Uses Node.js 18+ built-in
fetch. No bloatednode_modules. - Multiple providers — Query ipinfo.io, ipapi.co, and ip-api.com from one tool.
- Compare mode — See how providers differ for the same IP, side-by-side.
- Pipe-friendly — Raw JSON output for scripting, CI pipelines, and composing with
jq. - Cross-platform — npm, Homebrew, Scoop, Docker, standalone Bash & PowerShell scripts.
- No API keys — Works out of the box with free tiers.
Install
npm install -g ipwhoamibrew tap vineethkrishnan/ipwhoami && brew install ipwhoamiscoop bucket add ipwhoami https://github.com/vineethkrishnan/scoop-ipwhoami
scoop install ipwhoamidocker run --rm vineethnkrishnan/ipwhoami 8.8.8.8curl -fsSL https://raw.githubusercontent.com/vineethkrishnan/ipwhoami/main/install.sh | bashSee the Installation Guide for all methods including PowerShell and manual install.
Usage
ipwhoami [options] [ip]| Flag | Description |
|------|-------------|
| -p, --provider NAME | Provider: ipinfo, ipapi, ip-api (default: ipinfo) |
| -c, --compare | Compare results from all providers |
| -r, --raw | Output raw JSON |
| -h, --help | Show help |
| -v, --version | Show version |
Examples
ipwhoami # Your public IP
ipwhoami 8.8.8.8 # Specific IP
ipwhoami -c 1.1.1.1 # Compare all providers
ipwhoami -p ipapi 8.8.8.8 # Choose provider
ipwhoami -r 8.8.8.8 | jq .city # Raw JSON, pipe to jqCompare Mode
$ ipwhoami -c 8.8.8.8
Comparing geolocation for: 8.8.8.8
────────────────────────────────────────
[ipinfo]
IP 8.8.8.8
City Mountain View
Region California
Country US
Org AS15169 Google LLC
Location 37.4056,-122.0775
Timezone America/Los_Angeles
[ipapi]
IP 8.8.8.8
City Mountain View
Region California
Country United States
Org Google LLC
Location 37.4223, -122.085
Timezone America/Los_Angeles
[ip-api]
IP 8.8.8.8
City Mountain View
Region California
Country United States
ISP Google LLC
Location 37.4056, -122.0775
Timezone America/Los_AngelesProviders
| Provider | HTTPS | Rate Limit | Notes | |----------|-------|------------|-------| | ipinfo.io | Yes | 50k/month | Default | | ipapi.co | Yes | 1k/day | Full country names | | ip-api.com | No | 45/min | ISP info |
Contributing
Contributions are welcome! ipwhoami uses a clean provider pattern — adding a new geolocation source is just one file + one line.
git clone https://github.com/vineethkrishnan/ipwhoami.git
cd ipwhoami
node bin/ipwhoami.js 8.8.8.8 # zero dependencies, works immediatelySee the Contributing Guide and Adding a Provider docs.
Documentation
Full documentation is available at ipwhoami-docs.vineethnk.in
