Skip to content

Latest commit

 

History

History
59 lines (40 loc) · 3.6 KB

File metadata and controls

59 lines (40 loc) · 3.6 KB
title Usage of format ublacklist
date 2026-05-02
updated 2026-05-07
targets
uBlacklist

uBlacklist

Subscription links

view raw bl cdn variant
👁️ Aggregates all wikifarms lists
👁️ wiki.gg identified wikifarms only
👁️ indie-wiki identified wikifarms only

Explanation:

  • view: open the file in this repository
  • raw: right-click to copy the raw link to a list for subscriptions (or open to check the content)
  • bl: automatically subscribe if you have that uBlacklist feature activated (otherwise opens a page to copy the link)
  • cdn: alternative link to the raw file for users that cannot or don't want to use direct links to github

Tip

If in doubt, use the bl link.

Specification

Official ruleset definition: https://github.com/iorate/ublacklist/blob/master/docs/ruleset-spec.md

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

Rules can be written as match patterns or expressions. Both variants can be mixed and matched.

Note

As of now, only match patterns are used in this repository.

The subscription files must be encoded in utf-8.

It is recommended1, to add a YAML frontmatter with at least a name for the ruleset.

Note

Adding the frontmatter enhances user experience. This repository uses:

  • name
  • description
  • homepage
  • variants

The frontmatter might break things for users who want to use the list with something other than official uBlacklist tools.

If you experience such a use case, please let me know.

Compatible services

If you know of other tools, apps or services that make use of lists in "uBlacklist"-Format, please let me know.

Footnotes

  1. https://ublacklist.github.io/docs/advanced-features#publish-subscription