IA Defensa

AWAGAM TLD, Domain, and URL Blocker Chromium

A Chromium browser extension enabling you to block access to TLDs, domains, and URLs via user-configurable blocklists. Designed for use against actors engaged in wars, genocides, and misanthropy, but effective in blocking anything—including ads and trackers.

(Create your own blocklist—it’s easy—or use an existing blocklist.)

Add to your browserBrowse blocklistsBuy commercial license

This extension does not collect or share any data with IA Defensa or third parties. The source code is available for auditing. The extension is free for personal use.

Features

Core Blocking

Blocklist Management

User Interface

Privacy

Installation

  1. Go to the IA Defensa AWAGAM TLD, Domain, and URL Blocker page in the Chrome Web Store
  2. Click “Add to Chrome” (or equivalent for other Chromium browsers)

Afterwards, configure the extension according to your preferences and consider pinning it to your toolbar for easy access.

Tip: Enable the extension in private mode (“Allow in Incognito”). The extension does not share any information with IA Defensa or third parties.

Usage

  1. Click “Manage blocklists” in popup
  2. Add new blocklist (URL to a valid AWAGAM JSON file)
  3. Configure update settings
  4. Set update interval and enable/disable as needed
  5. Monitor status and rule counts in real-time
  6. Import/export configurations for backup

Blocklists

You find community and country starter blocklists in Jens Oliver Meiert’s AWAGAM blocklists repository. IA Defensa does not provide blocklists.

If you share your own public blocklist, you’re encouraged to release it under a permissive or public domain license such as the Unlicense or CC0. This ensures maximum compatibility and reuse. If your blocklist is licensed, please include a license file or link in your repository.

If you provide a list of blocklists, reach out for us to consider adding it here.

Blocklist Converter

There’s an experimental converter that allows to convert EasyList blocklists (Adblock, uBlock Origin) to AWAGAM format, and vice-versa. Note that these extensions do not do the same thing—AdBlock and uBlock Origin are content blockers, whereas AWAGAM also blocks navigating to TLDs, domains, and URLs directly.

Please use the IA Defensa forum to report issues.

Blocklist Format

Blocklists must use the AWAGAM JSON format:

{
  "group-id": {
    "name": "Human-readable group name",
    "context": "Optional description or context URL(s)",
    "tlds": [
      ".example"
    ],
    "domains": [
      "example.com",
      "example.org"
    ],
    "urls": [
      "https://example.net/foo",
      "example.com/ads/*",
      "example.com/*?affiliate="
    ]
  }
}

Note: Domain entries cover all subdomains—example.com also blocks www.example.com, shop.example.com, and any other subdomain.

Recommendation: Use a JSON validator like FreeFormatter.com or JSON Compare to validate your blocklist before using and releasing it.

URL Formats

AWAGAM supports flexible URL blocking:

Examples:

Format Requirements

Troubleshooting

Common Issues

“Blocklist error”:

“File not found (404)”:

“Network error”:

“Token URL warning”:

Error Messages

The extension provides specific error diagnostics: