# ipviewer

> Locate an IP Address

Latest version **1.0.10** (published 2023-11-08) · ISC license · 0 weekly downloads

## Install

```sh
npm install ipviewer
pnpm add ipviewer
yarn add ipviewer
bun add ipviewer
```

Provides the command `ipviewer`.

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.10 |
| Published | 2023-11-08 |
| First published | 2023-11-06 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 4 |
| Unpacked size | 10.2 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| Author | danielgtdm |
| Maintainers | danielgtdm |

## Links

- npm: https://www.npmjs.com/package/ipviewer
- npm.io page: https://npm.io/package/ipviewer

## Dependencies (4)

- [fs](https://npm.io/package/fs.md) 0.0.1-security
- [ora](https://npm.io/package/ora.md) ^7.0.1
- [axios](https://npm.io/package/axios.md) ^1.6.0
- [yargs](https://npm.io/package/yargs.md) ^17.7.2

## Recent versions

- 1.0.10 (latest) — 2023-11-08
- 1.0.9 — 2023-11-08
- 1.0.8 — 2023-11-06
- 1.0.7 — 2023-11-06
- 1.0.6 — 2023-11-06
- 1.0.5 — 2023-11-06
- 1.0.4 — 2023-11-06
- 1.0.3 — 2023-11-06
- 1.0.2 — 2023-11-06
- 1.0.1 — 2023-11-06
- 1.0.0 — 2023-11-06

## README

# ipviewer

This is a library for locate IPv4 addresses, using as data source the [IPinfo.io](https://ipinfo.io/) free service.

You will need to create an account in [IPinfo.io](https://ipinfo.io/) and get your own token (very easy) that look like `8e1441b9******`.

At the moment, free plan service allow 50k lookups per month, perfect for little projects.

# Installation

## Use in terminal

For use in terminal, install globally using npm:

```sh
$ npm install ipviewer -g
```

If you need permissions for global installation:

```sh
$ sudo npm install ipviewer -g
```

Then execute:

```sh
$ ipviewer --version
```

If the installation was successful, this should print the latest version of ipviewer.

### Set token

Put your token in ipviewer for start using:

```sh
$ ipviewer -t 8e1441b9******
```

### Use

Locate an IP using ipviewer with the `-l` flag, for example:

```sh
# input
$ ipviewer -l 8.8.4.4

# output
IP:  8.8.4.4
City:  Mountain View
Region:  California
Country:  US
```

For detailed output, use the `-v` flag:

```sh
# input
$ ipviewer -l 8.8.4.4 -v

# output
IP:  8.8.4.4
City:  Mountain View
Region:  California
Country:  US
Postal Code:  94043
Coordinates:  37.4056,-122.0775
ISP:  AS15169 Google LLC
Time Zone:  America/Los_Angeles
```

## Use in Nodejs projects

Soon...

---
_Source: https://npm.io/package/ipviewer · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._