How to Create, Edit, and Validate AWAGAM Blocklists
Published on Nov 10, 2026, filed under tools, development, politics, misc. (Share this post, e.g., on Mastodon.)
AWAGAM, the TLD, domain, and URL blocker for Chromium browsers and Android, is only as effective as its blocklists. Blocklists are JSON files, and while the format is simple, the format isn’t clear to everyone, and even if, a missing comma or a mistyped domain is quickly overlooked.
That’s why there’s now also a blocklist editor—to create, edit, and check AWAGAM blocklists and bundles right in the browser.
What the Editor Does
Creating and editing: You work with groups—each with a name, an optional context, and its TLDs, domains, and URLs—, and the editor writes the JSON for you. (If you prefer to edit the JSON directly, you can do that, too.)
Opening existing blocklists: You can open blocklists from a file or from a URL. Links to GitHub, GitLab, Codeberg, and Pastebin pages are converted to their raw files, so you can paste what’s in your address bar.
Checking: The editor checks blocklists the way the AWAGAM extension does, using the same code. Errors, like an invalid domain, make a blocklist invalid; duplicates and redundant entries—like a domain whose TLD is already blocked—are flagged as warnings.
Tidying: One click sorts all entries and removes duplicates.
When you’re done, copy or download the result, and host it wherever you like—any public HTTPS URL works.
Your work is kept in your browser: The editor doesn’t store or transfer any data.
And the Converter?
If you already use EasyList filters, the EasyList/AWAGAM converter is still there, too, and now also checks the blocklists it converts. This also allows you to convert, then fine-tune in the editor.
Give the editor a try—perhaps with one of the starter blocklists—, and let me know of any issues!
The official release date of the tool is October 13, but I’m deliberately spreading out announcements a bit.
About Me
I’m Jens (long: Jens Oliver Meiert), and I’m an engineering lead, guerrilla philosopher, and indie publisher. I’ve worked as a technical lead and manager at various companies (e.g., Google); I’m an active web and tool developer (code optimization, digital defense), a contributor to web standards (like HTML, CSS, WCAG), and a book author (O’Reilly, dxsrc). You’ll like my work if you value principled, pragmatic problem-solving. Let’s connect.