📖 IP Tools Documentation

A comprehensive reference for the IP Address Processor and IP Range Expander — how they work, what each option does, and how to get the best results.

🌐

IP Address Processor

Clean, deduplicate, sort, and filter raw IP address lists.
📡

IP Range Expander

Expand CIDR notation ranges into full lists of individual IP addresses.

1. IP Address Processor

Overview

The IP Address Processor is a client-side tool that accepts a raw, unstructured list of IP addresses and transforms it into a clean, ready-to-use list. It handles mixed input formats, strips port numbers, removes duplicates and private ranges, and optionally checks addresses against the Wikimedia global block list.

How It Works

All processing happens entirely in your browser — no data is sent to any server (with the exception of the optional Wikimedia API check, which queries the public Wikimedia MetaWiki API using only the IP addresses you provide).

Tokenise input → Strip ports → Validate IPs → Remove private → Deduplicate → Sort → Wikimedia check → Render blocks
  1. Tokenisation — The raw input is split on newlines, commas, semicolons, spaces, and tabs. Each token is trimmed of surrounding whitespace.
  2. Port stripping — When enabled, port suffixes are removed. IPv4 addresses in the form 1.2.3.4:8080 become 1.2.3.4. Bracketed IPv6 addresses such as [::1]:443 are unwrapped to ::1.
  3. Validation — Each token is tested against a lenient IPv4 pattern (four dot-separated octets, each 0–255) and an IPv6 pattern (colon-containing hex strings). Tokens that do not match either pattern are silently discarded.
  4. Private / reserved IP removal — When enabled, addresses matching RFC 1918 private ranges, loopback (127.0.0.0/8, ::1), link-local (169.254.0.0/16, fe80::/10), and unique-local (fc00::/7) ranges are removed.
  5. Deduplication — When enabled, duplicate addresses are removed while preserving the first-seen order. The comparison is case-insensitive for IPv6.
  6. Sorting — When enabled, IPv4 addresses are sorted numerically; IPv6 addresses are sorted lexicographically.
  7. Wikimedia global block check — When enabled, each remaining IP is queried against the Wikimedia MetaWiki API. Globally blocked IPs are removed from the output. See § Wikimedia Global Block Check for details.
  8. Block rendering — The final list is split into copy-ready blocks of a configurable size (default 50 IPs per block).

Available Options

Option Default Description
Remove port numbers On Strips port suffixes from IPv4 (:port) and bracketed IPv6 ([addr]:port) addresses before any other processing.
Remove duplicate IPs On Retains only the first occurrence of each unique IP address, preserving the original input order.
Sort IPs Off Sorts the final list. IPv4 addresses are sorted numerically (e.g. 10.0.0.2 before 10.0.0.10); IPv6 addresses are sorted as strings.
Remove private/reserved IPs Off Removes addresses in RFC 1918 private ranges, loopback, link-local, and unique-local ranges.
Remove Wikimedia globally blocked IPs Off Queries the Wikimedia MetaWiki API for each IP and removes any that are globally blocked. Requires internet access; may take time for large lists.
IPs per block 50 Controls how many IP addresses appear in each output block. Accepts values from 1 to 10,000.

Usage Guide

  1. Navigate to the IP Address Processor.
  2. Paste your IP addresses into the input field. The tool accepts mixed formats — one IP per line, comma-separated, space-separated, or any combination.
  3. Select the processing options that apply to your use case.
  4. Click ⚡ Process IPs (or press Ctrl+Enter / Cmd+Enter).
  5. Review the statistics bar to see how many IPs were parsed, deduplicated, and removed.
  6. Copy individual blocks using the 📋 Copy Block button, or download / copy the entire list using the buttons above the results.
Tip: If you are working with a large list and need to check against the Wikimedia global block list, consider pre-filtering with other options first (e.g., remove private IPs and duplicates) to reduce the number of API calls required.

Accepted Input Formats

192.168.1.1:8080
10.0.0.1
[2001:db8::2]:8080
203.0.113.1, 203.0.113.2 203.0.113.3
198.51.100.4;198.51.100.5

2. IP Range Expander

Overview

The IP Range Expander accepts one or more IPv4 CIDR ranges and expands each into the complete set of individual IP addresses it contains. It is useful when you need to work with individual IPs from a known subnet, or when you want to cross-reference a CIDR block against a block list.

How It Works

Like the IP Address Processor, all computation runs entirely in your browser. The CIDR expansion algorithm uses standard 32-bit integer arithmetic to enumerate every address in the specified range.

Parse CIDR lines → Validate ranges → Expand to IPs → Wikimedia check → Render blocks
  1. Parsing — Each non-empty line of the input is treated as a single CIDR range. Whitespace is trimmed.
  2. Validation — Each range is checked for:
    • Correct CIDR format: a.b.c.d/prefix
    • A valid IPv4 base address (four octets, each 0–255)
    • A valid prefix length between 8 and 32 (ranges larger than /8 are rejected to prevent accidental expansion of more than 16 million IPs)
    Invalid lines are reported as errors beneath the input field; valid lines continue to be processed.
  3. Expansion — The base address is masked to the network address, then every host address from the network address to the broadcast address is enumerated and added to the list.
  4. Wikimedia global block check — When enabled, each expanded IP is queried against the Wikimedia MetaWiki API and blocked IPs are removed. See § Wikimedia Global Block Check for details.
  5. Block rendering — The final list is divided into copy-ready blocks of the configured size.

Available Options

Option Default Description
Remove Wikimedia globally blocked IPs Off Queries the Wikimedia MetaWiki API for each expanded IP and removes any that are globally blocked. Requires internet access; may take significant time for large ranges.
IPs per block 50 Controls how many IP addresses appear in each output block. Accepts values from 1 to 10,000.

Usage Guide

  1. Navigate to the IP Range Expander.
  2. Enter one CIDR range per line in the input field, for example: 
    178.176.72.0/24
203.0.113.0/28
  3. Select options as needed.
  4. Click 📡 Expand Ranges (or press Ctrl+Enter / Cmd+Enter).
  5. Any invalid ranges are displayed as error messages. Valid ranges are expanded immediately.
  6. Copy individual blocks or the full list using the provided buttons.
Size limit: Ranges with a prefix shorter than /8 (i.e., containing more than 16,777,216 addresses) are rejected. If you need to work with very large ranges, split them into smaller subnets before expanding.

3. Wikimedia Global Block Check

Both tools offer an optional check against the Wikimedia global block list. This list contains IP addresses and ranges that have been blocked across all Wikimedia wikis (Wikipedia, Wiktionary, Wikidata, etc.) due to persistent abuse or vandalism.

How the Check Works

Each IP address is individually queried against the Wikimedia MetaWiki API (list=globalblocks) using your browser's fetch API with origin=* for cross-origin access. No intermediate server is involved — requests go directly from your browser to Wikimedia.

To avoid overloading the API and to comply with responsible API usage:

  • Requests are sent in batches of 5 concurrent connections.
  • A 100 ms pause is inserted between each batch.
  • If a request fails (network error, timeout, or rate-limiting), the IP is conservatively treated as not blocked, so no IP is accidentally removed due to a transient error.
Performance note: At 5 concurrent requests with a 100 ms inter-batch delay, checking 500 IPs takes approximately 10 seconds. For lists of 1,000 or more IPs, expect proportionally longer processing times. A progress bar is displayed during the check.

Privacy Considerations

When you enable the Wikimedia global block check, the IP addresses in your list are sent to the Wikimedia MetaWiki API (meta.wikimedia.org). Wikimedia's standard privacy policy applies to those requests. No other data is transmitted externally by these tools.

4. Output Format & Blocks

Both tools display results as numbered blocks, each containing up to a configurable number of IP addresses (default: 50). This block structure is designed to make it easy to copy manageable subsets of a large IP list into other applications.

Copying Output

  • 📋 Copy Block — Copies the IPs in a single block to the clipboard, one IP per line.
  • 📋 Copy All — Copies the entire processed list to the clipboard, one IP per line.
  • ⬇️ Download All — Downloads the entire list as a plain text file (.txt), one IP per line.

Statistics Bar

After processing, a statistics bar is displayed showing key metrics such as the number of IPs parsed, duplicates removed, private IPs removed, Wikimedia-blocked IPs removed, and the final output count. Use these figures to verify that the tool is behaving as expected.

5. Privacy & Data Handling

  • All parsing, validation, deduplication, sorting, and expansion logic runs entirely in your browser. Your IP data is never sent to any server operated by this site.
  • The optional Wikimedia global block check is the only operation that transmits data externally. It sends IP addresses to the public Wikimedia MetaWiki API over HTTPS.
  • No cookies, local storage, or analytics are used by these tools.
  • Your input is not retained after you leave or refresh the page.