# 🦎 asngecko 1.2.0 – Fetch IP ranges for Autonomous Systems

![License](https://img.shields.io/badge/license-MIT-blue)
![Shell](https://img.shields.io/badge/shell-bash-green)

> Quickly fetch & format IPv4/IPv6 prefix lists for one‑or‑many Autonomous Systems (ASNs).

Awesome customizable tool for retrieving registered IPs attached to ASN systems, enabling easy management, listing, filtering, and automation to your needs.
This can resolve ASNs in batch, and also supports custom timeout between requests, avoiding spam.

---

## ✨ Quick start

```bash
# install the tool (adds `asngecko` to /usr/local/bin)
bash install.sh

# remove it again (cleans up binary & completion files)
bash uninstall.sh
```

---

## 🚀 Usage

```bash
asngecko -a AS15169 [options]
asngecko -a "AS15169 AS16509" [options]
asngecko -a AS15169 -q [more options] | your-special-command
asngecko -l list.txt [options]
```

### Options

| Short | Long / Arg        | Meaning                                                   |         |                           |
| ----- | ----------------- | --------------------------------------------------------- | ------- | ------------------------- |
| `-a`  | `--asn "AS… AS…"` | Space‑separated list of ASNs (quote the list)             |         |                           |
| `-l`  | `--list FILE`     | Read ASNs from *FILE*, one per line                       |         |                           |
| `-4`  |                   | IPv4 only                                                 |         |                           |
| `-6`  |                   | IPv6 only                                                 |         |                           |
|       | `-b, --both`      | Fetch both families (default)                             |         |                           |
| `-s`  | `--server HOST`   | WHOIS server for both families                            |         |                           |
|       | `--server4 HOST`  | WHOIS server for IPv4 (default **whois.radb.net**)        |         |                           |
|       | `--server6 HOST`  | WHOIS server for IPv6 (default **whois.ripe.net**)        |         |                           |
| `-o`  | `--output FILE`   | Base filename (adds `.ipv4` / `.ipv6` if needed)          |         |                           |
|       | `--output4 FILE`  | Explicit IPv4 output path (overrides `-o`)                |         |                           |
|       | `--output6 FILE`  | Explicit IPv6 output path (overrides `-o`)                |         |                           |
| `-c`  | `--console`       | Print to stdout (default when no `-o/--outputX` is given) |         |                           |
| `-f`  | `--format FMT`    | Output format: `cidr`                                     |  `csv`  |  `json` (default: `cidr`) |
| `-u`  | `--uniq`          | De‑duplicate & sort prefixes                              |         |                           |
| `-t`  | `--throttle SEC`  | Sleep *SEC* seconds between individual ASN queries        |         |                           |
| `-q`  | `--quiet`         | Suppress progress output                                  |         |                           |
| `-h`  | `--help`          | Show help & exit                                          |         |                           |

---

## 💡 Examples

```bash
# Dump all prefixes for AS1234 and filter a single /24
asngecko -a AS1234 | grep 120.0.0.0/24

# Google IPv6 ranges to file
asngecko -a AS15169 -6 -o google_v6.txt

# Fetch Google (AS15169) and Facebook/Meta (AS32934) at once,
# writing IPv4 & IPv6 lists to separate folders
asngecko -a "AS15169 AS32934" -46 \
  --output4 /srv/v4/all.txt \
  --output6 /srv/v6/all.txt
```

---

## 📦 Installation

### Arch Linux / Manjaro

```bash
yay -S asngecko
```

### Manual

```bash
# Clone this repo & make the script executable
git clone https://github.com/youruser/asngecko.git
cd asngecko
chmod +x asngecko
audo cp asngecko /usr/local/bin/asngecko

# Optionally, add shell completion
sudo cp contrib/asngecko-completion.bash /etc/bash_completion.d/
```

### Dependencies

* **bash** >= 4.x (associative arrays)
* Standard UNIX tools: `awk`, `sed`, `grep`, `sort`, `uniq`
* External: `whois` (tested with *GNU jwhois* & *RIPE whois*)

---

## 🗃️ Output formats

* **cidr** – plain list (`203.0.113.0/24`)
* **csv**  – `asn,prefix,family` per line
* **json** – array of objects

---

## 📜 License

Licensed under the MIT License – see [LICENSE](LICENSE) for details.