Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vernette/ipregion

🌎 Shell script to check how your IP is identified by the IP databases
https://github.com/vernette/ipregion

Last synced: 6 days ago
JSON representation

🌎 Shell script to check how your IP is identified by the IP databases

Awesome Lists containing this project

README

        

# IPRegion 🌍

This is a shell script designed to check how your public IP address is identified by various IP databases. The script queries multiple sources to retrieve the country code associated with your IP, providing a comprehensive overview of how different services interpret your location.

![image](https://i.imgur.com/7Tj4Usc.png)

## Features

- **Multiple Sources**: Supports queries from over 20 different IP information services, including:
- `ipinfo.io`
- `ipapi.com`
- `ipregistry.co`
- `db-ip.com`
- and [many](https://github.com/vernette/ipregion/blob/master/ipregion.sh#L6) more!

- **User-Friendly Output**: Displays the results in a clean and formatted manner, showing how each service identifies your IP.

- **Lightweight**: Written in Bash, the script has minimal dependencies, primarily requiring `curl` and `jq` for network requests and JSON parsing.

## Dependencies

Currently script supports automatic installation for the following OSes:

- Debian/Ubuntu
- Arch Linux
- Fedora
- Termux

For other systems, please install `curl` and `jq` manually.

## Usage

> [!TIP]
> If you see that any of the services stopped working (returning the country code), please create an [issue](https://github.com/vernette/ipregion/issues)

With curl:

```bash
curl -s "https://raw.githubusercontent.com/vernette/ipregion/master/ipregion.sh" | bash
```

With wget:

```bash
wget -qO - "https://raw.githubusercontent.com/vernette/ipregion/master/ipregion.sh" | bash
```

Or clone the repository and run the script manually:

```bash
git clone https://github.com/vernette/ipregion.git
cd ipregion
chmod +x ipregion.sh
./ipregion.sh
```

## TODO

- [ ] Add more IP services
- [ ] Add more supported OSes
- [ ] Handle errors when doing network requests
- [ ] Handle service rate limit errors
- [ ] Add IP identification by various sites (Google, TikTok, OpenAI, etc.)