iorate/ublacklist

uBlacklist

English | Deutsch | 한국어 | 简体中文

Blocks specific sites from appearing in Google search results

• Chrome: Chrome Web Store
• Firefox: Firefox Add-ons
• Edge: Edge Add-ons
• Safari: App Store (macOS and iOS, thanks to Group-Leafy)

Description

This extension prevents the sites you specify from appearing in Google search results.

You can add rules on search result pages, or on sites to be blocked by clicking the toolbar icon. Rules can be specified either by match patterns (e.g. *://*.example.com/*) or by expressions including regular expressions, variables and string matchers (e.g. /example\.(net|org)/, path*="example"i, $category = "images" & title ^= "Example"…).

You can synchronize rulesets across devices via cloud storage (Google Drive, Dropbox, OneDrive, WebDAV) or browser sync.

You can also subscribe to public rulesets. Some public rulesets are listed on the website: https://ublacklist.github.io/rulesets

Browser support policy

uBlacklist supports the following browser versions:

• Chrome: Latest stable version only
• Firefox: Latest stable version and latest ESR only
• Edge: Latest stable version only
• Safari: Latest stable version only (macOS and iOS)

Support for browsers outside the list above depends on community contributions. Please open a Discussion with a concrete implementation proposal — reports without one are unlikely to be addressed.

Supported search engines

This extension is available in the below search engines.

No additional builtin search engine support is planned. You can use SERPINFO to add support for any search engine yourself.

Related repositories

• ublacklist/builtin — Builtin SERPINFO files. The extension periodically downloads the latest SERPINFO from here.
• ublacklist/packages — npm packages (@ublacklist/match-pattern, @ublacklist/ruleset, @ublacklist/serpinfo) and the ruleset/SERPINFO format specifications
• ublacklist/store-assets — Store listing descriptions and screenshots
• ublacklist/ublacklist.github.io — Website and documentation (https://ublacklist.github.io)

For subscription providers

To publish a ruleset as a subscription, place a ruleset file encoded in UTF-8 on a suitable HTTP(S) server, and publish the URL. Here is an example hosted on GitHub:

https://raw.githubusercontent.com/iorate/ublacklist-example-subscription/master/uBlacklist.txt

You can prepend YAML frontmatter to your ruleset. It is recommended that you set the name variable.

---
name: Your ruleset name
---
*://*.example.com/*

Authoring rulesets and SERPINFO with AI agents

Agent skills for writing rulesets and SERPINFO are published in ublacklist/packages. You can install them into your AI coding agent with the GitHub CLI:

gh skill install ublacklist/packages

Contributing

See our Contributing Guide for detailed development setup and guidelines.

Author

iorate (X)

License

uBlacklist is licensed under MIT License.