Skip to content

ashwinvis/umatrix2ublock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

umatrix2ublock

Migrate rulesets from uMatrix to uBlock-Origin.

Warning

Websites are very likely to break with this setup, so have uBlock-Origin disabled in private windows such that you have a fallback option.

An effort is made to retain similar functionality and blocking as before.

Usage

  1. Opt-in under uBlock-Origin settings: "I am an advanced user". Then block 3rd-party scripts and frames globally. Alternatively block only 3rd-party frames (less breakage).

    https://user-images.githubusercontent.com/9155111/75366608-44884300-58bf-11ea-88ff-8ca3252fd763.png
  2. Either enable "Custom" Firefox Enhanced Tracking protection to block all third-party cookies, or use Cookie-AutoDelete.

  3. Export your existing uMatrix and uBlock-Origin rules into text files. Execute it something similar to:

    cd examples/
    python ../umatrix2ublock.py my-umatrix-rules.txt my-ublock-dynamic-rules_2020-02-26_14.07.25.txt
    

    to obtain a merged ruleset my-ublock-dynamic-rules.txt compatible with uBlock-Origin.

  4. Import the merged ruleset into uBlock-Origin.

Background

In my browser, I originally had uBlock-Origin (with its default settings) and uMatrix.

I started using uMatrix to block all third-party requests by default (except css and images), and whitelisting a few requests to make the website is functional.

https://user-images.githubusercontent.com/585534/33213085-ff74afd8-d0f3-11e7-8232-4c204925d274.png

I realized later that most of the time, I was just whitelisting scripts and XHRs. Which meant in principle, I can rely on custom settings as mentioned above. I simply needed to migrate my uMatrix rules that I had aggregated over several months to serve the same purpose.

About

Migrate rulesets from uMatrix to uBlock-Origin

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages